[e] (0) Various minor fixes and an elaboration of an example.

git-svn-id: http://svn.whatwg.org/webapps@5226 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jul 30, 2010 · 38230bf · 38230bf
1 parent 8727006
commit 38230bf
Show file tree

Hide file tree

Showing 3 changed files with 96 additions and 36 deletions.
diff --git a/complete.html b/complete.html
@@ -16041,6 +16041,27 @@ <h4 id=headings-and-sections><span class=secno>4.4.11 </span><dfn>Headings and s
    <p>Both of the documents above are semantically identical and would
    produce the same outline in compliant user agents.</p>
 
+   <p>This third example is also semantically identical, and might be
+   easier to maintain (e.g. if sections are often moved around in
+   editing):</p>
+
+   <pre>&lt;body&gt;
+ &lt;h1&gt;Apples&lt;/h1&gt;
+ &lt;p&gt;Apples are fruit.&lt;/p&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Taste&lt;/h1&gt;
+  &lt;p&gt;They taste lovely.&lt;/p&gt;
+  &lt;section&gt;
+   &lt;h1&gt;Sweet&lt;/h1&gt;
+   &lt;p&gt;Red apples are sweeter than green ones.&lt;/p&gt;
+  &lt;/section&gt;
+ &lt;/section&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Color&lt;/h1&gt;
+  &lt;p&gt;Apples come in various colors.&lt;/p&gt;
+ &lt;/section&gt;
+&lt;/body&gt;</pre>
+
   </div>
 
 
@@ -21522,19 +21543,18 @@ <h4 id=the-iframe-element><span class=secno>4.8.2 </span>The <dfn><code>iframe</
    original parent <code><a href=#document>Document</a></code> if its <code><a href=#the-iframe-element>iframe</a></code> is
    moved to another <code><a href=#document>Document</a></code>.</p>
 
-   <p>On the other hand, if an <code><a href=#the-iframe-element>iframe</a></code> is <span class=note><a href=#remove-an-element-from-a-document title="remove an element from a
-   document">removed</a> from a <code><a href=#document>Document</a></code> and is then
-   subsequently garbage collected, this will likely mean (in the
-   absence of other references) that the <a href=#child-browsing-context>child browsing
-   context</a>'s <code><a href=#windowproxy>WindowProxy</a></code> object will become
-   eligble for garbage collection, which will then lead to that
-   <a href=#browsing-context>browsing context</a> being <a href=#a-browsing-context-is-discarded title="a browsing context
-   is discarded">discarded</a>, which will then lead to its
-   <code><a href=#document>Document</a></code> being <a href=#discard-a-document title="discard a
+   <p>On the other hand, if an <code><a href=#the-iframe-element>iframe</a></code> is <a href=#remove-an-element-from-a-document title="remove an element from a document">removed</a> from a
+   <code><a href=#document>Document</a></code> and is then subsequently garbage collected,
+   this will likely mean (in the absence of other references) that the
+   <a href=#child-browsing-context>child browsing context</a>'s <code><a href=#windowproxy>WindowProxy</a></code>
+   object will become eligble for garbage collection, which will then
+   lead to that <a href=#browsing-context>browsing context</a> being <a href=#a-browsing-context-is-discarded title="a
+   browsing context is discarded">discarded</a>, which will then
+   lead to its <code><a href=#document>Document</a></code> being <a href=#discard-a-document title="discard a
    document">discarded</a> also. This happens without notice to any
    scripts running in that <code><a href=#document>Document</a></code>; for example, no
    <code title=event-unload>unload</code> events are fired (the
-   "<a href=#unload-a-document>unload a document</a>" steps are not run).</span></p>
+   "<a href=#unload-a-document>unload a document</a>" steps are not run).</p>
 
   </div>
 
@@ -30512,8 +30532,8 @@ <h6 id=colors-and-styles><span class=secno>4.8.11.1.4 </span>Colors and styles</
   unrecognized value is given, then the user agent must raise a
   <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception. User agents must recognize the
   four values described above exactly (e.g. they must not do case
-  folding). The method must return a <code><a href=#canvaspattern>CanvasPattern</a></code> object
-  suitably initialized.</p>
+  folding). Except as specified below, the method must return a
+  <code><a href=#canvaspattern>CanvasPattern</a></code> object suitably initialized.</p>
 
   <p>The <var title="">image</var> argument is an instance of either
   <code><a href=#htmlimageelement>HTMLImageElement</a></code>, <code><a href=#htmlcanvaselement>HTMLCanvasElement</a></code>, or

diff --git a/index b/index
@@ -15965,6 +15965,27 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
    <p>Both of the documents above are semantically identical and would
    produce the same outline in compliant user agents.</p>
 
+   <p>This third example is also semantically identical, and might be
+   easier to maintain (e.g. if sections are often moved around in
+   editing):</p>
+
+   <pre>&lt;body&gt;
+ &lt;h1&gt;Apples&lt;/h1&gt;
+ &lt;p&gt;Apples are fruit.&lt;/p&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Taste&lt;/h1&gt;
+  &lt;p&gt;They taste lovely.&lt;/p&gt;
+  &lt;section&gt;
+   &lt;h1&gt;Sweet&lt;/h1&gt;
+   &lt;p&gt;Red apples are sweeter than green ones.&lt;/p&gt;
+  &lt;/section&gt;
+ &lt;/section&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Color&lt;/h1&gt;
+  &lt;p&gt;Apples come in various colors.&lt;/p&gt;
+ &lt;/section&gt;
+&lt;/body&gt;</pre>
+
   </div>
 
 
@@ -21446,19 +21467,18 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
    original parent <code><a href=#document>Document</a></code> if its <code><a href=#the-iframe-element>iframe</a></code> is
    moved to another <code><a href=#document>Document</a></code>.</p>
 
