html5/spec Overview.html,1.1656,1.1657

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv31163

Modified Files:
	Overview.html 
Log Message:
<q>: now with UA-inserted quotes. Again. (whatwg r2486)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1656
retrieving revision 1.1657
diff -u -d -r1.1656 -r1.1657
--- Overview.html	30 Nov 2008 07:13:40 -0000	1.1656
+++ Overview.html	30 Nov 2008 08:32:45 -0000	1.1657
@@ -9632,12 +9632,20 @@
     The <code><a href=#the-q-element>q</a></code> element uses the <code><a href=#htmlquoteelement>HTMLQuoteElement</a></code> interface.
    </dd>
   </dl><p>The <code><a href=#the-q-element>q</a></code> element represents some <a href=#phrasing-content-0 title="phrasing
-  content">phrasing content</a> quoted from another source.<p>Quotation punctuation (such as quotation marks), if any, must be
-  placed inside the <code><a href=#the-q-element>q</a></code> element.<p>Content inside a <code><a href=#the-q-element>q</a></code> element must be quoted from
+  content">phrasing content</a> quoted from another source.<p>Quotation punctuation (such as quotation marks) must not appear
+  immediately before, after, or inside <code><a href=#the-q-element>q</a></code> elements; they
+  will be inserted into the rendering by the user agent.<p>Content inside a <code><a href=#the-q-element>q</a></code> element must be quoted from
   another source, whose address, if it has one, should be cited in the
-  <dfn id=attr-q-cite title=attr-q-cite><code>cite</code></dfn> attribute.<p>If the <code title=attr-q-cite><a href=#attr-q-cite>cite</a></code> attribute is
-  present, it must be a <a href=#valid-url>valid URL</a>. User agents should allow
-  users to follow such citation links.<p>If a <code><a href=#the-q-element>q</a></code> element is contained (directly or indirectly)
+  <dfn id=attr-q-cite title=attr-q-cite><code>cite</code></dfn> attribute. The
+  source may be fictional, as when quoting characters in a novel or
+  screenplay.<p>If the <code title=attr-q-cite><a href=#attr-q-cite>cite</a></code> attribute is
+  present, it must be a <a href=#valid-url>valid URL</a>. User agents should
+  allow users to follow such citation links.<p>The <code><a href=#the-q-element>q</a></code> element must not be used in place of quotation
+  marks that do not represent quotes; for example, it is inappropriate
+  to use the <code><a href=#the-q-element>q</a></code> element for marking up sarcastic
+  statements.<p>The use of <code><a href=#the-q-element>q</a></code> elements to mark up quotations is
+  entirely optional; using explicit quotation punctuation without
+  <code><a href=#the-q-element>q</a></code> elements is just as correct.<p>If a <code><a href=#the-q-element>q</a></code> element is contained (directly or indirectly)
   in a <a href=#paragraph>paragraph</a> that contains a single <code><a href=#the-cite-element>cite</a></code>
   element and has no other <code><a href=#the-q-element>q</a></code> element descendants, then,
   the title of the work given by that <code><a href=#the-cite-element>cite</a></code> element gives
@@ -9647,8 +9655,8 @@
    <p>Here is a simple example of the use of the <code><a href=#the-q-element>q</a></code>
    element:</p>
 
-   <pre>&lt;p&gt;The man said &lt;q&gt;"Things that are impossible just take
-longer"&lt;/q&gt;. I disagreed with him.&lt;/p&gt;</pre>
+   <pre>&lt;p&gt;The man said &lt;q&gt;Things that are impossible just take
+longer&lt;/q&gt;. I disagreed with him.&lt;/p&gt;</pre>
 
   </div><div class=example>
 
@@ -9656,9 +9664,9 @@
    <code><a href=#the-q-element>q</a></code> element, and an explicit citation outside:</p>
 
    <pre>&lt;p&gt;The W3C page &lt;cite&gt;About W3C&lt;/cite&gt; says the W3C's
-mission is &lt;q cite="http://www.w3.org/Consortium/"&gt;"To lead the
+mission is &lt;q cite="http://www.w3.org/Consortium/"&gt;To lead the
 World Wide Web to its full potential by developing protocols and
-guidelines that ensure long-term growth for the Web"&lt;/q&gt;. I
+guidelines that ensure long-term growth for the Web&lt;/q&gt;. I
 disagree with this mission.&lt;/p&gt;</pre>
 
   </div><div class=example>
@@ -9666,15 +9674,26 @@
    <p>In the following example, the quotation itself contains a
    quotation:</p>
 
-   <pre>&lt;p&gt;In &lt;cite&gt;Example One&lt;/cite&gt;, he writes &lt;q&gt;"The man
-said &lt;q&gt;'Things that are impossible just take longer'&lt;/q&gt;. I
-disagreed with him"&lt;/q&gt;. Well, I disagree even more!&lt;/p&gt;</pre>
+   <pre>&lt;p&gt;In &lt;cite&gt;Example One&lt;/cite&gt;, he writes &lt;q&gt;The man
+said &lt;q&gt;Things that are impossible just take longer&lt;/q&gt;. I
+disagreed with him&lt;/q&gt;. Well, I disagree even more!&lt;/p&gt;</pre>
 
   </div><div class=example>
 
-   <p>In the following example, there are no quotation marks:</p>
+   <p>In the following example, quotation marks are used instead of
+   the <code><a href=#the-q-element>q</a></code> element:</p>
 
-   <pre>&lt;p&gt;His best argument: &lt;q&gt;I disagree!&lt;/q&gt;&lt;/p&gt;</pre>
+   <pre>&lt;p&gt;His best argument was &#10077;I disagree&#10078;, which
+I thought was laughable.&lt;/p&gt;</pre>
+
+  </div><div class=example>
+
+   <p>In the following example, there is no quote &mdash; the
+   quotation marks are used to name a word. Use of the <code><a href=#the-q-element>q</a></code>
+   element in this case would be inappropriate.</p>
+
+   <pre>&lt;p&gt;The word "ineffable" could have been used to describe the disaster
+resulting from the campaign's mismanagement.&lt;/p&gt;</pre>
 
   </div><h4 id=the-cite-element><span class=secno>4.6.3 </span>The <dfn><code>cite</code></dfn> element</h4><dl class=element><dt>Categories</dt>
    <dd><a href=#phrasing-content-0>Phrasing content</a>.</dd>

Received on Sunday, 30 November 2008 08:32:57 UTC