Skip to content
Permalink
Browse files

[e] (0) A first pass (for this quarter, anyway) at cleaning up some t…

…erminology around the word 'document'.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=14565

git-svn-id: http://svn.whatwg.org/webapps@6771 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Oct 27, 2011
1 parent c04640e commit de261584524ce1315002591c1bcc78a6334e4b6c
Showing with 131 additions and 56 deletions.
  1. +43 −19 complete.html
  2. +43 −19 index
  3. +45 −18 source

<p>The first such concrete syntax is the HTML syntax. This is the
format suggested for most authors. It is compatible with most legacy
Web browsers. If a document is transmitted with an <a href=#html-mime-type>HTML MIME
type</a>, such as <code><a href=#text/html>text/html</a></code>, then it will be
Web browsers. If a document is transmitted with the
<code><a href=#text/html>text/html</a></code> <a href=#mime-type>MIME type</a>, then it will be
processed as an HTML document by Web browsers.

This specification defines the latest HTML syntax, known simply as

</p>

<p>The DOM, the HTML syntax, and XML cannot all represent the same
content. For example, namespaces cannot be represented using the
HTML syntax, but they are supported in the DOM and in XML.
Similarly, documents that use the <code><a href=#the-noscript-element>noscript</a></code> feature can
be represented using the HTML syntax, but cannot be represented with
the DOM or in XML. Comments that contain the string "<code title="">--&gt;</code>" can only be represented in the DOM, not in
the HTML and XML syntaxes.</p>
<p>The DOM, the HTML syntax, and the XHTML syntax cannot all
represent the same content. For example, namespaces cannot be
represented using the HTML syntax, but they are supported in the DOM
and in the XHTML syntax. Similarly, documents that use the
<code><a href=#the-noscript-element>noscript</a></code> feature can be represented using the HTML
syntax, but cannot be represented with the DOM or in the XHTML
syntax. Comments that contain the string "<code title="">--&gt;</code>" can only be represented in the DOM, not in
the HTML and XHTML syntaxes.</p>


<h3 id=structure-of-this-specification><span class=secno>1.9 </span>Structure of this specification</h3>

<dd>All of these features would be for naught if they couldn't be
represented in a serialized form and sent to other people, and so
these sections define the syntaxes of HTML, along with rules for
how to parse content using those syntaxes.</dd>
these sections define the syntaxes of HTML and XHTML, along with
rules for how to parse content using those syntaxes.</dd>


</dl><p>There are also some appendices, defining <a href=#rendering>rendering rules</a> for Web browsers and listing
<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
long essays or reports with rich multimedia, as well as to
fully-fledged interactive applications.</p>
fully-fledged interactive applications. The term is used to refer
both to <code><a href=#document>Document</a></code> objects and their descendant DOM
trees, and to serialized byte streams using the <a href=#syntax title="the
HTML syntax">HTML syntax</a> or <a href=#the-xhtml-syntax title="the XHTML
syntax">XHTML syntax</a>, depending on context.</p>

<p>In the context of the DOM structures, the terms <a href=#html-documents title="HTML
documents">HTML document</a> and <a href=#xml-documents title="XML documents">XML
document</a> are used as defined in the DOM Core specification,
and refer specifically to two different modes that
<code><a href=#document>Document</a></code> objects can find themselves in. <a href=#refsDOMCORE>[DOMCORE]</a> (Such uses are always hyperlinked
to their definition.)</p>

<p>In the context of byte streams, the term HTML document refers to
resources labeled as <code><a href=#text/html>text/html</a></code>, and the term XML
document refers to resources labeled with an <a href=#xml-mime-type>XML MIME
type</a>.</p>

<p>The term <dfn id=xhtml-document>XHTML document</dfn> is used to refer to both
<code><a href=#document>Document</a></code>s in the <a href=#xml-documents title="XML documents">XML
document</a> mode that contains element nodes in the <a href=#html-namespace-0>HTML
namespace</a>, and byte streams labeled with an <a href=#xml-mime-type>XML MIME
type</a> that contain elements from the <a href=#html-namespace-0>HTML
namespace</a>, depending on context.</p>

