diff --git a/index.html b/index.html index a71249e..7c15aa3 100644 --- a/index.html +++ b/index.html @@ -7,91 +7,43 @@

Annotated ECMAScript 5.1

‟Ex igne vita”

-

toc · single-page version · source

-

NOTE This is not the normative ECMAScript Language specification.

-

The normative ECMAScript specification (ECMA 262) is a PDF file maintained by -ECMA TC39 and is available at the following location:

- -

http://www.ecma-international.org/publications/standards/Ecma-262.htm

+

toc · single-page version · key · source

+

This is not the normative ECMAScript Language specification. +The normative spec +(ECMA 262) +is a PDF file maintained by ECMA TC39 and is available from +http://www.ecmascript.org/

-

This document is an annotated, -hyperlinked, HTML version - of Edition 5.1 of the ECMAScript Specification. +

This is an annotated, hyperlinked, HTML version of Edition 5.1 of +the ECMAScript Specification, + -

No copyright is asserted on the front matter of this version (everything - up to and including the Table of Contents). However, any reuse of the body - text from this document (everything following the Table of Contents) must - adhere to the terms of the license on the normative spec. See the spec’s + maintained by Michael[tm] Smith. + No copyright is asserted on its front matter (everything up through + the Table of Contents), but any reuse of its body text + (everything following the Table of Contents) must include the normative + spec’s copyright notice and license - statement.

- -

The complete source for this version is available at + statement. The source for this version is at https://github.com/es5/es5.github.com

-

About the annotations

- -

To view annotations for a particular section of the present - document, follow the hyperlinks - marked Ⓐ, Ⓓ, Ⓡ, Ⓖ, Ⓔ, and ① in - the section headings. The different types of annotations provided by each - of those are as follows:

- -
Ⓐ Contributed annotations
-
These mark the availability of user-contributed annotations that are - collaboratively maintained at the current site. Note that these - annotations are made available under the terms of the - MIT license, and may be freely reused, - copied, modified, republished, redistributed, etc., as permitted - by that license. If you’d like to contribute annotations, see - the - instructions on the Annotated ES5 project page.
- -
Ⓓ Dmitry A. Soshnikov ECMA-262 article series
-
These do not mark annotations at this site but are instead direct - hyperlinks to relevant articles by - Dmitry A. Soshnikov in his - ECMA-262 article series.
- -
Ⓡ MDC JavaScript Reference
-
These do not mark annotations at this site but are instead direct - hyperlinks to corresponding sections in the - MDC JavaScript Reference.
- -
Ⓖ MDC JavaScript Guide
-
These do not mark annotations at this site but are instead direct - hyperlinks to relevant sections in the - MDC JavaScript Guide.
- -
Ⓔ Errata as of July 2010
-
These provide errata copied from the “Items with Technical Significance” - section of the - July 2010 erratum document available at the TC39 wiki. - Note that only the contents of the “Items with Technical - Significance” section were copied over; the contents of the - “Editorial Items with no Technical Significance” section were - not.
- -
① Additional changes in Edition 5.1
-
These provide details about changes included in Annex F of Edition 5.1 - of the spec but that were not already in the July 2010 erratum document.
-
-

Jason Orendorff was the first to make a usefully hyperlinked -version of the ECMAScript spec. The hyperlinking here just follows -his example. His version remains available at +

To view annotations, follow the Ⓐ, Ⓓ, Ⓡ, + Ⓖ, Ⓔ, and ① hyperlinks in the headings. A + key to the markers explains the different types + of annotations. + Also included are a variety of hyperlinked cross-references, + following the example of Jason Orendorff’s version at http://people.mozilla.org/~jorendorff/es5.html

-

ECMAScript Language Specification

+

