Improve frontmatter usage

Define explanatory text using the `info` tag and include single-line
descriptions.
This commit is contained in:
Mike Pennisi 2015-06-12 11:02:07 -04:00
parent 80c67e56c1
commit ef7ddf9f7e
30 changed files with 73 additions and 45 deletions

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.
---*/

View File

@ -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.
---*/

View File

@ -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.

View File

@ -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.

View File

@ -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.
---*/

View File

@ -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

View File

@ -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

View File

@ -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]

View File

@ -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]

View File

@ -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]

View File

@ -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) {

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 :: <LF> is the code unit value 0x000A.

View File

@ -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

View File

@ -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.

View File

@ -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 $

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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.
---*/