<p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might
<hr><p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might
sometimes be used when referring to the way a document is rendered
to the user. These terms are not meant to imply a visual medium;
they must be considered to apply to other media in equivalent
and U+0026 AMPERSAND (&amp;) characters, and to specify the <code title=attr-iframe-sandbox><a href=#attr-iframe-sandbox>sandbox</a></code> attribute, to ensure safe
embedding of content.</p>

<p class=note>Due to restrictions of <span>the XML syntax</span>,
in XML the U+003C LESS-THAN SIGN character (&lt;) needs to be
escaped as well. In order to prevent <a href=http://www.w3.org/TR/REC-xml/#AVNormalize>attribute-value
<p class=note>Due to restrictions of <a href=#the-xhtml-syntax>the XHTML
syntax</a>, in XML the U+003C LESS-THAN SIGN character (&lt;)
needs to be escaped as well. In order to prevent <a href=http://www.w3.org/TR/REC-xml/#AVNormalize>attribute-value
normalization</a>, some of XML's whitespace characters &mdash;
specifically U+0009 CHARACTER TABULATION (tab), U+000A LINE FEED
(LF), and U+000D CARRIAGE RETURN (CR) &mdash; also need to be
are covered by the next section, entitled "<a href=#the-xhtml-syntax>The XHTML
syntax</a>".</p>

<p>For <a href=#html-documents>HTML documents</a>, user agents must use the parsing
rules described in this section to generate the DOM trees. Together,
these rules define what is referred to as the <dfn id=html-parser>HTML
<p>User agents must use the parsing rules described in this section
to generate the DOM trees from <code><a href=#text/html>text/html</a></code> resources.
Together, these rules define what is referred to as the <dfn id=html-parser>HTML
parser</dfn>.</p>

<div class=note>
62 index

<p>The first such concrete syntax is the HTML syntax. This is the
format suggested for most authors. It is compatible with most legacy
Web browsers. If a document is transmitted with an <a href=#html-mime-type>HTML MIME
type</a>, such as <code><a href=#text/html>text/html</a></code>, then it will be
Web browsers. If a document is transmitted with the
<code><a href=#text/html>text/html</a></code> <a href=#mime-type>MIME type</a>, then it will be
processed as an HTML document by Web browsers.

This specification defines the latest HTML syntax, known simply as

</p>

<p>The DOM, the HTML syntax, and XML cannot all represent the same
content. For example, namespaces cannot be represented using the
HTML syntax, but they are supported in the DOM and in XML.
Similarly, documents that use the <code><a href=#the-noscript-element>noscript</a></code> feature can
be represented using the HTML syntax, but cannot be represented with
the DOM or in XML. Comments that contain the string "<code title="">--&gt;</code>" can only be represented in the DOM, not in
the HTML and XML syntaxes.</p>
<p>The DOM, the HTML syntax, and the XHTML syntax cannot all
represent the same content. For example, namespaces cannot be
represented using the HTML syntax, but they are supported in the DOM
and in the XHTML syntax. Similarly, documents that use the
<code><a href=#the-noscript-element>noscript</a></code> feature can be represented using the HTML
syntax, but cannot be represented with the DOM or in the XHTML
syntax. Comments that contain the string "<code title="">--&gt;</code>" can only be represented in the DOM, not in
the HTML and XHTML syntaxes.</p>


<h3 id=structure-of-this-specification><span class=secno>1.9 </span>Structure of this specification</h3>

<dd>All of these features would be for naught if they couldn't be
represented in a serialized form and sent to other people, and so
these sections define the syntaxes of HTML, along with rules for
how to parse content using those syntaxes.</dd>
these sections define the syntaxes of HTML and XHTML, along with
rules for how to parse content using those syntaxes.</dd>


