W3C home > Mailing lists > Public > public-html-commits@w3.org > December 2010

html5/markup/src documents.html,1.13,1.14 references.html,1.26,1.27 terms.html,1.25,1.26

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 16 Dec 2010 07:21:02 +0000
To: public-html-commits@w3.org
Message-Id: <E1PT898-0008F7-MT@lionel-hutz.w3.org>
Update of /sources/public/html5/markup/src
In directory hutz:/tmp/cvs-serv30569/src

Modified Files:
	documents.html references.html terms.html 
Log Message:
added explanation of implied start and end tags


Index: references.html
===================================================================
RCS file: /sources/public/html5/markup/src/references.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- references.html	12 Aug 2010 19:55:38 -0000	1.26
+++ references.html	16 Dec 2010 07:21:00 -0000	1.27
@@ -39,9 +39,10 @@
       Mike Champion,
       Steve Byrne.
       W3C Recommendation.</dd>
-    <dd><span class="references-note" >(see in particular <a
-          href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent"
-      >http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent</a>)</span></dd>
+    <dd><span class="references-note" >(see in particular
+      <a href="http://www.w3.org/TR/DOM-Level-3-Core/introduction.html">http://www.w3.org/TR/DOM-Level-3-Core/introduction.html</a>
+      and
+      <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent">http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent</a>)</span></dd>
     <dt><dfn id="refsECMA262">ECMA 262</dfn></dt>
     <dd><cite><a
           href="http://www.ecma-international.org/publications/standards/Ecma-262.htm"

Index: terms.html
===================================================================
RCS file: /sources/public/html5/markup/src/terms.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- terms.html	12 Aug 2010 19:55:38 -0000	1.25
+++ terms.html	16 Dec 2010 07:21:00 -0000	1.26
@@ -26,6 +26,15 @@
       and the corresponding characters in the range
       <code title="U+0061 LATIN SMALL LETTER A–U+007A LATIN SMALL LETTER Z">a-z</code>
       are considered to also match.</dd>
+    <dt><dfn id="dom-tree" >DOM tree</dfn></dt>
+    <dd>A representation of a document based on the W3C Document Object
+      Model (DOM), as defined in <cite>Document Object Model (DOM) Level 3
+      Core</cite> specification, and as explained in the “What is the
+      Document Object Model?” introduction for that specification
+      <a href="#refsDOMCore">[DOM Core]</a>.
+      <a href="#UA">UA</a>s
+      build representations of documents by parsing them and constructing
+      DOM trees from them.</dd>
     <dt><dfn
         id="fallback"
         title="fallback"
@@ -134,5 +143,8 @@
         <a href="#common.elem.phrasing">phrasing elements</a></li>
       </ul>
     </dd>
+    <dt><dfn id="UA">UA</dfn></dt>
+    <dd>An HTML user agent; that is, an application (such as a
+    Web browser) which consumes HTML content.</dd>
   </dl>
 </section>

Index: documents.html
===================================================================
RCS file: /sources/public/html5/markup/src/documents.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- documents.html	8 Aug 2010 09:49:20 -0000	1.13
+++ documents.html	16 Dec 2010 07:21:00 -0000	1.14
@@ -89,10 +89,15 @@
   </section>
   <section id="conformant-documents">
     <h2>Conformant documents</h2>
+    <p>There are two types of conformant documents:</p>
+    <ul>
+      <li><a href="#syntax-document-html">conformant documents in the HTML syntax</a></li>
+      <li><a href="#syntax-document-xml">conformant documents in the XML syntax</a></li>
+    </ul>
+    <section class="no-toc" id="conformant-html">
+    <h2>Conformant documents in the HTML syntax</h2>
     <p>A conformant
-    <dfn id="syntax-document-html"
-      title="syntax-document-html">document in the HTML
-      syntax</dfn>
+    <dfn id="syntax-document-html">document in the HTML syntax</dfn>
     <a href="#must-requirement">must</a>
     consist of the following parts, in the
     following order:</p>
@@ -110,8 +115,24 @@
       <a href="#html" class="element">html</a> element,
       with its
       <a href="#attribute">attributes</a>
-      and
-      <a href="#contents">contents</a>.</li>
+      (if any) and its
+      <a href="#contents">contents</a>
+      (if any).
+        <p class="note">The
+        <a href="#syntax-start-tags">start tag</a>
+        and
+        <a href="#syntax-end-tags">end tag</a>
+        of the
+        <a href="#html" class="element">html</a>
+        element
+        <a href="#omitted">can be omitted</a>—as
+        well as, possibly, the start tags and end tags of certain
+        descendants of the
+        <a href="#html" class="element">html</a>
+        element—in which case the start tag and end tag are considered to
+        be
+        <a href="#syntax-implied-tags">implied</a>.</p>
+      </li>
       <li>Any number of
       <a href="#syntax-comments">comments</a> and
       <a href="#space">space characters</a>.</li>
@@ -119,8 +140,87 @@
     <p><a href="#syntax-document-html">Documents in the HTML syntax</a>
     <a href="#must-requirement">must</a>
     match the syntax described in the
-    <a href="#html-syntax">HTML syntax</a>
+    <a href="#syntax">HTML syntax</a>
     section of this reference.</p>
+    <section class="no-toc" id="syntax-implied-tags">
+     <h2>Implied start tags and end tags</h2>
+      <p>In
+        <a href="#syntax-document-html">documents in the HTML syntax</a>,
+        the 
+        <a href="#syntax-start-tags">start tags</a>
+        and
+        <a href="#syntax-end-tags">end tags</a>
+        of the
+        <a href="#html" class="element">html</a>
+        element and particular descendants of the
+        <a href="#html" class="element">html</a>
+        element
+        <a href="#omitted">can be omitted</a>.
+        In cases where such tag omission occurs, certain elements (such as
+        the
+        <a href="#html" class="element">html</a>
+        element) are nevertheless still considered, conceptually, to be
+        contained within the document—but with their start tags and end
+        tags <em>implied</em>.</p>
+      <div class="example">
+        <p>The following is an example of a document with implied start tags
+        and end tags for the
+        <a href="#html" class="element">html</a>,
+        <a href="#html" class="element">head</a>,
+        and
+        <a href="#html" class="element">body</a>
+        elements. Note that it is nevertheless a complete, valid document.</p>
+        <pre>&lt;!DOCTYPE html>
+&lt;title>A relatively minimal HTML document&lt;/title>
+&lt;p>Hello World!&lt;/p></pre>
+
+        <p>The
+        <a href="#dom-tree">DOM tree</a>
+        constructed from that example by a conformant
+        <a href="#UA">UA</a>
+        would look like this:</p>
+        <ul id="dom">
+          <li class="t10">DOCTYPE: <code>html</code></li>
+          <li class="t1">
+            <code>HTML</code>
+            <ul>
+              <li class="t1">
+                <code>HEAD</code>
+                <ul>
+                  <li class="t1">
+                    <code>TITLE</code>
+                    <ul>
+                      <li class="t3"><code>#text</code>: <span>A relatively minimal HTML document</span></li>
+                    </ul>
+                  </li>
+                  <li class="t3"><code>#text</code>: <span>↩ </span></li>
+                </ul>
+              </li>
+              <li class="t1">
+                <code>BODY</code>
+                <ul>
+                  <li class="t1">
+                    <code>P</code>
+                    <ul>
+                      <li class="t3"><code>#text</code>: <span>Hello World!</span></li>
+                    </ul>
+                  </li>
+                </ul>
+              </li>
+            </ul>
+          </li>
+        </ul>
+        <p>Note that the DOM tree includes the 
+        <a href="#html" class="element">html</a>,
+        <a href="#html" class="element">head</a>,
+        and
+        <a href="#html" class="element">body</a>
+        elements whose start tags and end tags are implied in the document.</p>
+      </div>
+    </section>
+    </section>
+    <section class="no-toc" id="conformant-xml">
+    <h2>Conformant documents in the XML syntax</h2>
     <p>A conformant
     <dfn id="syntax-document-xml"
       title="syntax-document-xml">document in the XML syntax</dfn>
@@ -150,6 +250,7 @@
     not
     <a href="#omitted">omit tags</a>).</p>
   </section>
+  </section>
   <section id="case-insensitivity">
     <h2>Case insensitivity in tag names and attribute names</h2>
     <p>In
Received on Thursday, 16 December 2010 07:21:05 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 16 December 2010 07:21:08 GMT