[html5] r1922 - [e] (0) tweaks to the typographical conventions section

[whatwg at whatwg.org]

Author: ianh
Date: 2008-07-23 16:47:48 -0700 (Wed, 23 Jul 2008)
New Revision: 1922

Modified:
   index
   source
Log:
[e] (0) tweaks to the typographical conventions section

Modified: index
===================================================================
--- index	2008-07-23 23:40:32 UTC (rev 1921)
+++ index	2008-07-23 23:47:48 UTC (rev 1922)
@@ -2287,13 +2287,22 @@
 
   <p class=example>This is an example.
 
-  <p class=big-isue>This is an open issue.
+  <p class=big-issue>This is an open issue.
 
   <p class=warning>This is a warning.
 
-  <p>Element names, attribute names, code fragments, and the like are marked
-   up like <code title="">this</code>.
+  <p>The defining instance of a term is marked up like <dfn id=this
+   title=x-this>this</dfn>. Uses of that term are marked up like <a
+   href="#this" title=x-this>this</a> or like <i title=x-this><a
+   href="#this">this</a></i>.
 
+  <p>The defining instance of an element, attribute, or API is marked up like
+   <dfn id=this0 title=x-that><code>this</code></dfn>. References to that
+   element, attribute, or API are marked up like <code title=x-that><a
+   href="#this0">this</a></code>.
+
+  <p>Other code fragments are marked up <code title="">like this</code>.
+
   <p>Variables are marked up like <var title="">this</var>.
 
   <pre class=idl>interface <dfn id=example title="">Example</dfn> {

Modified: source
===================================================================
--- source	2008-07-23 23:40:32 UTC (rev 1921)
+++ source	2008-07-23 23:47:48 UTC (rev 1922)
@@ -310,13 +310,23 @@
 
   <p class="example">This is an example.</p>
 
-  <p class="big-isue">This is an open issue.</p>
+  <p class="big-issue">This is an open issue.</p>
 
   <p class="warning">This is a warning.</p>
 
-  <p>Element names, attribute names, code fragments, and the like are
-  marked up like <code title="">this</code>.</p>
+  <p>The defining instance of a term is marked up like <dfn
+  title="x-this">this</dfn>. Uses of that term are marked up like
+  <span title="x-this">this</span> or like <i
+  title="x-this">this</i>.</p>
 
+  <p>The defining instance of an element, attribute, or API is marked
+  up like <dfn title="x-that"><code>this</code></dfn>. References to
+  that element, attribute, or API are marked up like <code
+  title="x-that">this</code>.</p>
+
+  <p>Other code fragments are marked up <code title="">like
+  this</code>.</p>
+
   <p>Variables are marked up like <var title="">this</var>.</p>
 
   <pre class="idl">interface <dfn title="">Example</dfn> {