</dl><p>There are also some appendices, defining <a href=#rendering>rendering rules</a> for Web browsers and listing
<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
long essays or reports with rich multimedia, as well as to
fully-fledged interactive applications.</p>
fully-fledged interactive applications. The term is used to refer
both to <code><a href=#document>Document</a></code> objects and their descendant DOM
trees, and to serialized byte streams using the <a href=#syntax title="the
HTML syntax">HTML syntax</a> or <a href=#the-xhtml-syntax title="the XHTML
syntax">XHTML syntax</a>, depending on context.</p>

<p>In the context of the DOM structures, the terms <a href=#html-documents title="HTML
documents">HTML document</a> and <a href=#xml-documents title="XML documents">XML
document</a> are used as defined in the DOM Core specification,
and refer specifically to two different modes that
<code><a href=#document>Document</a></code> objects can find themselves in. <a href=#refsDOMCORE>[DOMCORE]</a> (Such uses are always hyperlinked
to their definition.)</p>

<p>In the context of byte streams, the term HTML document refers to
resources labeled as <code><a href=#text/html>text/html</a></code>, and the term XML
document refers to resources labeled with an <a href=#xml-mime-type>XML MIME
type</a>.</p>

<p>The term <dfn id=xhtml-document>XHTML document</dfn> is used to refer to both
<code><a href=#document>Document</a></code>s in the <a href=#xml-documents title="XML documents">XML
document</a> mode that contains element nodes in the <a href=#html-namespace-0>HTML
namespace</a>, and byte streams labeled with an <a href=#xml-mime-type>XML MIME
type</a> that contain elements from the <a href=#html-namespace-0>HTML
namespace</a>, depending on context.</p>

<p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might
<hr><p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might
sometimes be used when referring to the way a document is rendered
to the user. These terms are not meant to imply a visual medium;
they must be considered to apply to other media in equivalent
and U+0026 AMPERSAND (&amp;) characters, and to specify the <code title=attr-iframe-sandbox><a href=#attr-iframe-sandbox>sandbox</a></code> attribute, to ensure safe
embedding of content.</p>

<p class=note>Due to restrictions of <span>the XML syntax</span>,
in XML the U+003C LESS-THAN SIGN character (&lt;) needs to be
escaped as well. In order to prevent <a href=http://www.w3.org/TR/REC-xml/#AVNormalize>attribute-value
<p class=note>Due to restrictions of <a href=#the-xhtml-syntax>the XHTML
syntax</a>, in XML the U+003C LESS-THAN SIGN character (&lt;)
needs to be escaped as well. In order to prevent <a href=http://www.w3.org/TR/REC-xml/#AVNormalize>attribute-value
normalization</a>, some of XML's whitespace characters &mdash;
specifically U+0009 CHARACTER TABULATION (tab), U+000A LINE FEED
(LF), and U+000D CARRIAGE RETURN (CR) &mdash; also need to be
are covered by the next section, entitled "<a href=#the-xhtml-syntax>The XHTML
syntax</a>".</p>

<p>For <a href=#html-documents>HTML documents</a>, user agents must use the parsing
rules described in this section to generate the DOM trees. Together,
these rules define what is referred to as the <dfn id=html-parser>HTML
<p>User agents must use the parsing rules described in this section
to generate the DOM trees from <code><a href=#text/html>text/html</a></code> resources.
Together, these rules define what is referred to as the <dfn id=html-parser>HTML
parser</dfn>.</p>

<div class=note>
63 source
@@ -567,8 +567,8 @@

<p>The first such concrete syntax is the HTML syntax. This is the
format suggested for most authors. It is compatible with most legacy
Web browsers. If a document is transmitted with an <span>HTML MIME
type</span>, such as <code>text/html</code>, then it will be
Web browsers. If a document is transmitted with the
<code>text/html</code> <span>MIME type</span>, then it will be
processed as an HTML document by Web browsers.

<!--END html--><!--END dev-html--><!--END complete--><!--END epub--><!--VERSION-->
@@ -600,14 +600,15 @@

