CVS html5/html-xhtml-author-guide

Update of /sources/public/html5/html-xhtml-author-guide
In directory roscoe:/tmp/cvs-serv31663

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
better fixing or bug 21810

--- /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html	2013/04/24 12:11:54	1.102
+++ /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html	2013/04/24 15:20:41	1.103
@@ -823,7 +823,7 @@
 		<pre class="example highlight">&lt;script&gt;document.body.appendChild(document.createElement("div"));&lt;/script&gt;</pre>
 	<p class="note">
 		A workaround for using ambiguous strings is to include the properly escaped characters 
-		inside the <code>@src</code> attribute of <code>style</code> or <code>script</code> tags.
+		inside the <code>src</code> attribute of <code>style</code> or <code>script</code> tags.
 	</p>
 	<!-- End section: Ambiguous strings -->
 	</section>
@@ -853,39 +853,40 @@
 		The example page could also be served as <code>'application/xhtml+xml'</code> instead, with the file extension .html, 
 		maintaining adherence to Polyglot markup and enabling the rendering of the SVG.
 	</p>
-	<pre class="example">&lt;!DOCTYPE html>
+	<pre class="example" id="SampleDoc">&lt;!DOCTYPE html>
 
-&lt;html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+&lt;html id="SampleDoc" xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 
   &lt;head>
     &lt;title>A Sample Page Using Polglot Markup&lt;/title>
     &lt;meta charset='utf-8' />
-	&lt;!-- The link element is self-closing as described in Section 6.4 Void Elements -->
+	&lt;!-- The link element is self-closing as described in <a href="http://www.w3.org/TR/html-polyglot/#empty-elements">Section 6.4 Void Elements</a> -->
 	&lt;!-- Style commands are included by linking to an external file rather than including them in-line, 
-	  as described in Section 9. Script and Style -->
+	  as described in <a href="http://www.w3.org/TR/html-polyglot/#script-and-style">Section 9. Script and Style</a> -->
 	&lt;link type="text/css" rel="stylesheet" href="Sample.css"/>
   &lt;/head>
 
   &lt;body>
+&lt;nav>&lt;p>&lt;strong>NB:&lt;/strong> These bytes are available served as &lt;a href="SamplePage.xhtml"><a href="SamplePage.xhtml">XHTML</a>&lt;/a> and as &lt;a href="SamplePage.html"><a href="SamplePage.html">HTML</a>&lt;/a>&lt;/p>&lt;/nav>
+
     &lt;h1>Sample Page Using Polyglot Markup&lt;/h1>
     &lt;p>
-      The source code for this document uses polyglot markup, 
+      The source code for &lt;a href="#SampleDoc">this document&lt;/a> uses &lt;dfn id="sampleDef">polyglot markup&lt;/dfn>, 
       a document that is a stream of bytes that parses into identical document trees 
       (with the exception of the xmlns attribute on the root element) when processed as HTML and when processed as XML.
       The source code for this document also contains additional comments about the use of 
-      polyglot markup.
+      &lt;a href="#sampleDef">polyglot markup&lt;/a>.
     &lt;/p>
 
     &lt;h2>Foreign Elements&lt;/h2>
     &lt;p>
       The following shapes use SVG elements.
-      Polyglot markup introduces undeclared (native) default namespaces 
+      &lt;a href="#sampleDef">Polyglot markup&lt;/a> introduces undeclared (native) default namespaces 
       for the the root SVG element (&lt;code>svg&lt;/code>) and respects the mixed-case element names and values 
-      when appropriate, as described in sections 5.1 Element-Level Namespaces, 
-      6.3.1 Element Names, and 6.3.3 Attribute Values.
+      when appropriate, as described in the sections <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#element-level-namespaces">5.1 Element-Level Namespaces</a>, <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#element-names">6.3.1 Element Names</a>, and <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#attribute-values">6.3.3 Attribute Values</a>.
     &lt;/p>
 
-    &lt;!-- Polyglot markup declares the xlink: namespace on the &lt;svg> element to maintain XML-compatibility  -->
+    &lt;!-- &lt;a href="#sampleDef">Polyglot markup&lt;/a> declares the xlink: namespace on the &lt;svg> element to maintain XML-compatibility  -->
     &lt;svg width="350" height="250" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
       &lt;g>
         &lt;title>Three SVG shapes&lt;/title>
@@ -920,26 +921,26 @@
     &lt;/svg> 		
     &lt;h2>Void Elements&lt;/h2>
     &lt;!-- Given an empty instance of an element whose content model is not EMPTY (in this case, an empty paragraph) 
-    polyglot markup does not use the minimized form, as described in Section 6.4 Void Elements -->
+    &lt;a href="#sampleDef">polyglot markup&lt;/a> does not use the minimized form, as described in Section 6.4 Void Elements -->
     &lt;p>&lt;/p>
     &lt;p>
       There is an empty &lt;code>p&lt;/code> element before this paragraph. 
-      Polyglot markup uses &lt;code>&lt;p>&lt;/p>&lt;/code> and not &lt;code>&lt;p/>&lt;/code>.
+      &lt;a href="#sampleDef">Polyglot markup&lt;/a> uses &lt;code>&amp;lt;p>&amp;lt;/p>&lt;/code> and not &lt;code>&amp;lt;p/>&lt;/code>.
     &lt;/p>
     &lt;p>
-      Polyglot markup treats certain elements as self-closing, 
+      &lt;a href="#sampleDef">Polyglot markup&lt;/a> treats certain elements as self-closing, 
       void elements, such as the following &lt;code>img&lt;/code> element.
     &lt;/p>
     &lt;img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
     &lt;p>
-      For more information, see Section 6.4 Void Elements.
+      For more information, see <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#empty-elements">Section 6.4 Void Elements</a>.
     &lt;/p>
 
 
     &lt;h2>Required Elements&lt;/h2>
     &lt;p>
       The following table uses the required &lt;code>tbody&lt;/code> element, as described in 
-      Section 6.1 Required Elements.
+      <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#required-elements">Section 6.1 Required Elements</a>.
     &lt;/p>
     &lt;table>
       &lt;tbody>
@@ -964,7 +965,7 @@
 
     &lt;p>
       The following table uses the required &lt;code>colgroup&lt;/code> element, as described in 
-      Section 6.1 Required Elements.  
+      <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#required-elements">Section 6.1 Required Elements</a>.  
     &lt;/p>
     &lt;table>
       &lt;colgroup>
@@ -993,9 +994,9 @@
 
     &lt;h2>Named Entity References&lt;/h2>
     &lt;p>
-      This paragraph uses the string "&amp;amp;" for ampersands ("&amp;") and uses the string "&#xA0;" 
-      for a nonbreaking space between the words "polyglot markup," as described in 
-      Section 8. Named Entity References.
+      The paragraph you now read, uses the string &lt;code>&amp;amp;amp;&lt;/code> for ampersands (“&amp;amp;”) and uses,
+      as described in <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#named-entity-references">Section 8. Named Entity References</a>, the string &lt;code>&amp;amp;#xA0;&lt;/code> 
+      for a nonbreaking space between the following two words: &lt;i>“&lt;a href="#sampleDef">polyglot&amp;amp;#xA0;markup&lt;/a>”&lt;/i>.
     &lt;/p>
   &lt;/body>
 &lt;/html></pre>

Received on Wednesday, 24 April 2013 15:20:46 UTC