[html5] r2486 - [ac] (0) <q>: now with UA-inserted quotes. Again.
whatwg at whatwg.org
whatwg at whatwg.org
Sun Nov 30 00:32:41 PST 2008
Author: ianh
Date: 2008-11-30 00:32:40 -0800 (Sun, 30 Nov 2008)
New Revision: 2486
Modified:
index
source
Log:
[ac] (0) <q>: now with UA-inserted quotes. Again.
Modified: index
===================================================================
--- index 2008-11-30 07:13:36 UTC (rev 2485)
+++ index 2008-11-30 08:32:40 UTC (rev 2486)
@@ -11768,17 +11768,29 @@
</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>
- <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>
+ <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>
<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>
+ <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>
<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>
+ present, it must be a <a href=#valid-url>valid URL</a>. User agents should
+ allow users to follow such citation links.</p>
+ <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>
+
+ <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>
+
<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,
@@ -11791,8 +11803,8 @@
<p>Here is a simple example of the use of the <code><a href=#the-q-element>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>
+ <pre><p>The man said <q>Things that are impossible just take
+longer</q>. I disagreed with him.</p></pre>
</div>
@@ -11802,9 +11814,9 @@
<code><a href=#the-q-element>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
+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
+guidelines that ensure long-term growth for the Web</q>. I
disagree with this mission.</p></pre>
</div>
@@ -11814,21 +11826,34 @@
<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"</q>. Well, I disagree even more!</p></pre>
+ <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</q>. Well, I disagree even more!</p></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><p>His best argument: <q>I disagree!</q></p></pre>
+ <pre><p>His best argument was ❝I disagree❞, which
+I thought was laughable.</p></pre>
</div>
+ <div class=example>
+ <p>In the following example, there is no quote — 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><p>The word "ineffable" could have been used to describe the disaster
+resulting from the campaign's mismanagement.</p></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>
Modified: source
===================================================================
--- source 2008-11-30 07:13:36 UTC (rev 2485)
+++ source 2008-11-30 08:32:40 UTC (rev 2486)
@@ -12547,17 +12547,29 @@
<p>The <code>q</code> element represents some <span title="phrasing
content">phrasing content</span> 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>Quotation punctuation (such as quotation marks) must not appear
+ immediately before, after, or inside <code>q</code> elements; they
+ will be inserted into the rendering by the user agent.</p>
<p>Content inside a <code>q</code> element must be quoted from
another source, whose address, if it has one, should be cited in the
- <dfn title="attr-q-cite"><code>cite</code></dfn> attribute.</p>
+ <dfn title="attr-q-cite"><code>cite</code></dfn> attribute. The
+ source may be fictional, as when quoting characters in a novel or
+ screenplay.</p>
<p>If the <code title="attr-q-cite">cite</code> attribute is
- present, it must be a <span>valid URL</span>. User agents should allow
- users to follow such citation links.</p>
+ present, it must be a <span>valid URL</span>. User agents should
+ allow users to follow such citation links.</p>
+ <p>The <code>q</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>q</code> element for marking up sarcastic
+ statements.</p>
+
+ <p>The use of <code>q</code> elements to mark up quotations is
+ entirely optional; using explicit quotation punctuation without
+ <code>q</code> elements is just as correct.</p>
+
<p>If a <code>q</code> element is contained (directly or indirectly)
in a <span>paragraph</span> that contains a single <code>cite</code>
element and has no other <code>q</code> element descendants, then,
@@ -12570,8 +12582,8 @@
<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>
+ <pre><p>The man said <q>Things that are impossible just take
+longer</q>. I disagreed with him.</p></pre>
</div>
@@ -12581,9 +12593,9 @@
<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
+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
+guidelines that ensure long-term growth for the Web</q>. I
disagree with this mission.</p></pre>
</div>
@@ -12593,21 +12605,34 @@
<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"</q>. Well, I disagree even more!</p></pre>
+ <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</q>. Well, I disagree even more!</p></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>q</code> element:</p>
- <pre><p>His best argument: <q>I disagree!</q></p></pre>
+ <pre><p>His best argument was ❝I disagree❞, which
+I thought was laughable.</p></pre>
</div>
+ <div class="example">
+ <p>In the following example, there is no quote — the
+ quotation marks are used to name a word. Use of the <code>q</code>
+ element in this case would be inappropriate.</p>
+
+ <pre><p>The word "ineffable" could have been used to describe the disaster
+resulting from the campaign's mismanagement.</p></pre>
+
+ </div>
+
+
<h4>The <dfn><code>cite</code></dfn> element</h4>
<dl class="element">
More information about the Commit-Watchers
mailing list