Permalink
Browse files

[ac] (0) <q>: now with UA-inserted quotes. Again.

git-svn-id: http://svn.whatwg.org/webapps@2486 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent 5f85452 commit 1ce5300ecb0d342584dd55a5a6f6e6e168077bfb @Hixie Hixie committed Nov 30, 2008
Showing with 78 additions and 28 deletions.
  1. +39 −14 index
  2. +39 −14 source
View
53 index
@@ -11768,16 +11768,28 @@ first matching case):&lt;/p&gt;
</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>
@@ -11791,8 +11803,8 @@ first matching case):&lt;/p&gt;
<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>
@@ -11802,9 +11814,9 @@ longer"&lt;/q&gt;. I disagreed with him.&lt;/p&gt;</pre>
<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>
@@ -11814,17 +11826,30 @@ disagree with this mission.&lt;/p&gt;</pre>
<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, 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 was &#10077;I disagree&#10078;, which
+I thought was laughable.&lt;/p&gt;</pre>
</div>
<div class=example>
- <p>In the following example, there are no quotation marks:</p>
+ <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;His best argument: &lt;q&gt;I disagree!&lt;/q&gt;&lt;/p&gt;</pre>
+ <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>
View
53 source
@@ -12547,16 +12547,28 @@ first matching case):&lt;/p&gt;
<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>
@@ -12570,8 +12582,8 @@ first matching case):&lt;/p&gt;
<p>Here is a simple example of the use of the <code>q</code>
element:</p>
- <pre>&lt;p>The man said &lt;q>"Things that are impossible just take
-longer"&lt;/q>. I disagreed with him.&lt;/p></pre>
+ <pre>&lt;p>The man said &lt;q>Things that are impossible just take
+longer&lt;/q>. I disagreed with him.&lt;/p></pre>
</div>
@@ -12581,9 +12593,9 @@ longer"&lt;/q>. I disagreed with him.&lt;/p></pre>
<code>q</code> element, and an explicit citation outside:</p>
<pre>&lt;p>The W3C page &lt;cite>About W3C&lt;/cite> says the W3C's
-mission is &lt;q cite="http://www.w3.org/Consortium/">"To lead the
+mission is &lt;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"&lt;/q>. I
+guidelines that ensure long-term growth for the Web&lt;/q>. I
disagree with this mission.&lt;/p></pre>
</div>
@@ -12593,17 +12605,30 @@ disagree with this mission.&lt;/p></pre>
<p>In the following example, the quotation itself contains a
quotation:</p>
- <pre>&lt;p>In &lt;cite>Example One&lt;/cite>, he writes &lt;q>"The man
-said &lt;q>'Things that are impossible just take longer'&lt;/q>. I
-disagreed with him"&lt;/q>. Well, I disagree even more!&lt;/p></pre>
+ <pre>&lt;p>In &lt;cite>Example One&lt;/cite>, he writes &lt;q>The man
+said &lt;q>Things that are impossible just take longer&lt;/q>. I
+disagreed with him&lt;/q>. Well, I disagree even more!&lt;/p></pre>
+
+ </div>
+
+ <div class="example">
+
+ <p>In the following example, quotation marks are used instead of
+ the <code>q</code> element:</p>
+
+ <pre>&lt;p>His best argument was &#x275D;I disagree&#x275E;, which
+I thought was laughable.&lt;/p></pre>
</div>
<div class="example">
- <p>In the following example, there are no quotation marks:</p>
+ <p>In the following example, there is no quote &mdash; the
+ quotation marks are used to name a word. Use of the <code>q</code>
+ element in this case would be inappropriate.</p>
- <pre>&lt;p>His best argument: &lt;q>I disagree!&lt;/q>&lt;/p></pre>
+ <pre>&lt;p>The word "ineffable" could have been used to describe the disaster
+resulting from the campaign's mismanagement.&lt;/p></pre>
</div>

0 comments on commit 1ce5300

Please sign in to comment.