From ef7ddf9f7ed0a79380c9f6db43bb2dc0d4e7ad33 Mon Sep 17 00:00:00 2001 From: Mike Pennisi Date: Fri, 12 Jun 2015 11:02:07 -0400 Subject: [PATCH] Improve frontmatter usage Define explanatory text using the `info` tag and include single-line descriptions. --- .../tagged-template/cache-differing-expressions-eval.js | 3 ++- .../cache-differing-expressions-new-function.js | 3 ++- .../tagged-template/cache-differing-expressions.js | 3 ++- .../tagged-template/cache-differing-raw-strings.js | 3 ++- .../tagged-template/cache-differing-string-count.js | 3 ++- .../tagged-template/cache-identical-source-eval.js | 3 ++- .../tagged-template/cache-identical-source-new-function.js | 3 ++- .../expressions/tagged-template/cache-identical-source.js | 3 ++- .../member-expression-argument-list-evaluation.js | 3 ++- .../expressions/tagged-template/member-expression-context.js | 3 ++- .../tagged-template/template-object-frozen-non-strict.js | 3 ++- .../tagged-template/template-object-frozen-strict.js | 3 ++- test/language/expressions/tagged-template/template-object.js | 3 ++- .../expressions/template-literal/evaluation-order.js | 3 +-- ...nvalid-hexidecimal-character-escape-sequence-truncated.js | 5 +++-- .../template-literal/invalid-legacy-octal-escape-sequence.js | 3 ++- .../invalid-unicode-escape-sequence-truncated.js | 3 ++- .../template-literal/tv-character-escape-sequence.js | 5 +++-- .../expressions/template-literal/tv-hex-escape-sequence.js | 5 +++-- .../expressions/template-literal/tv-line-continuation.js | 5 +++-- .../template-literal/tv-line-terminator-sequence.js | 5 +++-- .../expressions/template-literal/tv-no-substitution.js | 5 +++-- .../template-literal/tv-null-character-escape-sequence.js | 5 +++-- .../expressions/template-literal/tv-template-character.js | 5 +++-- .../expressions/template-literal/tv-template-characters.js | 5 +++-- .../expressions/template-literal/tv-template-head.js | 5 +++-- .../expressions/template-literal/tv-template-middle.js | 5 +++-- .../expressions/template-literal/tv-template-tail.js | 5 +++-- .../expressions/template-literal/tv-utf16-escape-sequence.js | 5 +++-- test/language/expressions/template-literal/tv-zwnbsp.js | 5 +++-- 30 files changed, 73 insertions(+), 45 deletions(-) diff --git a/test/language/expressions/tagged-template/cache-differing-expressions-eval.js b/test/language/expressions/tagged-template/cache-differing-expressions-eval.js index c233db3b86..aa09319aa1 100644 --- a/test/language/expressions/tagged-template/cache-differing-expressions-eval.js +++ b/test/language/expressions/tagged-template/cache-differing-expressions-eval.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using distinct expressions within `eval` +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical but their expressions evaluate to different values and the tagged template is being evaluated in diff --git a/test/language/expressions/tagged-template/cache-differing-expressions-new-function.js b/test/language/expressions/tagged-template/cache-differing-expressions-new-function.js index 4fe47eabc1..4a8cdb6986 100644 --- a/test/language/expressions/tagged-template/cache-differing-expressions-new-function.js +++ b/test/language/expressions/tagged-template/cache-differing-expressions-new-function.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using distinct expressions within `new Function` +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical but their expressions evaluate to different values and the tagged template is being evaluated in diff --git a/test/language/expressions/tagged-template/cache-differing-expressions.js b/test/language/expressions/tagged-template/cache-differing-expressions.js index 88495e3504..e74ba4601c 100644 --- a/test/language/expressions/tagged-template/cache-differing-expressions.js +++ b/test/language/expressions/tagged-template/cache-differing-expressions.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using distinct expressions +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical but their expressions evaluate to different values. diff --git a/test/language/expressions/tagged-template/cache-differing-raw-strings.js b/test/language/expressions/tagged-template/cache-differing-raw-strings.js index 98bb3568ec..252736f504 100644 --- a/test/language/expressions/tagged-template/cache-differing-raw-strings.js +++ b/test/language/expressions/tagged-template/cache-differing-raw-strings.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Templates are cached according to their "raw" representation +info: > The internal template registry should be queried according to the "raw" strings of the tagged template. ---*/ diff --git a/test/language/expressions/tagged-template/cache-differing-string-count.js b/test/language/expressions/tagged-template/cache-differing-string-count.js index 30afbe9426..60e2eb23d5 100644 --- a/test/language/expressions/tagged-template/cache-differing-string-count.js +++ b/test/language/expressions/tagged-template/cache-differing-string-count.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Templates are cached according to the number of "raw" strings +info: > The internal template registry should be queried according to the number of "raw" strings in the tagged template. ---*/ diff --git a/test/language/expressions/tagged-template/cache-identical-source-eval.js b/test/language/expressions/tagged-template/cache-identical-source-eval.js index a835344820..383fc4f593 100644 --- a/test/language/expressions/tagged-template/cache-identical-source-eval.js +++ b/test/language/expressions/tagged-template/cache-identical-source-eval.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using identical expressions within `eval` +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical and the tagged template is being evaluated in an `eval` context. diff --git a/test/language/expressions/tagged-template/cache-identical-source-new-function.js b/test/language/expressions/tagged-template/cache-identical-source-new-function.js index f262e55c8d..511186f218 100644 --- a/test/language/expressions/tagged-template/cache-identical-source-new-function.js +++ b/test/language/expressions/tagged-template/cache-identical-source-new-function.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using identical expressions within `new Function` +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical and the tagged template is being evaluated in a `new Function` context. diff --git a/test/language/expressions/tagged-template/cache-identical-source.js b/test/language/expressions/tagged-template/cache-identical-source.js index dc844481f2..3e09fbd937 100644 --- a/test/language/expressions/tagged-template/cache-identical-source.js +++ b/test/language/expressions/tagged-template/cache-identical-source.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > +description: Template caching using identical expressions +info: > Previously-created template objects should be retrieved from the internal template registry when their source is identical. ---*/ diff --git a/test/language/expressions/tagged-template/member-expression-argument-list-evaluation.js b/test/language/expressions/tagged-template/member-expression-argument-list-evaluation.js index ffd67875b2..866efa1995 100644 --- a/test/language/expressions/tagged-template/member-expression-argument-list-evaluation.js +++ b/test/language/expressions/tagged-template/member-expression-argument-list-evaluation.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.3.7 -description: > +description: Argument list evalution for member expresions +info: > A tagged template is a function call where the arguments of the call are derived from a TemplateLiteral. The actual arguments include a template object and the values produced by evaluating the expressions embedded diff --git a/test/language/expressions/tagged-template/member-expression-context.js b/test/language/expressions/tagged-template/member-expression-context.js index 818a9e50c6..8575e6e64d 100644 --- a/test/language/expressions/tagged-template/member-expression-context.js +++ b/test/language/expressions/tagged-template/member-expression-context.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.3.7 -description: > +description: Invocation context for member expressions +info: > A tagged template is a function call where the arguments of the call are derived from a TemplateLiteral. The actual arguments include a template object and the values produced by evaluating the expressions embedded diff --git a/test/language/expressions/tagged-template/template-object-frozen-non-strict.js b/test/language/expressions/tagged-template/template-object-frozen-non-strict.js index 3b489f2938..d338fa5d08 100644 --- a/test/language/expressions/tagged-template/template-object-frozen-non-strict.js +++ b/test/language/expressions/tagged-template/template-object-frozen-non-strict.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.3.7 -description: > +description: Template objects are frozen (as demonstrated outside of strict mode) +info: > The first argument to a tagged template should be frozen and define a `raw` property that is also frozen. flags: [noStrict] diff --git a/test/language/expressions/tagged-template/template-object-frozen-strict.js b/test/language/expressions/tagged-template/template-object-frozen-strict.js index 2f5cb7b309..9853d22838 100644 --- a/test/language/expressions/tagged-template/template-object-frozen-strict.js +++ b/test/language/expressions/tagged-template/template-object-frozen-strict.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.3.7 -description: > +description: Template objects are frozen (as demonstrated within strict mode) +info: > The first argument to a tagged template should be frozen and define a `raw` property that is also frozen. flags: [onlyStrict] diff --git a/test/language/expressions/tagged-template/template-object.js b/test/language/expressions/tagged-template/template-object.js index 15f5b092d2..b4286e1467 100644 --- a/test/language/expressions/tagged-template/template-object.js +++ b/test/language/expressions/tagged-template/template-object.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.3.7 -description: > +description: Properties of the template object +info: > The first argument to a tagged template should be a template object as defined by the GetTemplateObject abstract operation. includes: [propertyHelper.js] diff --git a/test/language/expressions/template-literal/evaluation-order.js b/test/language/expressions/template-literal/evaluation-order.js index b707f6d2c2..45c5bc664f 100644 --- a/test/language/expressions/template-literal/evaluation-order.js +++ b/test/language/expressions/template-literal/evaluation-order.js @@ -2,8 +2,7 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 12.2.8 -description: > - Expressions should be evaluated in left-to-right order. +description: Expressions should be evaluated in left-to-right order. ---*/ var tag = function(templateObject, a, b, c) { diff --git a/test/language/expressions/template-literal/invalid-hexidecimal-character-escape-sequence-truncated.js b/test/language/expressions/template-literal/invalid-hexidecimal-character-escape-sequence-truncated.js index 4f1f3f6e6e..e3c07bf7bb 100644 --- a/test/language/expressions/template-literal/invalid-hexidecimal-character-escape-sequence-truncated.js +++ b/test/language/expressions/template-literal/invalid-hexidecimal-character-escape-sequence-truncated.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Invalid hexidecimal character escape sequence +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. negative: SyntaxError diff --git a/test/language/expressions/template-literal/invalid-legacy-octal-escape-sequence.js b/test/language/expressions/template-literal/invalid-legacy-octal-escape-sequence.js index 20e308e69c..baa0873896 100644 --- a/test/language/expressions/template-literal/invalid-legacy-octal-escape-sequence.js +++ b/test/language/expressions/template-literal/invalid-legacy-octal-escape-sequence.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 16.1 -description: > +description: Invalid octal escape sequence +info: > TemplateCharacter (11.8.6) must not be extended to include LegacyOctalEscapeSequence as defined in B.1.2. negative: SyntaxError diff --git a/test/language/expressions/template-literal/invalid-unicode-escape-sequence-truncated.js b/test/language/expressions/template-literal/invalid-unicode-escape-sequence-truncated.js index f614cc00fa..79a1826c9e 100644 --- a/test/language/expressions/template-literal/invalid-unicode-escape-sequence-truncated.js +++ b/test/language/expressions/template-literal/invalid-unicode-escape-sequence-truncated.js @@ -2,7 +2,8 @@ // This code is governed by the BSD license found in the LICENSE file. /*--- es6id: 11.8.6 -description: > +description: Invalid unicode escape sequence +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. negative: SyntaxError diff --git a/test/language/expressions/template-literal/tv-character-escape-sequence.js b/test/language/expressions/template-literal/tv-character-escape-sequence.js index c686272c76..8b7f74aeb8 100644 --- a/test/language/expressions/template-literal/tv-character-escape-sequence.js +++ b/test/language/expressions/template-literal/tv-character-escape-sequence.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of character escape sequences +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. The TRV of TemplateCharacter :: \ EscapeSequence is the sequence consisting diff --git a/test/language/expressions/template-literal/tv-hex-escape-sequence.js b/test/language/expressions/template-literal/tv-hex-escape-sequence.js index a6ad55d147..70ab99e2a8 100644 --- a/test/language/expressions/template-literal/tv-hex-escape-sequence.js +++ b/test/language/expressions/template-literal/tv-hex-escape-sequence.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2015 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.1 -description: > +es6id: 11.8.6.1 +description: Template values of hex escape sequences +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. The SV of UnicodeEscapeSequence :: u{ HexDigits } is the UTF16Encoding diff --git a/test/language/expressions/template-literal/tv-line-continuation.js b/test/language/expressions/template-literal/tv-line-continuation.js index 92f5ff13f4..14f0f1384b 100644 --- a/test/language/expressions/template-literal/tv-line-continuation.js +++ b/test/language/expressions/template-literal/tv-line-continuation.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of line continuations +info: > The TV of LineContinuation :: \ LineTerminatorSequence is the empty code unit sequence. The TRV of LineContinuation :: \ LineTerminatorSequence is the sequence diff --git a/test/language/expressions/template-literal/tv-line-terminator-sequence.js b/test/language/expressions/template-literal/tv-line-terminator-sequence.js index 475a583766..f3275ca15b 100644 --- a/test/language/expressions/template-literal/tv-line-terminator-sequence.js +++ b/test/language/expressions/template-literal/tv-line-terminator-sequence.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2015 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of line terminator sequences +info: > The TV of TemplateCharacter :: LineTerminatorSequence is the TRV of LineTerminatorSequence. The TRV of LineTerminatorSequence :: is the code unit value 0x000A. diff --git a/test/language/expressions/template-literal/tv-no-substitution.js b/test/language/expressions/template-literal/tv-no-substitution.js index 7976b042d0..8d285bd2ef 100644 --- a/test/language/expressions/template-literal/tv-no-substitution.js +++ b/test/language/expressions/template-literal/tv-no-substitution.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of templates without substitution patterns +info: > The TV and TRV of NoSubstitutionTemplate :: `` is the empty code unit sequence. The TV of NoSubstitutionTemplate :: ` TemplateCharacters ` is the TV of diff --git a/test/language/expressions/template-literal/tv-null-character-escape-sequence.js b/test/language/expressions/template-literal/tv-null-character-escape-sequence.js index afeef1c8c2..caa219a130 100644 --- a/test/language/expressions/template-literal/tv-null-character-escape-sequence.js +++ b/test/language/expressions/template-literal/tv-null-character-escape-sequence.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of the null character escape sequence +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. The TRV of EscapeSequence :: 0 is the code unit value 0x0030. diff --git a/test/language/expressions/template-literal/tv-template-character.js b/test/language/expressions/template-literal/tv-template-character.js index 3ae02815bd..fef3e5fd4b 100644 --- a/test/language/expressions/template-literal/tv-template-character.js +++ b/test/language/expressions/template-literal/tv-template-character.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of single characters +info: > The TV of TemplateCharacters :: TemplateCharacter is the TV of TemplateCharacter. The TV of TemplateCharacter :: SourceCharacter but not one of ` or \ or $ diff --git a/test/language/expressions/template-literal/tv-template-characters.js b/test/language/expressions/template-literal/tv-template-characters.js index 34faf28d50..9e32828255 100644 --- a/test/language/expressions/template-literal/tv-template-characters.js +++ b/test/language/expressions/template-literal/tv-template-characters.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of multiple template characters +info: > The TV of TemplateCharacters :: TemplateCharacter TemplateCharacters is a sequence consisting of the code units in the TV of TemplateCharacter followed by all the code units in the TV of TemplateCharacters in order. diff --git a/test/language/expressions/template-literal/tv-template-head.js b/test/language/expressions/template-literal/tv-template-head.js index b73dd3b563..895a1f5c63 100644 --- a/test/language/expressions/template-literal/tv-template-head.js +++ b/test/language/expressions/template-literal/tv-template-head.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of the template head pattern +info: > The TV and TRV of TemplateHead :: `${ is the empty code unit sequence. The TV of TemplateHead :: ` TemplateCharacters ${ is the TV of TemplateCharacters. diff --git a/test/language/expressions/template-literal/tv-template-middle.js b/test/language/expressions/template-literal/tv-template-middle.js index 836e2e1ee0..ca6cb0ca8a 100644 --- a/test/language/expressions/template-literal/tv-template-middle.js +++ b/test/language/expressions/template-literal/tv-template-middle.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of the template middle pattern +info: > The TV and TRV of TemplateMiddle :: }${ is the empty code unit sequence. The TRV of TemplateMiddle :: } TemplateCharacters ${ is the TRV of TemplateCharacters. diff --git a/test/language/expressions/template-literal/tv-template-tail.js b/test/language/expressions/template-literal/tv-template-tail.js index 541883eedb..941cadf38d 100644 --- a/test/language/expressions/template-literal/tv-template-tail.js +++ b/test/language/expressions/template-literal/tv-template-tail.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.8.6 -description: > +es6id: 11.8.6.1 +description: Template values of the template tail pattern +info: > The TV and TRV of TemplateTail :: }` is the empty code unit sequence. The TV of TemplateTail :: } TemplateCharacters ` is the TV of TemplateCharacters. diff --git a/test/language/expressions/template-literal/tv-utf16-escape-sequence.js b/test/language/expressions/template-literal/tv-utf16-escape-sequence.js index fdb5f01c12..ba4ffc830f 100644 --- a/test/language/expressions/template-literal/tv-utf16-escape-sequence.js +++ b/test/language/expressions/template-literal/tv-utf16-escape-sequence.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.1 -description: > +es6id: 11.8.6.1 +description: Template values of UTF-16 escape sequences +info: > The TV of TemplateCharacter :: \ EscapeSequence is the SV of EscapeSequence. The SV of UnicodeEscapeSequence :: u{ HexDigits } is the UTF16Encoding diff --git a/test/language/expressions/template-literal/tv-zwnbsp.js b/test/language/expressions/template-literal/tv-zwnbsp.js index 68111045b9..2197874b81 100644 --- a/test/language/expressions/template-literal/tv-zwnbsp.js +++ b/test/language/expressions/template-literal/tv-zwnbsp.js @@ -1,8 +1,9 @@ // Copyright (C) Copyright 2014 the V8 project authors. All rights reserved. // This code is governed by the BSD license found in the LICENSE file. /*--- -es6id: 11.1 -description: > +es6id: 11.1.8.6.1 +description: Template values of the zero width no-break space character +info: > The zero width no-break space format-control character may be used within template literals. ---*/