[html5] r1434 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2008-04-11 17:57:46 -0700 (Fri, 11 Apr 2008)
New Revision: 1434

Modified:
   index
   source
Log:
[agow] (2) Require authors to include punctuation for <q>. Browsers should not render punctuation marks any more (the rendering section will make that clearer).

Modified: index
===================================================================
--- index	2008-04-11 16:36:55 UTC (rev 1433)
+++ index	2008-04-12 00:57:46 UTC (rev 1434)
@@ -24,7 +24,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=working>Working Draft — 11 April 2008</h2>
+   <h2 class="no-num no-toc" id=working>Working Draft — 12 April 2008</h2>
 
    <p>You can take part in this work. <a
     href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -10518,6 +10518,9 @@
   <p>The <code><a href="#q">q</a></code> element represents a part of a
    paragraph quoted from another source.
 
+  <p>Quotation punctuation (such as quotation marks), if any, must be placed
+   inside the <code><a href="#q">q</a></code> element.
+
   <p>Content inside a <code><a href="#q">q</a></code> element must be quoted
    from another source, whose URI, if it has one, should be cited in the <dfn
    id=cite1 title=attr-q-cite><code>cite</code></dfn> attribute.
@@ -10532,9 +10535,41 @@
    href="#q">q</a></code> element descendants, then, the title of the work
    given by that <code><a href="#cite2">cite</a></code> element gives the
    source of the quotation contained in the <code><a href="#q">q</a></code>
-   element.</p>
-  <!-- XXX need examples -->
+   element.
 
+  <div class=example>
+   <p>Here is a simple example of the use of the <code><a
+    href="#q">q</a></code> element:</p>
+
+   <pre><p>The man said <q>"Things that are impossible just take
+longer"</q>. I disagreed with him.</p></pre>
+  </div>
+
+  <div class=example>
+   <p>Here is an example with both an explicit citation link in the <code><a
+    href="#q">q</a></code> element, and an explicit citation outside:</p>
+
+   <pre><p>The W3C page <cite>About W3C</cite> says the W3C's
+mission is <q cite="http://www.w3.org/Consortium/">"To lead the
+World Wide Web to its full potential by developing protocols and
+guidelines that ensure long-term growth for the Web"</q>. I
+disagree with this mission.</p></pre>
+  </div>
+
+  <div class=example>
+   <p>In the following example, the quotation itself contains a quotation:</p>
+
+   <pre><p>In <cite>Example One</cite>, he writes <q>"The man
+said <q>'Things that are impossible just take longer'</q>. I
+disagreed with him". Well, I disagree even more!</p></pre>
+  </div>
+
+  <div class=example>
+   <p>In the following example, there are no quotation marks:</p>
+
+   <pre><p>His best argument: <q>I disagree!</q></p></pre>
+  </div>
+
   <h4 id=the-cite><span class=secno>3.10.3 </span>The <dfn
    id=cite2><code>cite</code></dfn> element</h4>
 

Modified: source
===================================================================
--- source	2008-04-11 16:36:55 UTC (rev 1433)
+++ source	2008-04-12 00:57:46 UTC (rev 1434)
@@ -8655,6 +8655,9 @@
   <p>The <code>q</code> element represents a part of a paragraph
   quoted from another source.</p>
 
+  <p>Quotation punctuation (such as quotation marks), if any, must be
+  placed inside the <code>q</code> element.</p>
+
   <p>Content inside a <code>q</code> element must be quoted from
   another source, whose URI, if it has one, should be cited in the
   <dfn title="attr-q-cite"><code>cite</code></dfn> attribute.</p>
@@ -8670,9 +8673,49 @@
   the source of the quotation contained in the <code>q</code>
   element.</p>
 
-  <!-- XXX need examples -->
+  <div class="example">
 
+   <p>Here is a simple example of the use of the <code>q</code>
+   element:</p>
 
+   <pre><p>The man said <q>"Things that are impossible just take
+longer"</q>. I disagreed with him.</p></pre>
+
+  </div>
+
+  <div class="example">
+
+   <p>Here is an example with both an explicit citation link in the
+   <code>q</code> element, and an explicit citation outside:</p>
+
+   <pre><p>The W3C page <cite>About W3C</cite> says the W3C's
+mission is <q cite="http://www.w3.org/Consortium/">"To lead the
+World Wide Web to its full potential by developing protocols and
+guidelines that ensure long-term growth for the Web"</q>. I
+disagree with this mission.</p></pre>
+
+  </div>
+
+  <div class="example">
+
+   <p>In the following example, the quotation itself contains a
+   quotation:</p>
+
+   <pre><p>In <cite>Example One</cite>, he writes <q>"The man
+said <q>'Things that are impossible just take longer'</q>. I
+disagreed with him". Well, I disagree even more!</p></pre>
+
+  </div>
+
+  <div class="example">
+
+   <p>In the following example, there are no quotation marks:</p>
+
+   <pre><p>His best argument: <q>I disagree!</q></p></pre>
+
+  </div>
+
+
   <h4>The <dfn><code>cite</code></dfn> element</h4>
 
   <dl class="element">