Table of Contents

  1. Introduction Ⓔ ① Ⓐ
    2. diff --git a/key.html b/key.html new file mode 100644 index 0000000..8e6163b --- /dev/null +++ b/key.html @@ -0,0 +1,57 @@ + + + + Annotated ES5: Key to the annotations + + + + +
    +
    +

    Annotated ECMAScript 5.1

    + +
    + +

    Key to the markers

    + +

    The following are explanations of the various types of annotations + markers provided in this version.

    + +
    +
    Ⓐ Contributed annotations
    +
    These mark the availability of user-contributed annotations that are + collaboratively maintained at the current site. Note that these + annotations are made available under the terms of the + MIT license, and may be freely reused, + copied, modified, republished, redistributed, etc., as permitted + by that license. If you’d like to contribute annotations, see + the + instructions on the Annotated ES5 project page.
    + +
    Ⓓ Dmitry A. Soshnikov ECMA-262 article series
    +
    Direct hyperlinks to relevant articles by + Dmitry A. Soshnikov in his + ECMA-262 article series.
    + +
    Ⓡ MDC JavaScript Reference
    +
    Direct hyperlinks to corresponding sections in the + MDC JavaScript Reference.
    + +
    Ⓖ MDC JavaScript Guide
    +
    Direct hyperlinks to relevant sections in the + MDC JavaScript Guide.
    + +
    Ⓔ Errata as of July 2010
    +
    Errata copied from the “Items with Technical Significance” section of the + July 2010 erratum document available at the TC39 wiki. + Note that only the contents of the “Items with Technical + Significance” section were copied over; the contents of the + “Editorial Items with no Technical Significance” section were + not.
    + +
    ① Additional changes in Edition 5.1
    +
    Details about changes included in Annex F of Edition 5.1 + of the spec but that were not already in the July 2010 erratum document.
    +
    + diff --git a/spec-splitter.py b/spec-splitter.py index 13d9a86..8d43559 100644 --- a/spec-splitter.py +++ b/spec-splitter.py @@ -172,7 +172,10 @@ def add_class(e, cls): page_body.append(e) alt_version_notice = page_body.find('.//*[@id="alt-version-notice"]') -replacement = etree.XML(u'

    toc · single-page version · source

    ') +replacement = etree.XML(u'

    toc\ + · single-page version\ + · key\ + · source

    ') alt_version_notice.getparent().replace(alt_version_notice, replacement) pages.append( (index_page, page, 'Front cover') ) diff --git a/spec.html b/spec.html index 30ca399..d637005 100644 --- a/spec.html +++ b/spec.html @@ -17,98 +17,47 @@

    Annotated ECMAScript 5.1

    -

    toc · multi-page version · source

    +

    toc + · multi-page version + · key + · source

    -

    NOTE This is not the normative ECMAScript Language specification.

    -

    The normative ECMAScript specification (ECMA 262) is a PDF file maintained by -ECMA TC39 and is available at the following location:

    - -

    http://www.ecma-international.org/publications/standards/Ecma-262.htm

    +

    This is not the normative ECMAScript Language specification. +The normative spec +(ECMA 262) +is a PDF file maintained by ECMA TC39 and is available from +http://www.ecmascript.org/

    -

    This document is an annotated, -hyperlinked, HTML version - of Edition 5.1 of the ECMAScript Specification. +

    This is an annotated, hyperlinked, HTML version of Edition 5.1 of +the ECMAScript Specification, + -

    No copyright is asserted on the front matter of this version (everything - up to and including the Table of Contents). However, any reuse of the body - text from this document (everything following the Table of Contents) must - adhere to the terms of the license on the normative spec. See the spec’s + maintained by Michael[tm] Smith. + No copyright is asserted on its front matter (everything up through + the Table of Contents), but any reuse of its body text + (everything following the Table of Contents) must include the normative + spec’s copyright notice and license - statement.

    - -

    The complete source for this version is available at + statement. The source for this version is at https://github.com/es5/es5.github.com

    -

    About the annotations

    - -

    To view annotations for a particular section of the present - document, follow the hyperlinks - marked Ⓐ, Ⓓ, Ⓡ, Ⓖ, Ⓔ, and ① in - the section headings. The different types of annotations provided by each - of those are as follows:

    - -
    -
    Ⓐ Contributed annotations
    -
    These mark the availability of user-contributed annotations that are - collaboratively maintained at the current site. Note that these - annotations are made available under the terms of the - MIT license, and may be freely reused, - copied, modified, republished, redistributed, etc., as permitted - by that license. If you’d like to contribute annotations, see - the - instructions on the Annotated ES5 project page.
    - -
    Ⓓ Dmitry A. Soshnikov ECMA-262 article series
    -
    These do not mark annotations at this site but are instead direct - hyperlinks to relevant articles by - Dmitry A. Soshnikov in his - ECMA-262 article series.
    - -
    Ⓡ MDC JavaScript Reference
    -
    These do not mark annotations at this site but are instead direct - hyperlinks to corresponding sections in the - MDC JavaScript Reference.
    - -
    Ⓖ MDC JavaScript Guide
    -
    These do not mark annotations at this site but are instead direct - hyperlinks to relevant sections in the - MDC JavaScript Guide.
    - -
    Ⓔ Errata as of July 2010
    -
    These provide errata copied from the “Items with Technical Significance” - section of the - July 2010 erratum document available at the TC39 wiki. - Note that only the contents of the “Items with Technical - Significance” section were copied over; the contents of the - “Editorial Items with no Technical Significance” section were - not.
    - -
    ① Additional changes in Edition 5.1
    -
    These provide details about changes included in Annex F of Edition 5.1 - of the spec but that were not already in the July 2010 erratum document.
    -
    - - -

    Jason Orendorff was the first to make a usefully hyperlinked -version of the ECMAScript spec. The hyperlinking here just follows -his example. His version remains available at +

    To view annotations, follow the Ⓐ, Ⓓ, Ⓡ, + Ⓖ, Ⓔ, and ① hyperlinks in the headings. A + key to the markers explains the different types + of annotations. + Also included are a variety of hyperlinked cross-references, + following the example of Jason Orendorff’s version at http://people.mozilla.org/~jorendorff/es5.html

-

ECMAScript Language Specification

+

Table of Contents

    diff --git a/style.css b/style.css index 0ee16a9..a41e984 100644 --- a/style.css +++ b/style.css @@ -162,6 +162,8 @@ b.other { background-color: green; color: white; padding: 4px; + padding-top: 12px; + padding-bottom: 12px; padding-left: 8px; } #toc > ol, @@ -226,7 +228,7 @@ b.other { } #disclaimer { background-color: lightgoldenrodyellow; - padding: 4px; + padding: 1px; padding-left: 20px; padding-right: 20px; border-radius: 6px;