- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 25 Jun 2010 05:32:29 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup
In directory hutz:/tmp/cvs-serv27709
Modified Files:
.cvsignore Overview.html common-attributes.html datatypes.html
documents.html intro.html spec.html syntax.html
terminology.html
Log Message:
wording changes to make it clear that this document is a non-normative reference and that normative requirements are in the HTML5 spec
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/markup/Overview.html,v
retrieving revision 1.419
retrieving revision 1.420
diff -u -d -r1.419 -r1.420
--- Overview.html 24 Jun 2010 23:56:26 -0000 1.419
+++ Overview.html 25 Jun 2010 05:32:26 -0000 1.420
@@ -33,15 +33,17 @@
<div id="tocjump" class="skip-link" style="text-align: center"><a href="Overview.html#unexpanded-toc">Skip to Table of Contents</a></div>
<div id="abstract">
<h2>Abstract </h2>
- <p>This document describes
- the HTML markup language and provides details necessary for
- producers of HTML content to create documents that conform
+ <p>This document is primarily a reference that describes the
+
+ HTML markup language and provides details to help
+ producers of HTML content create documents that conform
to the language. By design, it does not define related APIs,
- nor attempt to specify how consumers of HTML content are
- meant to process documents (those areas are covered by the
+ nor attempt to explain how implementations that are
+ consumers of HTML content are meant to process documents
+ (those areas are covered by the
<a href="http://dev.w3.org/html5/spec/">HTML5 specification</a>
itself),
- nor attempt to be a tutorial or “how to” authoring guide.</p>
+ nor attempt to also be a tutorial or “how to” authoring guide.</p>
</div>
<div id="status">
<h2>Status of this Document </h2>
@@ -72,14 +74,16 @@
in the W3C <a href="http://www.w3.org/Interaction/">Interaction Domain</a>.
</p>
<div>
- <p>This non-normative document is intended to complement the
- normative conformance criteria defined in the specification
+ <p>This document is a non-normative reference intended to complement the
+ normative conformance criteria defined in the
<a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ specification
<a href="references.html#refsHTML5">[HTML5]</a>,
and is similar in scope to the
- <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Author Edition)</a>
- subset of that specification
- <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>.</p>
+ <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Edition for Web Authors)</a>
+ subset
+ <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>
+ of that specification.</p>
<div>
<h2 id="instability">Instability and incompleteness of this document</h2>
<p>This document is a working draft — all parts of it remain
Index: intro.html
===================================================================
RCS file: /sources/public/html5/markup/intro.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- intro.html 7 Mar 2010 11:29:05 -0000 1.18
+++ intro.html 25 Jun 2010 05:32:26 -0000 1.19
@@ -15,12 +15,13 @@
<div id="intro" class="section">
<h2>1. Introduction <a class="hash" href="#intro">#</a> <a class="toc-bak" href="Overview.html#intro-toc">T</a>
</h2>
- <p>This specification provides the details necessary for
+ <p>This document is a non-normative reference that provides
+ details to help
<a href="terminology.html#html-producer">producers of HTML content</a>
- to create
+ create
<a href="documents.html#conformant-documents">conformant documents</a>,
- and for others to check the conformance of existing documents.
- It is designed:</p>
+ and to help others check the conformance of existing documents.
+ It has the following design goals:</p>
<ul>
<li>to describe the syntax and structure of the
<a href="documents.html#html-language">HTML language</a>
@@ -32,19 +33,36 @@
<li>to be clear and unambiguous</li>
<li>to be as concise and readable as possible</li>
</ul>
-<p>Certain purposes are intentionally out of scope for this
- specification; in particular, it:</p>
+<p>The first two of the above design goals make this reference
+ similar in scope to the
+ <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Edition for Web Authors)</a>
+ subset
+ <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>
+ of the normative
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification
+ <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <p>Certain purposes are intentionally out of scope for this
+ reference document; specifically, it:</p>
<ul>
-<li>does not provide any conformance criteria for
+<li>does not provide any descriptions of implementation
+ conformance criteria for
<a href="terminology.html#html-consumer">HTML consumers</a>;
- in particular, it does not attempt to define how Web browsers
- and other user agents process documents</li>
- <li>does not define any APIs related to processing of HTML
- content by
+ in particular, it does not attempt to explain how Web browsers
+ and other user agents are meant to process documents</li>
+ <li>does not provide detailed information on APIs related to
+ processing of HTML content by
<a href="terminology.html#html-consumer">HTML consumers</a>.</li>
- <li>does not attempt to be a tutorial or “how to” authoring
- guide</li>
</ul>
+<p>For implementation conformance criteria for
+ <a href="terminology.html#html-consumer">HTML consumers</a>
+ and detailed information on related APIs, instead see the
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification
+ <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <p>Finally, because this document is intended for use strictly
+ as a reference, it does not attempt to also be a tutorial or
+ “how to” authoring guide.</p>
</div>
<hr class="footerbreak">
<div class="nav">
Index: syntax.html
===================================================================
RCS file: /sources/public/html5/markup/syntax.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -d -r1.47 -r1.48
--- syntax.html 2 Apr 2010 19:42:21 -0000 1.47
+++ syntax.html 25 Jun 2010 05:32:26 -0000 1.48
@@ -67,7 +67,9 @@
which, for legacy reasons that have to do with processing
modes in browsers, is a required part of any
<a href="documents.html#syntax-document-html">document in the HTML syntax</a>;
- it must conform to one of the following three formats:</p>
+ it
+ <a href="terminology.html#must-requirement">must</a>
+ match the characteristics of one of the following three formats:</p>
<ul>
<li><a href="syntax.html#normal-doctype">normal doctype</a></li>
<li><a href="syntax.html#deprecated-doctype">deprecated doctype</a></li>
@@ -242,28 +244,41 @@
<p>The following restrictions apply to character encoding
declarations:</p>
<ul>
-<li>The character encoding name given must be the name of
+<li>The character encoding name given
+ <a href="terminology.html#must-requirement">must</a>
+ be the name of
the character encoding used to serialize the file.</li>
- <li>The value must be a valid character encoding name, and
- must be the preferred name for that encoding.
+ <li>The value
+ <a href="terminology.html#must-requirement">must</a>
+ be a valid character encoding name, and
+ <a href="terminology.html#must-requirement">must</a>
+ be the preferred name for that encoding.
<a href="references.html#refsIANACHARSET">[IANACHARSET]</a>
</li>
- <li>The character encoding declaration must be serialized
+ <li>The character encoding declaration
+ <a href="terminology.html#must-requirement">must</a>
+ be serialized
without the use of
<a href="syntax.html#syntax-charref">character references</a>
or character escapes of any kind.</li>
<li>The element containing the character encoding
- declaration must be serialized completely within the first
+ declaration
+ <a href="terminology.html#must-requirement">must</a>
+ be serialized completely within the first
512 bytes of the document.</li>
</ul>
<p>If the document does not start with a
U+FEFF BYTE ORDER MARK (BOM) character, and if its
encoding is not explicitly given by a
<code>Content-Type</code> HTTP header, then the character
- encoding used must be an
+ encoding used
+ <a href="terminology.html#must-requirement">must</a>
+ be an
<a href="syntax.html#ascii-compatible">ASCII-compatible character encoding</a>,
and, in addition, if that encoding isn't US-ASCII itself, then
- the encoding must be specified using a
+ the encoding
+ <a href="terminology.html#must-requirement">must</a>
+ be specified using a
<code><a href="meta.html#meta">meta</a></code> element with a
<a href="meta.charset.html#meta.charset.attrs.charset">charset</a>
attribute or a <code><a href="meta.html#meta">meta</a></code> element
@@ -275,7 +290,9 @@
<a href="meta.charset.html#meta.charset.attrs.charset">charset</a>
attribute or a <code><a href="meta.html#meta">meta</a></code> element in the
<a href="meta.http-equiv.content-type.html#encoding-declaration-state">encoding declaration state</a>,
- then the character encoding used must be an
+ then the character encoding used
+ <a href="terminology.html#must-requirement">must</a>
+ be an
<a href="syntax.html#ascii-compatible">ASCII-compatible character encoding</a>.</p>
<p>An
<dfn id="ascii-compatible">ASCII-compatible character encoding</dfn>
@@ -292,7 +309,9 @@
JOHAB (Windows code page 1361),
encodings based on ISO-2022,
or encodings based on EBCDIC.</p>
- <p>Documents must not use
+ <p>Documents
+ <a href="terminology.html#must-requirement">must</a>
+ not use
CESU-8,
UTF-7,
BOCU-1,
@@ -317,10 +336,12 @@
contain, as well as what attributes (if any) the element can
have. The
<a href="elements.html">HTML elements</a>
- section of this specification defines the content models for
+ section of this reference describes the content models for
all of elements that are part of the
<a href="documents.html#html-language">HTML language</a>.
- An element must not contain
+ An element
+ <a href="terminology.html#must-requirement">must</a>
+ not contain
<a href="syntax.html#contents">contents</a>
or attributes that are not part of its content model.</p>
<p>The
@@ -401,7 +422,9 @@
<a href="syntax.html#tag-name" title="syntax-tag-name">tag name</a>.</li>
<li>Optionally, one or more
<a href="syntax.html#attribute">attributes</a>,
- each of which must be preceded by one or more
+ each of which
+ <a href="terminology.html#must-requirement">must</a>
+ be preceded by one or more
<a href="terminology.html#space">space characters</a>.</li>
<li>Optionally, one or more
<a href="terminology.html#space">space characters</a>.</li>
@@ -436,16 +459,22 @@
</li>
<li>
<a href="syntax.html#void-element">Void elements</a> only have a
- start tag; end tags must not be specified for void
+ start tag; end tags
+ <a href="terminology.html#must-requirement">must</a>
+ not be specified for void
elements.</li>
<li>The start and end tags of certain elements can be <dfn id="omitted" title="syntax-tag-omission">omitted</dfn>.
The subsection for each element in the <a href="elements.html">HTML elements</a> section of this
- specification provides information about which tags (if any)
+ reference provides information about which tags (if any)
can be omitted for that particular element.</li>
- <li>A non-<a href="syntax.html#void-element">void</a> element must have
+ <li>A non-<a href="syntax.html#void-element">void</a> element
+ <a href="terminology.html#must-requirement">must</a>
+ have
an end tag, unless the subsection for that element in the <a href="elements.html">HTML elements</a> section of this
- specification indicates that its end tag can be <a href="syntax.html#omitted">omitted</a>.</li>
- <li>The <a href="syntax.html#contents">contents</a> of an element must be
+ reference indicates that its end tag can be <a href="syntax.html#omitted">omitted</a>.</li>
+ <li>The <a href="syntax.html#contents">contents</a> of an element
+ <a href="terminology.html#must-requirement">must</a>
+ be
placed between just after its start tag (which
<a href="syntax.html#omitted" title="syntax-tag-omission">might be
implied, in certain cases</a>) and just before its end tag
@@ -461,7 +490,9 @@
<a href="syntax.html#syntax-start-tags">start tag</a>
and an
<a href="syntax.html#syntax-end-tags">end tag</a>,
- its end tag must be contained within the
+ its end tag
+ <a href="terminology.html#must-requirement">must</a>
+ be contained within the
<a href="syntax.html#contents">contents</a>
of the same element in which its start tag is contained.
An
@@ -500,7 +531,9 @@
<a href="syntax.html#attribute-name">name</a>
and a
<a href="syntax.html#syntax-attribute-value">value</a>.</p>
- <p>There must never be two or more attributes on the same
+ <p>There
+ <a href="terminology.html#must-requirement">must</a>
+ never be two or more attributes on the same
start tag whose names are a
<a href="terminology.html#case-insensitive">case-insensitive match</a>
for each other.</p>
@@ -515,7 +548,8 @@
<ul>
<li>
<dfn id="attribute-name" title="syntax-attribute-name">Attribute names</dfn>
- must consist of one or more characters other than the
+ <a href="terminology.html#must-requirement">must</a>
+ consist of one or more characters other than the
<a href="terminology.html#space">space characters</a>,
U+0000 NULL,
"<code title="U+0022 QUOTATION MARK">"</code>",
@@ -540,10 +574,12 @@
general, are
<a href="syntax.html#normal-character-data">normal character data</a>;
however, the <a href="elements.html">HTML elements</a> section
- of this specification defines further restrictions on the
+ of this reference describes further restrictions on the
allowed values of all attributes that are part of the
<a href="documents.html#html-language">HTML language</a>.
- An attribute must not have a value that is not allowed by
+ An attribute
+ <a href="terminology.html#must-requirement">must</a>
+ not have a value that is not allowed by
the
<a href="syntax.html#content-model">content model</a>
of the element that contains it.</li>
@@ -597,16 +633,22 @@
attribute values, an unquoted attribute value has the
following restrictions:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any literal
<a href="terminology.html#space">space characters</a>
</li>
- <li>must not contain any
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
"<code title="U+0022 QUOTATION MARK">"</code>",
"<code title="U+0027 APOSTROPHE">'</code>",
"<code title="U+003E GREATER-THAN SIGN">></code>",
"<code title="U+003D EQUALS SIGN">=</code>",
characters</li>
- <li>must not be the empty string</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not be the empty string</li>
</ul>
<div class="example">
<p>In the following example, the
@@ -618,7 +660,9 @@
<p>If the value of an attribute using the unquoted
attribute syntax is followed by a
"<code title="U+002F SOLIDUS">/</code>"
- character, then there must be at least one
+ character, then there
+ <a href="terminology.html#must-requirement">must</a>
+ be at least one
<a href="terminology.html#space">space character</a>
after the value and before the
"<code title="U+002F SOLIDUS">/</code>"
@@ -657,7 +701,9 @@
for attribute values, a single-quoted attribute value
has the following restriction:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any literal
"<code title="U+0027 APOSTROPHE">'</code>"
characters</li>
</ul>
@@ -702,7 +748,9 @@
attribute values, a double-quoted attribute value has
the following restriction:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any literal
"<code title="U+0022 QUOTATION MARK">"</code>"
characters</li>
</ul>
@@ -725,12 +773,19 @@
<a href="syntax.html#syntax-comments">comments</a>)
and
<a href="syntax.html#syntax-attribute-value">attribute values</a>
- must consist of Unicode characters, with the following
+ <a href="terminology.html#must-requirement">must</a>
+ consist of Unicode characters, with the following
restrictions:</p>
<ul>
-<li>must not contain U+0000 characters</li>
- <li>must not contain permanently undefined Unicode characters</li>
- <li>must not contain control characters other than
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain U+0000 characters</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain permanently undefined Unicode characters</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain control characters other than
<a href="terminology.html#space">space characters</a>
</li>
</ul>
@@ -756,7 +811,9 @@
</ul>
<p>Normal character data has the following restrictions:</p>
<ul>
-<li>must not contain any
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
"<code title="U+003C LESS-THAN SIGN"><</code>"
characters</li>
@@ -788,10 +845,14 @@
</ul>
<p>Replaceable character data has the following restrictions:</p>
<ul>
-<li>must not contain any
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
<a href="syntax.html#syntax-ambiguous-ampersand">ambiguous ampersands</a>
</li>
- <li>must not contain any occurrences of the string
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any occurrences of the string
"<code title="U+003C LESS-THAN SIGN, U+002F SOLIDUS"></</code>"
followed by characters that are a
<a href="terminology.html#case-insensitive">case-insensitive match</a>
@@ -806,14 +867,17 @@
"<code title="U+002F SOLIDUS">/</code>".</li>
</ul>
<p class="note">Replaceable character data,
- as defined in this specification, is a feature of
+ as described in this reference, is a feature of
<a href="documents.html#html-syntax">the HTML syntax</a>
that is not available in
<a href="documents.html#xml-syntax">the XML syntax</a>.
<a href="documents.html#syntax-document-xml">Documents in the XML
- syntax</a> must not contain replaceable character data
- as defined in this specification; instead they must
- conform to all syntax constraints defined in the XML
+ syntax</a>
+ <a href="terminology.html#must-requirement">must</a>
+ not contain replaceable character data
+ as described in this reference; instead they
+ <a href="terminology.html#must-requirement">must</a>
+ conform to all syntax constraints described in the XML
specification <a href="references.html#refsXML">[XML]</a>.</p>
</dd>
<dt><dfn id="non-replaceable-character-data" title="non-replaceable-character-data">Non-replaceable character data</dfn></dt>
@@ -840,9 +904,13 @@
</ul>
<p>Non-replaceable character data has the following restrictions:</p>
<ul>
-<li>must not contain <a href="syntax.html#syntax-charref">character references</a>
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain <a href="syntax.html#syntax-charref">character references</a>
</li>
- <li>must not contain any occurrences of the string
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any occurrences of the string
"<code title="U+003C LESS-THAN SIGN, U+002F SOLIDUS"></</code>",
followed by characters that are a
<a href="terminology.html#case-insensitive">case-insensitive match</a>
@@ -858,13 +926,16 @@
"<code title="U+002F SOLIDUS">/</code>".</li>
</ul>
<p class="note">Non-replaceable character data,
- as defined in this specification, is a feature of
+ as described in this reference, is a feature of
<a href="documents.html#html-syntax">the HTML syntax</a>
that is not available in
<a href="documents.html#xml-syntax">the XML syntax</a>.
<a href="documents.html#syntax-document-xml">Documents in the XML
- syntax</a> must not contain non-replaceable character
- data as defined in this specification; instead they must
+ syntax</a>
+ <a href="terminology.html#must-requirement">must</a>
+ not contain non-replaceable character
+ data as described in this reference; instead they
+ <a href="terminology.html#must-requirement">must</a>
conform to all syntax constraints defined in the XML
specification <a href="references.html#refsXML">[XML]</a>.</p>
</dd>
@@ -1019,13 +1090,21 @@
<p>The <a href="syntax.html#syntax-text">text</a>
part of comments has the following restrictions:</p>
<ul>
-<li>must not start with a
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not start with a
"<code title="U+003E GREATER-THAN SIGN">></code>" character</li>
- <li>must not start with the string
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not start with the string
"<code title="U+002D HYPHEN-MINUS, U+003E GREATER-THAN SIGN">-></code>"</li>
- <li>must not contain the string
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain the string
"<code title="U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS">--</code>"</li>
- <li>must not end with a
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not end with a
"<code title="U+002D HYPHEN-MINUS">-</code>" character</li>
</ul>
<div class="example">
@@ -1059,13 +1138,17 @@
"<code title="U+003E GREATER-THAN SIGN">></code>"
character are said to be
<dfn id="syntax-self-closing">marked as self-closing</dfn>.</li>
- <li>SVG and MathML elements must either have a
+ <li>SVG and MathML elements
+ <a href="terminology.html#must-requirement">must</a>
+ either have a
<a href="syntax.html#syntax-start-tags">start tag</a>
and an
<a href="syntax.html#syntax-end-tags">end tag</a>,
or a start tag that is
<a href="syntax.html#syntax-self-closing">marked as self-closing</a>,
- in which case they must not have an end tag.</li>
+ in which case they
+ <a href="terminology.html#must-requirement">must</a>
+ not have an end tag.</li>
<li>SVG and MathML elements whose start tag is
<a href="syntax.html#syntax-self-closing">marked as self-closing</a>,
can’t have any contents.</li>
@@ -1080,7 +1163,9 @@
that it contains, with the restriction
that any
<a href="syntax.html#character-data">character data</a>
- it contains must be
+ it contains
+ <a href="terminology.html#must-requirement">must</a>
+ be
<a href="syntax.html#normal-character-data">normal character data</a>.</li>
</ul>
</div>
@@ -1099,7 +1184,9 @@
"<code title="U+003C LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+005B LEFT SQUARE BRACKET, U+0043 LATIN CAPITAL LETTER C, U+0044 LATIN CAPITAL LETTER D, U+0041 LATIN CAPITAL LETTER A, U+0054 LATIN CAPITAL LETTER T, U+0041 LATIN CAPITAL LETTER A, U+005B LEFT SQUARE BRACKET"><![CDATA[</code>"</li>
<li>
<a href="syntax.html#syntax-text" title="syntax-text">text</a>, with the
- additional restriction that the text must not contain the
+ additional restriction that the text
+ <a href="terminology.html#must-requirement">must</a>
+ not contain the
string
"<code title="U+005D RIGHT SQUARE BRACKET, U+005D RIGHT SQUARE BRACKET, U+003E GREATER-THAN SIGN">]]></code>“</li>
<li>the
Index: terminology.html
===================================================================
RCS file: /sources/public/html5/markup/terminology.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -d -r1.29 -r1.30
--- terminology.html 7 Mar 2010 11:29:07 -0000 1.29
+++ terminology.html 25 Jun 2010 05:32:26 -0000 1.30
@@ -16,7 +16,7 @@
<h2>2. Terminology <a class="hash" href="#terminology">#</a> <a class="toc-bak" href="Overview.html#terminology-toc">T</a>
</h2>
<p>The following is a list of terms that are used in other
- sections of this specification.</p>
+ sections of this reference.</p>
<dl>
<dt><dfn id="context" title="context">browsing context</dfn></dt>
<dd>A <a href="terminology.html#context">browsing context</a>
@@ -29,7 +29,7 @@
elements in a
<span class="element">frameset</span>.</dd>
<dt><dfn id="case-insensitive" title="case-insensitive">case-insensitive match</dfn></dt>
- <dd>For the purposes of this specification,
+ <dd>For the purposes of this reference,
performing a
<a href="terminology.html#case-insensitive">case-insensitive match</a>
between two strings means comparing the strings exactly,
@@ -56,6 +56,16 @@
<dt><dfn id="html-consumer" title="html-consumer">HTML consumers</dfn></dt>
<dd>HTML user agents; that is, applications (such as
Web browsers) which consume HTML content.</dd>
+ <dt><dfn id="must-requirement" title="must-requirement">must</dfn></dt>
+ <dd>The word <i>must</i> is used in this reference to mark
+ document-conformance requirements that are normatively
+ defined in the
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification.
+ <a href="references.html#refsHTML5">[HTML5]</a>.
+ <p class="note">This reference does not itself normatively
+ define any requirements.</p>
+ </dd>
<dt><dfn id="newlines" title="newlines">newline</dfn></dt>
<dd>A <a href="terminology.html#newlines">newline</a> may be represented as any
of the following:
Index: datatypes.html
===================================================================
RCS file: /sources/public/html5/markup/datatypes.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- datatypes.html 26 Mar 2010 14:07:18 -0000 1.46
+++ datatypes.html 25 Jun 2010 05:32:26 -0000 1.47
@@ -74,10 +74,14 @@
<a href="datatypes.html#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must not start with a
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ not start with a
"<code title="U+005F LOW LINE">_</code>"
character</li>
- <li>must be at least one character long</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ be at least one character long</li>
</ul>
</div>
</div>
@@ -117,8 +121,12 @@
<a href="datatypes.html#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
<a href="terminology.html#space">space characters</a>
</li>
</ul>
@@ -140,8 +148,12 @@
<a href="datatypes.html#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
<a href="terminology.html#space">space characters</a>
</li>
</ul>
@@ -167,8 +179,12 @@
<a href="datatypes.html#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="terminology.html#must-requirement">must</a>
+ not contain any
<a href="terminology.html#space">space characters</a>
</li>
</ul>
@@ -214,7 +230,9 @@
<a href="datatypes.html#common.data.integer.non-negative">non-negative integer</a>,
with the following restriction:
<ul>
-<li>must be greater than zero</li>
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ be greater than zero</li>
</ul>
</div>
</div>
@@ -281,7 +299,9 @@
<a href="datatypes.html#common.data.float.non-negative">non-negative float</a>,
with the following restriction:
<ul>
-<li>must be greater than zero</li>
+<li>
+<a href="terminology.html#must-requirement">must</a>
+ be greater than zero</li>
</ul>
</div>
</div>
@@ -314,7 +334,9 @@
with these additional qualifications:</div>
<ul>
<li>the literal letters <code>T</code> and
- <code>Z</code> in the date/time syntax must always be
+ <code>Z</code> in the date/time syntax
+ <a href="terminology.html#must-requirement">must</a>
+ always be
uppercase</li>
<li>a <dfn id="data-date-fullyear">date-fullyear</dfn> is
defined as four or more digits representing a number
@@ -353,7 +375,7 @@
<p class="note">The empty string is a valid
<a href="datatypes.html#data.iri-ref">IRI-reference</a>,
so the empty string is allowed as the value of any
- attribute for which this document defines
+ attribute for which this reference lists
<a href="datatypes.html#common.data.uri">URI</a>
as the allowed datatype.</p>
</div>
@@ -390,7 +412,9 @@
<div class="datatype-desc">An unordered set of unique
space-separated
<a href="datatypes.html#data-token">tokens</a>,
- each of which must be one of the following:
+ each of which
+ <a href="terminology.html#must-requirement">must</a>
+ be one of the following:
<ul>
<li>the literal string "<code>any</code>"</li>
<li>two valid
@@ -530,7 +554,9 @@
<div class="datatype-desc">An ordered set of unique
space-separated <a href="datatypes.html#data-token">tokens</a>, each of
- which must be exactly one Unicode code point in
+ which
+ <a href="terminology.html#must-requirement">must</a>
+ be exactly one Unicode code point in
length.</div>
</div>
</div>
@@ -659,7 +685,8 @@
</h2>
<div class="content-models">
- <div class="datatype-desc">A regular expression that must
+ <div class="datatype-desc">A regular expression that
+ <a href="terminology.html#must-requirement">must</a>
match the JavaScript <i>Pattern</i> production <a href="references.html#refsECMA262">[ECMA262]</a>.</div>
</div>
</div>
@@ -696,7 +723,7 @@
with the additional qualification that the year component
is a
<a href="datatypes.html#data-date-fullyear">date-fullyear</a>
- as defined in this document.</div>
+ as described in this reference.</div>
<div class="example">
<p>Example:</p>
<pre><code>1996-12-19</code></pre>
Index: documents.html
===================================================================
RCS file: /sources/public/html5/markup/documents.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -r1.22 -r1.23
--- documents.html 29 Mar 2010 15:07:57 -0000 1.22
+++ documents.html 25 Jun 2010 05:32:26 -0000 1.23
@@ -39,23 +39,23 @@
<h2>3.01. The HTML language and HTML and XML syntaxes <a class="hash" href="#language-and-syntax">#</a> <a class="toc-bak" href="Overview.html#language-and-syntax-toc">T</a>
</h2>
<p>The term
- <dfn id="document" title="document">document</dfn> is used in this specification
+ <dfn id="document" title="document">document</dfn> is used in this reference
to mean an instance of the
<a href="documents.html#html-language">HTML language</a>.</p>
<p>The
<dfn id="html-language" title="html-language">HTML language</dfn> is the language
- described in this specification; it is an abstract language that
+ described in this reference; it is an abstract language that
applications can potentially represent in memory in any number
of possible ways, and that can be transmitted using any number
of possible concrete syntaxes.</p>
- <p>This specification makes
- reference to two particular concrete syntaxes for the
+ <p>This reference
+ describes two particular concrete syntaxes for the
<a href="documents.html#html-language">HTML language</a>:
- One syntax which
- is referred to throughout this specification as
+ One syntax, which
+ is referred to throughout this reference as
<a href="documents.html#html-syntax">the HTML syntax</a>,
and another syntax, which is referred to throughout this
- specification as
+ reference as
<a href="documents.html#xml-syntax">the XML syntax</a>.
Web browsers typically implement two separate parsers for
processing documents: an
@@ -68,7 +68,7 @@
<p>The <dfn id="html-syntax" title="html-syntax">HTML syntax</dfn>
is the syntax described in the
<a href="syntax.html">HTML syntax</a>
- section of this specification.</p>
+ section of this reference.</p>
<p>The
<dfn id="xml-syntax" title="xml-syntax">XML syntax</dfn>
is defined by rules in the XML specification
@@ -77,7 +77,7 @@
<a href="references.html#refsXML">[XMLNS]</a>;
any syntax-level requirements for
<a href="documents.html#syntax-document-xml">documents in the XML syntax</a>
- described in this specification are intended to be the same as
+ described in this reference are intended to be the same as
those defined in the XML specification.</p>
</div>
<div id="mime-types" class="section">
@@ -92,8 +92,10 @@
and for
<a href="documents.html#syntax-document-xml">documents in the XML syntax</a>.</p>
<p>Documents that are served with the
- <code>text/html</code> MIME type must conform to the rules in this
- specification for
+ <code>text/html</code> MIME type
+ <a href="terminology.html#must-requirement">must</a>
+ match the descriptions in this
+ reference for characteristics of
<a href="documents.html#syntax-document-html">documents in the HTML syntax</a>.</p>
<p>Documents that have an
<a href="documents.html#html-namespace">HTML namespace</a>
@@ -102,7 +104,9 @@
<code>text/xml</code>,
<code>application/xml</code>, or
<code>application/xhtml+xml</code>
- must conform to the rules in this specification for
+ <a href="terminology.html#must-requirement">must</a>
+ match the descriptions in this
+ reference for characteristics of
<a href="documents.html#syntax-document-xml">documents in the XML syntax</a>.</p>
</div>
<div id="conformant-documents" class="section">
@@ -110,7 +114,9 @@
</h2>
<p>A conformant
<dfn id="syntax-document-html" title="syntax-document-html">document in the HTML
- syntax</dfn> must consist of the following parts, in the
+ syntax</dfn>
+ <a href="terminology.html#must-requirement">must</a>
+ consist of the following parts, in the
following order:</p>
<ol>
<li>Optionally, a single U+FEFF BYTE ORDER MARK (BOM)
@@ -133,27 +139,36 @@
<a href="terminology.html#space">space characters</a>.</li>
</ol>
<p><a href="documents.html#syntax-document-html">Documents in the HTML syntax</a>
- must conform to the syntax described in the
+ <a href="terminology.html#must-requirement">must</a>
+ match the syntax described in the
<a href="documents.html#html-syntax">HTML syntax</a>
- section of this specification.</p>
+ section of this reference.</p>
<p>A conformant
<dfn id="syntax-document-xml" title="syntax-document-xml">document in the XML syntax</dfn>
- must be a
+ <a href="terminology.html#must-requirement">must</a>
+ be a
<dfn id="namespace-well-formed-xml-document">namespace-well-formed</dfn>
XML document, as defined in the Namespaces in XML 1.0 specification
<a href="references.html#refsXML">[XMLNS]</a>,
and its
<dfn id="root-element">root element</dfn>
- must be an
+ <a href="terminology.html#must-requirement">must</a>
+ be an
<a href="html.html#html" class="element">html</a> element.</p>
<p class="note">
- Documents in the XML syntax must not make use of any features
+ Documents in the XML syntax
+ <a href="terminology.html#must-requirement">must</a>
+ not make use of any features
of the
<a href="documents.html#html-syntax">HTML syntax</a>
that do not follow XML well-formedness constraints (for
- example, documents in the XML syntax must not use
+ example, documents in the XML syntax
+ <a href="terminology.html#must-requirement">must</a>
+ not use
<a href="syntax.html#syntax-attr-unquoted">unquoted attribute value syntax</a>
- and must not
+ and
+ <a href="terminology.html#must-requirement">must</a>
+ not
<a href="syntax.html#omitted">omit tags</a>).</p>
</div>
<div id="case-insensitivity" class="section">
@@ -192,7 +207,8 @@
<a href="syntax.html#tag-name">Tag names</a>
for
<a href="elements.html#html-elements">HTML elements</a>
- must exactly match the names of the elements given in the
+ <a href="terminology.html#must-requirement">must</a>
+ exactly match the names of the elements given in the
<a href="elements.html">HTML elements</a>
section of this document; that is, tag names are
case-sensitive.</li>
@@ -200,7 +216,8 @@
<a href="syntax.html#attribute-name">Attribute names</a>
for
<a href="elements.html#html-elements">HTML elements</a>
- must exactly match the names of the attributes given in the
+ <a href="terminology.html#must-requirement">must</a>
+ exactly match the names of the attributes given in the
<a href="elements.html">HTML elements</a>
section of this document; that is, attribute names are
case-sensitive.</li>
Index: common-attributes.html
===================================================================
RCS file: /sources/public/html5/markup/common-attributes.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -d -r1.38 -r1.39
--- common-attributes.html 7 Mar 2010 11:29:03 -0000 1.38
+++ common-attributes.html 25 Jun 2010 05:32:26 -0000 1.39
@@ -113,7 +113,9 @@
<a href="datatypes.html#common.data.id">ID</a>
</span> </dt>
<dd>A unique identifier for the element.</dd>
-<dd>There must not be multiple elements in a document that
+<dd>There
+ <a href="terminology.html#must-requirement">must</a>
+ not be multiple elements in a document that
have the same
<a href="common-attributes.html#common.attrs.id" class="attribute">id</a>
value.</dd>
@@ -474,7 +476,9 @@
<dd>The <code class="attribute">xml:space</code>
attribute should only be used with
<a href="documents.html#syntax-document-xml">documents in the XML syntax</a>;
- it must not be used in
+ it
+ <a href="terminology.html#must-requirement">must</a>
+ not be used in
<a href="documents.html#syntax-document-html">documents in the HTML syntax</a>.</dd>
<dt>
@@ -486,7 +490,9 @@
<dd>The <code class="attribute">xml:base</code>
attribute should only be used with
<a href="documents.html#syntax-document-xml">documents in the XML syntax</a>;
- it must not be used in
+ it
+ <a href="terminology.html#must-requirement">must</a>
+ not be used in
<a href="documents.html#syntax-document-html">documents in the HTML syntax</a>.</dd>
</dl>
Index: spec.html
===================================================================
RCS file: /sources/public/html5/markup/spec.html,v
retrieving revision 1.218
retrieving revision 1.219
diff -u -d -r1.218 -r1.219
--- spec.html 24 Jun 2010 23:56:26 -0000 1.218
+++ spec.html 25 Jun 2010 05:32:26 -0000 1.219
@@ -32,15 +32,17 @@
<div id="tocjump" class="skip-link" style="text-align: center"><a href="spec.html#unexpanded-toc">Skip to Table of Contents</a></div>
<div id="abstract">
<h2>Abstract </h2>
- <p>This document describes
- the HTML markup language and provides details necessary for
- producers of HTML content to create documents that conform
+ <p>This document is primarily a reference that describes the
+
+ HTML markup language and provides details to help
+ producers of HTML content create documents that conform
to the language. By design, it does not define related APIs,
- nor attempt to specify how consumers of HTML content are
- meant to process documents (those areas are covered by the
+ nor attempt to explain how implementations that are
+ consumers of HTML content are meant to process documents
+ (those areas are covered by the
<a href="http://dev.w3.org/html5/spec/">HTML5 specification</a>
itself),
- nor attempt to be a tutorial or “how to” authoring guide.</p>
+ nor attempt to also be a tutorial or “how to” authoring guide.</p>
</div>
<div id="status">
<h2>Status of this Document </h2>
@@ -71,14 +73,16 @@
in the W3C <a href="http://www.w3.org/Interaction/">Interaction Domain</a>.
</p>
<div>
- <p>This non-normative document is intended to complement the
- normative conformance criteria defined in the specification
+ <p>This document is a non-normative reference intended to complement the
+ normative conformance criteria defined in the
<a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ specification
<a href="references.html#refsHTML5">[HTML5]</a>,
and is similar in scope to the
- <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Author Edition)</a>
- subset of that specification
- <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>.</p>
+ <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Edition for Web Authors)</a>
+ subset
+ <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>
+ of that specification.</p>
<div>
<h2 id="instability">Instability and incompleteness of this document</h2>
<p>This document is a working draft — all parts of it remain
@@ -687,12 +691,13 @@
<div id="intro" class="section">
<h2>1. Introduction <a class="hash" href="#intro">#</a> <a class="toc-bak" href="#intro-toc">T</a>
</h2>
- <p>This specification provides the details necessary for
+ <p>This document is a non-normative reference that provides
+ details to help
<a href="#html-producer">producers of HTML content</a>
- to create
+ create
<a href="#conformant-documents">conformant documents</a>,
- and for others to check the conformance of existing documents.
- It is designed:</p>
+ and to help others check the conformance of existing documents.
+ It has the following design goals:</p>
<ul>
<li>to describe the syntax and structure of the
<a href="#html-language">HTML language</a>
@@ -704,25 +709,42 @@
<li>to be clear and unambiguous</li>
<li>to be as concise and readable as possible</li>
</ul>
-<p>Certain purposes are intentionally out of scope for this
- specification; in particular, it:</p>
+<p>The first two of the above design goals make this reference
+ similar in scope to the
+ <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Edition for Web Authors)</a>
+ subset
+ <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>
+ of the normative
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification
+ <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <p>Certain purposes are intentionally out of scope for this
+ reference document; specifically, it:</p>
<ul>
-<li>does not provide any conformance criteria for
+<li>does not provide any descriptions of implementation
+ conformance criteria for
<a href="#html-consumer">HTML consumers</a>;
- in particular, it does not attempt to define how Web browsers
- and other user agents process documents</li>
- <li>does not define any APIs related to processing of HTML
- content by
+ in particular, it does not attempt to explain how Web browsers
+ and other user agents are meant to process documents</li>
+ <li>does not provide detailed information on APIs related to
+ processing of HTML content by
<a href="#html-consumer">HTML consumers</a>.</li>
- <li>does not attempt to be a tutorial or “how to” authoring
- guide</li>
</ul>
+<p>For implementation conformance criteria for
+ <a href="#html-consumer">HTML consumers</a>
+ and detailed information on related APIs, instead see the
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification
+ <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <p>Finally, because this document is intended for use strictly
+ as a reference, it does not attempt to also be a tutorial or
+ “how to” authoring guide.</p>
</div>
<div id="terminology" class="section">
<h2>2. Terminology <a class="hash" href="#terminology">#</a> <a class="toc-bak" href="#terminology-toc">T</a>
</h2>
<p>The following is a list of terms that are used in other
- sections of this specification.</p>
+ sections of this reference.</p>
<dl>
<dt><dfn id="context" title="context">browsing context</dfn></dt>
<dd>A <a href="#context">browsing context</a>
@@ -735,7 +757,7 @@
elements in a
<span class="element">frameset</span>.</dd>
<dt><dfn id="case-insensitive" title="case-insensitive">case-insensitive match</dfn></dt>
- <dd>For the purposes of this specification,
+ <dd>For the purposes of this reference,
performing a
<a href="#case-insensitive">case-insensitive match</a>
between two strings means comparing the strings exactly,
@@ -762,6 +784,16 @@
<dt><dfn id="html-consumer" title="html-consumer">HTML consumers</dfn></dt>
<dd>HTML user agents; that is, applications (such as
Web browsers) which consume HTML content.</dd>
+ <dt><dfn id="must-requirement" title="must-requirement">must</dfn></dt>
+ <dd>The word <i>must</i> is used in this reference to mark
+ document-conformance requirements that are normatively
+ defined in the
+ <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
+ full specification.
+ <a href="references.html#refsHTML5">[HTML5]</a>.
+ <p class="note">This reference does not itself normatively
+ define any requirements.</p>
+ </dd>
<dt><dfn id="newlines" title="newlines">newline</dfn></dt>
<dd>A <a href="#newlines">newline</a> may be represented as any
of the following:
@@ -840,23 +872,23 @@
<h2>3.01. The HTML language and HTML and XML syntaxes <a class="hash" href="#language-and-syntax">#</a> <a class="toc-bak" href="#language-and-syntax-toc">T</a>
</h2>
<p>The term
- <dfn id="document" title="document">document</dfn> is used in this specification
+ <dfn id="document" title="document">document</dfn> is used in this reference
to mean an instance of the
<a href="#html-language">HTML language</a>.</p>
<p>The
<dfn id="html-language" title="html-language">HTML language</dfn> is the language
- described in this specification; it is an abstract language that
+ described in this reference; it is an abstract language that
applications can potentially represent in memory in any number
of possible ways, and that can be transmitted using any number
of possible concrete syntaxes.</p>
- <p>This specification makes
- reference to two particular concrete syntaxes for the
+ <p>This reference
+ describes two particular concrete syntaxes for the
<a href="#html-language">HTML language</a>:
- One syntax which
- is referred to throughout this specification as
+ One syntax, which
+ is referred to throughout this reference as
<a href="#html-syntax">the HTML syntax</a>,
and another syntax, which is referred to throughout this
- specification as
+ reference as
<a href="#xml-syntax">the XML syntax</a>.
Web browsers typically implement two separate parsers for
processing documents: an
@@ -869,7 +901,7 @@
<p>The <dfn id="html-syntax" title="html-syntax">HTML syntax</dfn>
is the syntax described in the
<a href="#syntax">HTML syntax</a>
- section of this specification.</p>
+ section of this reference.</p>
<p>The
<dfn id="xml-syntax" title="xml-syntax">XML syntax</dfn>
is defined by rules in the XML specification
@@ -878,7 +910,7 @@
<a href="#refsXML">[XMLNS]</a>;
any syntax-level requirements for
<a href="#syntax-document-xml">documents in the XML syntax</a>
- described in this specification are intended to be the same as
+ described in this reference are intended to be the same as
those defined in the XML specification.</p>
</div>
<div id="mime-types" class="section">
@@ -893,8 +925,10 @@
and for
<a href="#syntax-document-xml">documents in the XML syntax</a>.</p>
<p>Documents that are served with the
- <code>text/html</code> MIME type must conform to the rules in this
- specification for
+ <code>text/html</code> MIME type
+ <a href="#must-requirement">must</a>
+ match the descriptions in this
+ reference for characteristics of
<a href="#syntax-document-html">documents in the HTML syntax</a>.</p>
<p>Documents that have an
<a href="#html-namespace">HTML namespace</a>
@@ -903,7 +937,9 @@
<code>text/xml</code>,
<code>application/xml</code>, or
<code>application/xhtml+xml</code>
- must conform to the rules in this specification for
+ <a href="#must-requirement">must</a>
+ match the descriptions in this
+ reference for characteristics of
<a href="#syntax-document-xml">documents in the XML syntax</a>.</p>
</div>
<div id="conformant-documents" class="section">
@@ -911,7 +947,9 @@
</h2>
<p>A conformant
<dfn id="syntax-document-html" title="syntax-document-html">document in the HTML
- syntax</dfn> must consist of the following parts, in the
+ syntax</dfn>
+ <a href="#must-requirement">must</a>
+ consist of the following parts, in the
following order:</p>
<ol>
<li>Optionally, a single U+FEFF BYTE ORDER MARK (BOM)
@@ -934,27 +972,36 @@
<a href="#space">space characters</a>.</li>
</ol>
<p><a href="#syntax-document-html">Documents in the HTML syntax</a>
- must conform to the syntax described in the
+ <a href="#must-requirement">must</a>
+ match the syntax described in the
<a href="#html-syntax">HTML syntax</a>
- section of this specification.</p>
+ section of this reference.</p>
<p>A conformant
<dfn id="syntax-document-xml" title="syntax-document-xml">document in the XML syntax</dfn>
- must be a
+ <a href="#must-requirement">must</a>
+ be a
<dfn id="namespace-well-formed-xml-document">namespace-well-formed</dfn>
XML document, as defined in the Namespaces in XML 1.0 specification
<a href="#refsXML">[XMLNS]</a>,
and its
<dfn id="root-element">root element</dfn>
- must be an
+ <a href="#must-requirement">must</a>
+ be an
<a href="#html" class="element">html</a> element.</p>
<p class="note">
- Documents in the XML syntax must not make use of any features
+ Documents in the XML syntax
+ <a href="#must-requirement">must</a>
+ not make use of any features
of the
<a href="#html-syntax">HTML syntax</a>
that do not follow XML well-formedness constraints (for
- example, documents in the XML syntax must not use
+ example, documents in the XML syntax
+ <a href="#must-requirement">must</a>
+ not use
<a href="#syntax-attr-unquoted">unquoted attribute value syntax</a>
- and must not
+ and
+ <a href="#must-requirement">must</a>
+ not
<a href="#omitted">omit tags</a>).</p>
</div>
<div id="case-insensitivity" class="section">
@@ -993,7 +1040,8 @@
<a href="#tag-name">Tag names</a>
for
<a href="#html-elements">HTML elements</a>
- must exactly match the names of the elements given in the
+ <a href="#must-requirement">must</a>
+ exactly match the names of the elements given in the
<a href="#elements">HTML elements</a>
section of this document; that is, tag names are
case-sensitive.</li>
@@ -1001,7 +1049,8 @@
<a href="#attribute-name">Attribute names</a>
for
<a href="#html-elements">HTML elements</a>
- must exactly match the names of the attributes given in the
+ <a href="#must-requirement">must</a>
+ exactly match the names of the attributes given in the
<a href="#elements">HTML elements</a>
section of this document; that is, attribute names are
case-sensitive.</li>
@@ -1063,7 +1112,9 @@
which, for legacy reasons that have to do with processing
modes in browsers, is a required part of any
<a href="#syntax-document-html">document in the HTML syntax</a>;
- it must conform to one of the following three formats:</p>
+ it
+ <a href="#must-requirement">must</a>
+ match the characteristics of one of the following three formats:</p>
<ul>
<li><a href="#normal-doctype">normal doctype</a></li>
<li><a href="#deprecated-doctype">deprecated doctype</a></li>
@@ -1238,28 +1289,41 @@
<p>The following restrictions apply to character encoding
declarations:</p>
<ul>
-<li>The character encoding name given must be the name of
+<li>The character encoding name given
+ <a href="#must-requirement">must</a>
+ be the name of
the character encoding used to serialize the file.</li>
- <li>The value must be a valid character encoding name, and
- must be the preferred name for that encoding.
+ <li>The value
+ <a href="#must-requirement">must</a>
+ be a valid character encoding name, and
+ <a href="#must-requirement">must</a>
+ be the preferred name for that encoding.
<a href="#refsIANACHARSET">[IANACHARSET]</a>
</li>
- <li>The character encoding declaration must be serialized
+ <li>The character encoding declaration
+ <a href="#must-requirement">must</a>
+ be serialized
without the use of
<a href="#syntax-charref">character references</a>
or character escapes of any kind.</li>
<li>The element containing the character encoding
- declaration must be serialized completely within the first
+ declaration
+ <a href="#must-requirement">must</a>
+ be serialized completely within the first
512 bytes of the document.</li>
</ul>
<p>If the document does not start with a
U+FEFF BYTE ORDER MARK (BOM) character, and if its
encoding is not explicitly given by a
<code>Content-Type</code> HTTP header, then the character
- encoding used must be an
+ encoding used
+ <a href="#must-requirement">must</a>
+ be an
<a href="#ascii-compatible">ASCII-compatible character encoding</a>,
and, in addition, if that encoding isn't US-ASCII itself, then
- the encoding must be specified using a
+ the encoding
+ <a href="#must-requirement">must</a>
+ be specified using a
<code><a href="#meta">meta</a></code> element with a
<a href="#meta.charset.attrs.charset">charset</a>
attribute or a <code><a href="#meta">meta</a></code> element
@@ -1271,7 +1335,9 @@
<a href="#meta.charset.attrs.charset">charset</a>
attribute or a <code><a href="#meta">meta</a></code> element in the
<a href="#encoding-declaration-state">encoding declaration state</a>,
- then the character encoding used must be an
+ then the character encoding used
+ <a href="#must-requirement">must</a>
+ be an
<a href="#ascii-compatible">ASCII-compatible character encoding</a>.</p>
<p>An
<dfn id="ascii-compatible">ASCII-compatible character encoding</dfn>
@@ -1288,7 +1354,9 @@
JOHAB (Windows code page 1361),
encodings based on ISO-2022,
or encodings based on EBCDIC.</p>
- <p>Documents must not use
+ <p>Documents
+ <a href="#must-requirement">must</a>
+ not use
CESU-8,
UTF-7,
BOCU-1,
@@ -1313,10 +1381,12 @@
contain, as well as what attributes (if any) the element can
have. The
<a href="#elements">HTML elements</a>
- section of this specification defines the content models for
+ section of this reference describes the content models for
all of elements that are part of the
<a href="#html-language">HTML language</a>.
- An element must not contain
+ An element
+ <a href="#must-requirement">must</a>
+ not contain
<a href="#contents">contents</a>
or attributes that are not part of its content model.</p>
<p>The
@@ -1397,7 +1467,9 @@
<a href="#tag-name" title="syntax-tag-name">tag name</a>.</li>
<li>Optionally, one or more
<a href="#attribute">attributes</a>,
- each of which must be preceded by one or more
+ each of which
+ <a href="#must-requirement">must</a>
+ be preceded by one or more
<a href="#space">space characters</a>.</li>
<li>Optionally, one or more
<a href="#space">space characters</a>.</li>
@@ -1432,16 +1504,22 @@
</li>
<li>
<a href="#void-element">Void elements</a> only have a
- start tag; end tags must not be specified for void
+ start tag; end tags
+ <a href="#must-requirement">must</a>
+ not be specified for void
elements.</li>
<li>The start and end tags of certain elements can be <dfn id="omitted" title="syntax-tag-omission">omitted</dfn>.
The subsection for each element in the <a href="#elements">HTML elements</a> section of this
- specification provides information about which tags (if any)
+ reference provides information about which tags (if any)
can be omitted for that particular element.</li>
- <li>A non-<a href="#void-element">void</a> element must have
+ <li>A non-<a href="#void-element">void</a> element
+ <a href="#must-requirement">must</a>
+ have
an end tag, unless the subsection for that element in the <a href="#elements">HTML elements</a> section of this
- specification indicates that its end tag can be <a href="#omitted">omitted</a>.</li>
- <li>The <a href="#contents">contents</a> of an element must be
+ reference indicates that its end tag can be <a href="#omitted">omitted</a>.</li>
+ <li>The <a href="#contents">contents</a> of an element
+ <a href="#must-requirement">must</a>
+ be
placed between just after its start tag (which
<a href="#omitted" title="syntax-tag-omission">might be
implied, in certain cases</a>) and just before its end tag
@@ -1457,7 +1535,9 @@
<a href="#syntax-start-tags">start tag</a>
and an
<a href="#syntax-end-tags">end tag</a>,
- its end tag must be contained within the
+ its end tag
+ <a href="#must-requirement">must</a>
+ be contained within the
<a href="#contents">contents</a>
of the same element in which its start tag is contained.
An
@@ -1496,7 +1576,9 @@
<a href="#attribute-name">name</a>
and a
<a href="#syntax-attribute-value">value</a>.</p>
- <p>There must never be two or more attributes on the same
+ <p>There
+ <a href="#must-requirement">must</a>
+ never be two or more attributes on the same
start tag whose names are a
<a href="#case-insensitive">case-insensitive match</a>
for each other.</p>
@@ -1511,7 +1593,8 @@
<ul>
<li>
<dfn id="attribute-name" title="syntax-attribute-name">Attribute names</dfn>
- must consist of one or more characters other than the
+ <a href="#must-requirement">must</a>
+ consist of one or more characters other than the
<a href="#space">space characters</a>,
U+0000 NULL,
"<code title="U+0022 QUOTATION MARK">"</code>",
@@ -1536,10 +1619,12 @@
general, are
<a href="#normal-character-data">normal character data</a>;
however, the <a href="#elements">HTML elements</a> section
- of this specification defines further restrictions on the
+ of this reference describes further restrictions on the
allowed values of all attributes that are part of the
<a href="#html-language">HTML language</a>.
- An attribute must not have a value that is not allowed by
+ An attribute
+ <a href="#must-requirement">must</a>
+ not have a value that is not allowed by
the
<a href="#content-model">content model</a>
of the element that contains it.</li>
@@ -1593,16 +1678,22 @@
attribute values, an unquoted attribute value has the
following restrictions:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="#must-requirement">must</a>
+ not contain any literal
<a href="#space">space characters</a>
</li>
- <li>must not contain any
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any
"<code title="U+0022 QUOTATION MARK">"</code>",
"<code title="U+0027 APOSTROPHE">'</code>",
"<code title="U+003E GREATER-THAN SIGN">></code>",
"<code title="U+003D EQUALS SIGN">=</code>",
characters</li>
- <li>must not be the empty string</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not be the empty string</li>
</ul>
<div class="example">
<p>In the following example, the
@@ -1614,7 +1705,9 @@
<p>If the value of an attribute using the unquoted
attribute syntax is followed by a
"<code title="U+002F SOLIDUS">/</code>"
- character, then there must be at least one
+ character, then there
+ <a href="#must-requirement">must</a>
+ be at least one
<a href="#space">space character</a>
after the value and before the
"<code title="U+002F SOLIDUS">/</code>"
@@ -1653,7 +1746,9 @@
for attribute values, a single-quoted attribute value
has the following restriction:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="#must-requirement">must</a>
+ not contain any literal
"<code title="U+0027 APOSTROPHE">'</code>"
characters</li>
</ul>
@@ -1698,7 +1793,9 @@
attribute values, a double-quoted attribute value has
the following restriction:</p>
<ul>
-<li>must not contain any literal
+<li>
+<a href="#must-requirement">must</a>
+ not contain any literal
"<code title="U+0022 QUOTATION MARK">"</code>"
characters</li>
</ul>
@@ -1721,12 +1818,19 @@
<a href="#syntax-comments">comments</a>)
and
<a href="#syntax-attribute-value">attribute values</a>
- must consist of Unicode characters, with the following
+ <a href="#must-requirement">must</a>
+ consist of Unicode characters, with the following
restrictions:</p>
<ul>
-<li>must not contain U+0000 characters</li>
- <li>must not contain permanently undefined Unicode characters</li>
- <li>must not contain control characters other than
+<li>
+<a href="#must-requirement">must</a>
+ not contain U+0000 characters</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not contain permanently undefined Unicode characters</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not contain control characters other than
<a href="#space">space characters</a>
</li>
</ul>
@@ -1752,7 +1856,9 @@
</ul>
<p>Normal character data has the following restrictions:</p>
<ul>
-<li>must not contain any
+<li>
+<a href="#must-requirement">must</a>
+ not contain any
"<code title="U+003C LESS-THAN SIGN"><</code>"
characters</li>
@@ -1784,10 +1890,14 @@
</ul>
<p>Replaceable character data has the following restrictions:</p>
<ul>
-<li>must not contain any
+<li>
+<a href="#must-requirement">must</a>
+ not contain any
<a href="#syntax-ambiguous-ampersand">ambiguous ampersands</a>
</li>
- <li>must not contain any occurrences of the string
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any occurrences of the string
"<code title="U+003C LESS-THAN SIGN, U+002F SOLIDUS"></</code>"
followed by characters that are a
<a href="#case-insensitive">case-insensitive match</a>
@@ -1802,14 +1912,17 @@
"<code title="U+002F SOLIDUS">/</code>".</li>
</ul>
<p class="note">Replaceable character data,
- as defined in this specification, is a feature of
+ as described in this reference, is a feature of
<a href="#html-syntax">the HTML syntax</a>
that is not available in
<a href="#xml-syntax">the XML syntax</a>.
<a href="#syntax-document-xml">Documents in the XML
- syntax</a> must not contain replaceable character data
- as defined in this specification; instead they must
- conform to all syntax constraints defined in the XML
+ syntax</a>
+ <a href="#must-requirement">must</a>
+ not contain replaceable character data
+ as described in this reference; instead they
+ <a href="#must-requirement">must</a>
+ conform to all syntax constraints described in the XML
specification <a href="#refsXML">[XML]</a>.</p>
</dd>
<dt><dfn id="non-replaceable-character-data" title="non-replaceable-character-data">Non-replaceable character data</dfn></dt>
@@ -1836,9 +1949,13 @@
</ul>
<p>Non-replaceable character data has the following restrictions:</p>
<ul>
-<li>must not contain <a href="#syntax-charref">character references</a>
+<li>
+<a href="#must-requirement">must</a>
+ not contain <a href="#syntax-charref">character references</a>
</li>
- <li>must not contain any occurrences of the string
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any occurrences of the string
"<code title="U+003C LESS-THAN SIGN, U+002F SOLIDUS"></</code>",
followed by characters that are a
<a href="#case-insensitive">case-insensitive match</a>
@@ -1854,13 +1971,16 @@
"<code title="U+002F SOLIDUS">/</code>".</li>
</ul>
<p class="note">Non-replaceable character data,
- as defined in this specification, is a feature of
+ as described in this reference, is a feature of
<a href="#html-syntax">the HTML syntax</a>
that is not available in
<a href="#xml-syntax">the XML syntax</a>.
<a href="#syntax-document-xml">Documents in the XML
- syntax</a> must not contain non-replaceable character
- data as defined in this specification; instead they must
+ syntax</a>
+ <a href="#must-requirement">must</a>
+ not contain non-replaceable character
+ data as described in this reference; instead they
+ <a href="#must-requirement">must</a>
conform to all syntax constraints defined in the XML
specification <a href="#refsXML">[XML]</a>.</p>
</dd>
@@ -2015,13 +2135,21 @@
<p>The <a href="#syntax-text">text</a>
part of comments has the following restrictions:</p>
<ul>
-<li>must not start with a
+<li>
+<a href="#must-requirement">must</a>
+ not start with a
"<code title="U+003E GREATER-THAN SIGN">></code>" character</li>
- <li>must not start with the string
+ <li>
+<a href="#must-requirement">must</a>
+ not start with the string
"<code title="U+002D HYPHEN-MINUS, U+003E GREATER-THAN SIGN">-></code>"</li>
- <li>must not contain the string
+ <li>
+<a href="#must-requirement">must</a>
+ not contain the string
"<code title="U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS">--</code>"</li>
- <li>must not end with a
+ <li>
+<a href="#must-requirement">must</a>
+ not end with a
"<code title="U+002D HYPHEN-MINUS">-</code>" character</li>
</ul>
<div class="example">
@@ -2055,13 +2183,17 @@
"<code title="U+003E GREATER-THAN SIGN">></code>"
character are said to be
<dfn id="syntax-self-closing">marked as self-closing</dfn>.</li>
- <li>SVG and MathML elements must either have a
+ <li>SVG and MathML elements
+ <a href="#must-requirement">must</a>
+ either have a
<a href="#syntax-start-tags">start tag</a>
and an
<a href="#syntax-end-tags">end tag</a>,
or a start tag that is
<a href="#syntax-self-closing">marked as self-closing</a>,
- in which case they must not have an end tag.</li>
+ in which case they
+ <a href="#must-requirement">must</a>
+ not have an end tag.</li>
<li>SVG and MathML elements whose start tag is
<a href="#syntax-self-closing">marked as self-closing</a>,
can’t have any contents.</li>
@@ -2076,7 +2208,9 @@
that it contains, with the restriction
that any
<a href="#character-data">character data</a>
- it contains must be
+ it contains
+ <a href="#must-requirement">must</a>
+ be
<a href="#normal-character-data">normal character data</a>.</li>
</ul>
</div>
@@ -2095,7 +2229,9 @@
"<code title="U+003C LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+005B LEFT SQUARE BRACKET, U+0043 LATIN CAPITAL LETTER C, U+0044 LATIN CAPITAL LETTER D, U+0041 LATIN CAPITAL LETTER A, U+0054 LATIN CAPITAL LETTER T, U+0041 LATIN CAPITAL LETTER A, U+005B LEFT SQUARE BRACKET"><![CDATA[</code>"</li>
<li>
<a href="#syntax-text" title="syntax-text">text</a>, with the
- additional restriction that the text must not contain the
+ additional restriction that the text
+ <a href="#must-requirement">must</a>
+ not contain the
string
"<code title="U+005D RIGHT SQUARE BRACKET, U+005D RIGHT SQUARE BRACKET, U+003E GREATER-THAN SIGN">]]></code>“</li>
<li>the
@@ -18198,7 +18334,9 @@
<a href="#common.data.id">ID</a>
</span> </dt>
<dd>A unique identifier for the element.</dd>
-<dd>There must not be multiple elements in a document that
+<dd>There
+ <a href="#must-requirement">must</a>
+ not be multiple elements in a document that
have the same
<a href="#common.attrs.id" class="attribute">id</a>
value.</dd>
@@ -18559,7 +18697,9 @@
<dd>The <code class="attribute">xml:space</code>
attribute should only be used with
<a href="#syntax-document-xml">documents in the XML syntax</a>;
- it must not be used in
+ it
+ <a href="#must-requirement">must</a>
+ not be used in
<a href="#syntax-document-html">documents in the HTML syntax</a>.</dd>
<dt>
@@ -18571,7 +18711,9 @@
<dd>The <code class="attribute">xml:base</code>
attribute should only be used with
<a href="#syntax-document-xml">documents in the XML syntax</a>;
- it must not be used in
+ it
+ <a href="#must-requirement">must</a>
+ not be used in
<a href="#syntax-document-html">documents in the HTML syntax</a>.</dd>
</dl>
@@ -18809,10 +18951,14 @@
<a href="#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must not start with a
+<li>
+<a href="#must-requirement">must</a>
+ not start with a
"<code title="U+005F LOW LINE">_</code>"
character</li>
- <li>must be at least one character long</li>
+ <li>
+<a href="#must-requirement">must</a>
+ be at least one character long</li>
</ul>
</div>
</div>
@@ -18852,8 +18998,12 @@
<a href="#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any
<a href="#space">space characters</a>
</li>
</ul>
@@ -18875,8 +19025,12 @@
<a href="#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any
<a href="#space">space characters</a>
</li>
</ul>
@@ -18902,8 +19056,12 @@
<a href="#data-string">string</a>,
with the following restrictions:
<ul>
-<li>must be at least one character long</li>
- <li>must not contain any
+<li>
+<a href="#must-requirement">must</a>
+ be at least one character long</li>
+ <li>
+<a href="#must-requirement">must</a>
+ not contain any
<a href="#space">space characters</a>
</li>
</ul>
@@ -18949,7 +19107,9 @@
<a href="#common.data.integer.non-negative">non-negative integer</a>,
with the following restriction:
<ul>
-<li>must be greater than zero</li>
+<li>
+<a href="#must-requirement">must</a>
+ be greater than zero</li>
</ul>
</div>
</div>
@@ -19016,7 +19176,9 @@
<a href="#common.data.float.non-negative">non-negative float</a>,
with the following restriction:
<ul>
-<li>must be greater than zero</li>
+<li>
+<a href="#must-requirement">must</a>
+ be greater than zero</li>
</ul>
</div>
</div>
@@ -19049,7 +19211,9 @@
with these additional qualifications:</div>
<ul>
<li>the literal letters <code>T</code> and
- <code>Z</code> in the date/time syntax must always be
+ <code>Z</code> in the date/time syntax
+ <a href="#must-requirement">must</a>
+ always be
uppercase</li>
<li>a <dfn id="data-date-fullyear">date-fullyear</dfn> is
defined as four or more digits representing a number
@@ -19088,7 +19252,7 @@
<p class="note">The empty string is a valid
<a href="#data.iri-ref">IRI-reference</a>,
so the empty string is allowed as the value of any
- attribute for which this document defines
+ attribute for which this reference lists
<a href="#common.data.uri">URI</a>
as the allowed datatype.</p>
</div>
@@ -19125,7 +19289,9 @@
<div class="datatype-desc">An unordered set of unique
space-separated
<a href="#data-token">tokens</a>,
- each of which must be one of the following:
+ each of which
+ <a href="#must-requirement">must</a>
+ be one of the following:
<ul>
<li>the literal string "<code>any</code>"</li>
<li>two valid
@@ -19265,7 +19431,9 @@
<div class="datatype-desc">An ordered set of unique
space-separated <a href="#data-token">tokens</a>, each of
- which must be exactly one Unicode code point in
+ which
+ <a href="#must-requirement">must</a>
+ be exactly one Unicode code point in
length.</div>
</div>
</div>
@@ -19394,7 +19562,8 @@
</h2>
<div class="content-models">
- <div class="datatype-desc">A regular expression that must
+ <div class="datatype-desc">A regular expression that
+ <a href="#must-requirement">must</a>
match the JavaScript <i>Pattern</i> production <a href="#refsECMA262">[ECMA262]</a>.</div>
</div>
</div>
@@ -19431,7 +19600,7 @@
with the additional qualification that the year component
is a
<a href="#data-date-fullyear">date-fullyear</a>
- as defined in this document.</div>
+ as described in this reference.</div>
<div class="example">
<p>Example:</p>
<pre><code>1996-12-19</code></pre>
Index: .cvsignore
===================================================================
RCS file: /sources/public/html5/markup/.cvsignore,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- .cvsignore 5 Mar 2010 02:19:36 -0000 1.20
+++ .cvsignore 25 Jun 2010 05:32:26 -0000 1.21
@@ -9,3 +9,4 @@
html.css.LICENSE.xml
LICENSE.xml
MANIFEST
+schema
Received on Friday, 25 June 2010 05:32:32 UTC