</p>

<p>The DOM, the HTML syntax, and XML cannot all represent the same
content. For example, namespaces cannot be represented using the
HTML syntax, but they are supported in the DOM and in XML.
Similarly, documents that use the <code>noscript</code> feature can
be represented using the HTML syntax, but cannot be represented with
the DOM or in XML. Comments that contain the string "<code
<p>The DOM, the HTML syntax, and the XHTML syntax cannot all
represent the same content. For example, namespaces cannot be
represented using the HTML syntax, but they are supported in the DOM
and in the XHTML syntax. Similarly, documents that use the
<code>noscript</code> feature can be represented using the HTML
syntax, but cannot be represented with the DOM or in the XHTML
syntax. Comments that contain the string "<code
title="">--&gt;</code>" can only be represented in the DOM, not in
the HTML and XML syntaxes.</p>
the HTML and XHTML syntaxes.</p>


<h3>Structure of this specification</h3>
@@ -707,8 +708,8 @@

<dd>All of these features would be for naught if they couldn't be
represented in a serialized form and sent to other people, and so
these sections define the syntaxes of HTML, along with rules for
how to parse content using those syntaxes.</dd>
these sections define the syntaxes of HTML and XHTML, along with
rules for how to parse content using those syntaxes.</dd>


</dl>
@@ -1926,7 +1927,33 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
long essays or reports with rich multimedia, as well as to
fully-fledged interactive applications.</p>
fully-fledged interactive applications. The term is used to refer
both to <code>Document</code> objects and their descendant DOM
trees, and to serialized byte streams using the <span title="the
HTML syntax">HTML syntax</span> or <span title="the XHTML
syntax">XHTML syntax</span>, depending on context.</p>

<p>In the context of the DOM structures, the terms <span title="HTML
documents">HTML document</span> and <span title="XML documents">XML
document</span> are used as defined in the DOM Core specification,
and refer specifically to two different modes that
<code>Document</code> objects can find themselves in. <a
href="#refsDOMCORE">[DOMCORE]</a> (Such uses are always hyperlinked
to their definition.)</p>

<p>In the context of byte streams, the term HTML document refers to
resources labeled as <code>text/html</code>, and the term XML
document refers to resources labeled with an <span>XML MIME
type</span>.</p>

<p>The term <dfn>XHTML document</dfn> is used to refer to both
<code>Document</code>s in the <span title="XML documents">XML
document</span> mode that contains element nodes in the <span>HTML
namespace</span>, and byte streams labeled with an <span>XML MIME
type</span> that contain elements from the <span>HTML
namespace</span>, depending on context.</p>

<hr>

<p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn
title="">displayed</dfn>, and <dfn title="">visible</dfn> might
title="attr-iframe-sandbox">sandbox</code> attribute, to ensure safe
embedding of content.</p>

<p class="note">Due to restrictions of <span>the XML syntax</span>,
in XML the U+003C LESS-THAN SIGN character (&lt;) needs to be
escaped as well. In order to prevent <a
<p class="note">Due to restrictions of <span>the XHTML
syntax</span>, in XML the U+003C LESS-THAN SIGN character (&lt;)
needs to be escaped as well. In order to prevent <a
href="http://www.w3.org/TR/REC-xml/#AVNormalize">attribute-value
normalization</a>, some of XML's whitespace characters &mdash;
specifically U+0009 CHARACTER TABULATION (tab), U+000A LINE FEED
are covered by the next section, entitled "<span>The XHTML
syntax</span>".</p>

<p>For <span>HTML documents</span>, user agents must use the parsing
rules described in this section to generate the DOM trees. Together,
these rules define what is referred to as the <dfn>HTML
<p>User agents must use the parsing rules described in this section
to generate the DOM trees from <code>text/html</code> resources.
Together, these rules define what is referred to as the <dfn>HTML
parser</dfn>.</p>

<div class="note">

0 comments on commit de26158

Please sign in to comment.
You can’t perform that action at this time.