-   <p>On the other hand, if an <code><a href=#the-iframe-element>iframe</a></code> is <span class=note><a href=#remove-an-element-from-a-document title="remove an element from a
-   document">removed</a> from a <code><a href=#document>Document</a></code> and is then
-   subsequently garbage collected, this will likely mean (in the
-   absence of other references) that the <a href=#child-browsing-context>child browsing
-   context</a>'s <code><a href=#windowproxy>WindowProxy</a></code> object will become
-   eligble for garbage collection, which will then lead to that
-   <a href=#browsing-context>browsing context</a> being <a href=#a-browsing-context-is-discarded title="a browsing context
-   is discarded">discarded</a>, which will then lead to its
-   <code><a href=#document>Document</a></code> being <a href=#discard-a-document title="discard a
+   <p>On the other hand, if an <code><a href=#the-iframe-element>iframe</a></code> is <a href=#remove-an-element-from-a-document title="remove an element from a document">removed</a> from a
+   <code><a href=#document>Document</a></code> and is then subsequently garbage collected,
+   this will likely mean (in the absence of other references) that the
+   <a href=#child-browsing-context>child browsing context</a>'s <code><a href=#windowproxy>WindowProxy</a></code>
+   object will become eligble for garbage collection, which will then
+   lead to that <a href=#browsing-context>browsing context</a> being <a href=#a-browsing-context-is-discarded title="a
+   browsing context is discarded">discarded</a>, which will then
+   lead to its <code><a href=#document>Document</a></code> being <a href=#discard-a-document title="discard a
    document">discarded</a> also. This happens without notice to any
    scripts running in that <code><a href=#document>Document</a></code>; for example, no
    <code title=event-unload>unload</code> events are fired (the
-   "<a href=#unload-a-document>unload a document</a>" steps are not run).</span></p>
+   "<a href=#unload-a-document>unload a document</a>" steps are not run).</p>
 
   </div>
 
@@ -30439,8 +30459,8 @@ idea from Mihai:
   unrecognized value is given, then the user agent must raise a
   <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception. User agents must recognize the
   four values described above exactly (e.g. they must not do case
-  folding). The method must return a <code><a href=#canvaspattern>CanvasPattern</a></code> object
-  suitably initialized.</p>
+  folding). Except as specified below, the method must return a
+  <code><a href=#canvaspattern>CanvasPattern</a></code> object suitably initialized.</p>
 
   <p>The <var title="">image</var> argument is an instance of either
   <code><a href=#htmlimageelement>HTMLImageElement</a></code>, <code><a href=#htmlcanvaselement>HTMLCanvasElement</a></code>, or

diff --git a/source b/source
@@ -16941,6 +16941,27 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
    <p>Both of the documents above are semantically identical and would
    produce the same outline in compliant user agents.</p>
 
+   <p>This third example is also semantically identical, and might be
+   easier to maintain (e.g. if sections are often moved around in
+   editing):</p>
+
+   <pre>&lt;body&gt;
+ &lt;h1&gt;Apples&lt;/h1&gt;
+ &lt;p&gt;Apples are fruit.&lt;/p&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Taste&lt;/h1&gt;
+  &lt;p&gt;They taste lovely.&lt;/p&gt;
+  &lt;section&gt;
+   &lt;h1&gt;Sweet&lt;/h1&gt;
+   &lt;p&gt;Red apples are sweeter than green ones.&lt;/p&gt;
+  &lt;/section&gt;
+ &lt;/section&gt;
+ &lt;section&gt;
+  &lt;h1&gt;Color&lt;/h1&gt;
+  &lt;p&gt;Apples come in various colors.&lt;/p&gt;
+ &lt;/section&gt;
+&lt;/body&gt;</pre>
+
   </div>
 
 
@@ -22912,16 +22933,15 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
    original parent <code>Document</code> if its <code>iframe</code> is
    moved to another <code>Document</code>.</p>
 
-   <p>On the other hand, if an <code>iframe</code> is <span <p
-   class="note"><span title="remove an element from a
-   document">removed</span> from a <code>Document</code> and is then
-   subsequently garbage collected, this will likely mean (in the
-   absence of other references) that the <span>child browsing
-   context</span>'s <code>WindowProxy</code> object will become
-   eligble for garbage collection, which will then lead to that
-   <span>browsing context</span> being <span title="a browsing context
-   is discarded">discarded</span>, which will then lead to its
-   <code>Document</code> being <span title="discard a
+   <p>On the other hand, if an <code>iframe</code> is <span
+   title="remove an element from a document">removed</span> from a
+   <code>Document</code> and is then subsequently garbage collected,
+   this will likely mean (in the absence of other references) that the
+   <span>child browsing context</span>'s <code>WindowProxy</code>
+   object will become eligble for garbage collection, which will then
+   lead to that <span>browsing context</span> being <span title="a
+   browsing context is discarded">discarded</span>, which will then
+   lead to its <code>Document</code> being <span title="discard a
    document">discarded</span> also. This happens without notice to any
    scripts running in that <code>Document</code>; for example, no
    <code title="event-unload">unload</code> events are fired (the
@@ -33468,8 +33488,8 @@ idea from Mihai:
   unrecognized value is given, then the user agent must raise a
   <code>SYNTAX_ERR</code> exception. User agents must recognize the
   four values described above exactly (e.g. they must not do case
-  folding). The method must return a <code>CanvasPattern</code> object
-  suitably initialized.</p>
+  folding). Except as specified below, the method must return a
+  <code>CanvasPattern</code> object suitably initialized.</p>
 
   <p>The <var title="">image</var> argument is an instance of either
   <code>HTMLImageElement</code>, <code>HTMLCanvasElement</code>, or