From f125a9626bfacd1e867d2428efe2a1db4d4052cf Mon Sep 17 00:00:00 2001
From: "Daniel D. Beck" <daniel@ddbeck.com>
Date: Wed, 15 Sep 2021 22:18:22 -0700
Subject: [PATCH] Editorial: disambiguate `with` statement's status (#2441)

Co-authored-by: Daniel D. Beck <daniel@ddbeck.com>
Co-authored-by: Michael Ficarra <mficarra@shapesecurity.com>
---
 spec.html | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/spec.html b/spec.html
index 64d9154e11..a0488c1325 100644
--- a/spec.html
+++ b/spec.html
@@ -21933,8 +21933,12 @@ <h1>Runtime Semantics: Evaluation</h1>
     </emu-clause>
   </emu-clause>
 
-  <emu-clause id="sec-with-statement">
+  <emu-clause id="sec-with-statement" legacy>
     <h1>The `with` Statement</h1>
+    <emu-note>
+      <p>Use of the Legacy `with` statement is discouraged in new ECMAScript code. Consider alternatives that are permitted in both strict mode code and non-strict code, such as <emu-xref href="#sec-destructuring-assignment">destructuring assignment</emu-xref>.</p>
+    </emu-note>
+
     <h2>Syntax</h2>
     <emu-grammar type="definition">
       WithStatement[Yield, Await, Return] :