From 473cae9ec66cffd164ced95af90c7a80a2a3d261 Mon Sep 17 00:00:00 2001 From: Michael Dyck Date: Fri, 8 Nov 2024 11:10:26 +0000 Subject: [PATCH 1/5] Editorial: Change "the String value" to "the value" in a Note (#3454) ... because it's talking about a string literal in *Java*. See https://github.com/tc39/ecma262/pull/3310#discussion_r1611879826 --- spec.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec.html b/spec.html index ded8d5a23e..febb83f765 100644 --- a/spec.html +++ b/spec.html @@ -16156,7 +16156,7 @@

Syntax

The components of a combining character sequence are treated as individual Unicode code points even though a user might think of the whole sequence as a single character.

In string literals, regular expression literals, template literals and identifiers, any Unicode code point may also be expressed using Unicode escape sequences that explicitly express a code point's numeric value. Within a comment, such an escape sequence is effectively ignored as part of the comment.

-

ECMAScript differs from the Java programming language in the behaviour of Unicode escape sequences. In a Java program, if the Unicode escape sequence `\\u000A`, for example, occurs within a single-line comment, it is interpreted as a line terminator (Unicode code point U+000A is LINE FEED (LF)) and therefore the next code point is not part of the comment. Similarly, if the Unicode escape sequence `\\u000A` occurs within a string literal in a Java program, it is likewise interpreted as a line terminator, which is not allowed within a string literal—one must write `\\n` instead of `\\u000A` to cause a LINE FEED (LF) to be part of the String value of a string literal. In an ECMAScript program, a Unicode escape sequence occurring within a comment is never interpreted and therefore cannot contribute to termination of the comment. Similarly, a Unicode escape sequence occurring within a string literal in an ECMAScript program always contributes to the literal and is never interpreted as a line terminator or as a code point that might terminate the string literal.

+

ECMAScript differs from the Java programming language in the behaviour of Unicode escape sequences. In a Java program, if the Unicode escape sequence `\\u000A`, for example, occurs within a single-line comment, it is interpreted as a line terminator (Unicode code point U+000A is LINE FEED (LF)) and therefore the next code point is not part of the comment. Similarly, if the Unicode escape sequence `\\u000A` occurs within a string literal in a Java program, it is likewise interpreted as a line terminator, which is not allowed within a string literal—one must write `\\n` instead of `\\u000A` to cause a LINE FEED (LF) to be part of the value of a string literal. In an ECMAScript program, a Unicode escape sequence occurring within a comment is never interpreted and therefore cannot contribute to termination of the comment. Similarly, a Unicode escape sequence occurring within a string literal in an ECMAScript program always contributes to the literal and is never interpreted as a line terminator or as a code point that might terminate the string literal.

 From d27161dc2f5bf9891cb1faa29afd8cac614cda1e Mon Sep 17 00:00:00 2001 From: Michael Dyck Date: Fri, 8 Nov 2024 11:10:32 +0000 Subject: [PATCH 2/5] Editorial: Change "Yield" to "GeneratorYield" in two Note-steps (#3454) (PR #2548 unfolded many invocations of Yield, but didn't change the accompanying Note-steps.) --- spec.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/spec.html b/spec.html index febb83f765..4fdc84c1df 100644 --- a/spec.html +++ b/spec.html @@ -42329,7 +42329,7 @@

1. Assert: _kind_ is ~key+value~. 1. Let _result_ be CreateArrayFromList(« _e_.[[Key]], _e_.[[Value]] »). 1. Perform ? GeneratorYield(CreateIteratorResultObject(_result_, *false*)). - 1. NOTE: The number of elements in _entries_ may have increased while execution of this abstract operation was paused by Yield. + 1. NOTE: The number of elements in _entries_ may have increased while execution of this abstract operation was paused by GeneratorYield. 1. Set _numEntries_ to the number of elements in _entries_. 1. Return *undefined*. 1. Return CreateIteratorFromClosure(_closure_, *"%MapIteratorPrototype%"*, %MapIteratorPrototype%). @@ -42959,7 +42959,7 @@

1. Else, 1. Assert: _kind_ is ~value~. 1. Perform ? GeneratorYield(CreateIteratorResultObject(_e_, *false*)). - 1. NOTE: The number of elements in _entries_ may have increased while execution of this abstract operation was paused by Yield. + 1. NOTE: The number of elements in _entries_ may have increased while execution of this abstract operation was paused by GeneratorYield. 1. Set _numEntries_ to the number of elements in _entries_. 1. Return *undefined*. 1. Return CreateIteratorFromClosure(_closure_, *"%SetIteratorPrototype%"*, %SetIteratorPrototype%). From e887590afa9f3b6bf6524d666fffd86993b82e90 Mon Sep 17 00:00:00 2001 From: Michael Dyck Date: Fri, 8 Nov 2024 11:10:39 +0000 Subject: [PATCH 3/5] Editorial: Fix CreateListFromArrayLike preamble (#3454) PR #3409 changed a parameter of CreateListFromArrayLike, but didn't make the corresponding change to the preamble. (And PR #3419 failed to fix it.) --- spec.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec.html b/spec.html index 4fdc84c1df..011bc59625 100644 --- a/spec.html +++ b/spec.html @@ -6509,7 +6509,7 @@

description
-
It is used to create a List value whose elements are provided by the indexed properties of _obj_. _elementTypes_ contains the names of ECMAScript Language Types that are allowed for element values of the List that is created.
+
It is used to create a List value whose elements are provided by the indexed properties of _obj_. _validElementTypes_ indicates the types of values that are allowed as elements.
1. If _validElementTypes_ is not present, set _validElementTypes_ to ~all~. From c4dc43cf54437bc2e4cd4ba535704efd898a0e56 Mon Sep 17 00:00:00 2001 From: Michael Dyck Date: Fri, 8 Nov 2024 11:10:44 +0000 Subject: [PATCH 4/5] Editorial: Fix `Promise.try` preamble (#3454) (Make it consistent with PR #2592) --- spec.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec.html b/spec.html index 011bc59625..de6055b5c6 100644 --- a/spec.html +++ b/spec.html @@ -48148,7 +48148,7 @@

Promise.try ( _callback_, ..._args_ )

-

When the `try` method is called with argument _callback_, the following steps are taken:

+

This function performs the following steps when called:

1. Let _C_ be the *this* value. 1. If _C_ is not an Object, throw a *TypeError* exception. From 0f2e04e50f3f9d2f2996017a27c6248fb43072ce Mon Sep 17 00:00:00 2001 From: Michael Dyck Date: Fri, 8 Nov 2024 11:10:54 +0000 Subject: [PATCH 5/5] Editorial: Fix two simple typos (#3454) --- spec.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/spec.html b/spec.html index de6055b5c6..31b05e8afe 100644 --- a/spec.html +++ b/spec.html @@ -42372,7 +42372,7 @@

Abstract Operations For Set Objects

Set Records

-

An Set Record is a Record value used to encapsulate the interface of a Set or similar object.

+

A Set Record is a Record value used to encapsulate the interface of a Set or similar object.

Set Records have the fields listed in .

@@ -45552,7 +45552,7 @@

Atomics.wait ( _typedArray_, _index_, _value_, _timeout_ )

Atomics.waitAsync ( _typedArray_, _index_, _value_, _timeout_ )

-

This function returns a Promise that is resolved when the calling agent is notified or the the timeout is reached.

+

This function returns a Promise that is resolved when the calling agent is notified or the timeout is reached.

It performs the following steps when called:

1. Return ? DoWait(~async~, _typedArray_, _index_, _value_, _timeout_).