[html5] r1466 - /

whatwg at whatwg.org whatwg at whatwg.org
Sat Apr 19 23:16:56 PDT 2008


Author: ianh
Date: 2008-04-19 23:16:55 -0700 (Sat, 19 Apr 2008)
New Revision: 1466

Modified:
   index
   source
Log:
[] (0) Remove the automatic cross-referencing for <dfn>.

Modified: index
===================================================================
--- index	2008-04-19 06:33:42 UTC (rev 1465)
+++ index	2008-04-20 06:16:55 UTC (rev 1466)
@@ -24,7 +24,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=working>Working Draft — 19 April 2008</h2>
+   <h2 class="no-num no-toc" id=working>Working Draft — 20 April 2008</h2>
 
    <p>You can take part in this work. <a
     href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -6564,7 +6564,7 @@
    represents a line break.
 
   <p>Some elements, such as <code><a href="#link">link</a></code> and
-   <code><a href="#dfn">dfn</a></code>, define additional semantics for the
+   <code><a href="#abbr">abbr</a></code>, define additional semantics for the
    <code title=attr-title><a href="#title">title</a></code> attribute beyond
    the semantics described above.
 
@@ -11125,10 +11125,10 @@
   </dl>
 
   <p>The <code><a href="#dfn">dfn</a></code> element represents the defining
-   instance of a term. The <a href="#paragraph">paragraph</a>, <a href="#dl"
-   title=dl>description list group</a>, or <a href="#sectioning0"
-   title="sectioning content">section</a> that contains the <code><a
-   href="#dfn">dfn</a></code> element contains the definition for the term
+   instance of a term. The <span title=paragraphs>paragraphs</span>, <a
+   href="#dl" title=dl>description list groups</a>, or <a href="#sectioning0"
+   title="sectioning content">sections</a> that contain the <code><a
+   href="#dfn">dfn</a></code> element contain the definition(s) for the term
    given by the contents of the <code><a href="#dfn">dfn</a></code> element.
 
   <p><dfn id=defining>Defining term</dfn>: If the <code><a
@@ -11156,48 +11156,30 @@
    attribute of ancestor elements does not affect <code><a
    href="#dfn">dfn</a></code> elements.
 
-  <p id=xrefs>The <code><a href="#dfn">dfn</a></code> element enables
-   automatic cross-references. Specifically, any <code><a
-   href="#span">span</a></code>, <code><a href="#abbr">abbr</a></code>,
-   <code><a href="#code">code</a></code>, <code><a
-   href="#var">var</a></code>, <code><a href="#samp">samp</a></code>, or
-   <code><a href="#i">i</a></code> element that has a non-empty <code
-   title=attr-title><a href="#title">title</a></code> attribute whose value
-   exactly equals the <a href="#defining" title="defining term">term</a> of a
-   <code><a href="#dfn">dfn</a></code> element in the same document, or which
-   has no <code title=attr-title><a href="#title">title</a></code> attribute
-   but whose <code><a href="#textcontent">textContent</a></code> exactly
-   equals the <a href="#defining" title="defining term">term</a> of a
-   <code><a href="#dfn">dfn</a></code> element in the document, and that has
-   no <span>interactive elements</span> or <code><a
-   href="#dfn">dfn</a></code> elements either as ancestors or descendants,
-   and has no other elements as ancestors that are themselves matching these
-   conditions, should be presented in such a way that the user can jump from
-   the element to the first <code><a href="#dfn">dfn</a></code> element
-   giving the defining instance of that term.</p>
-  <!-- XXX that means <dfn>x x</dfn> won't match <span>x \n x</span> -->
-  <!-- need to mention that <span> is useful for cross-refs that don't
-  actually use the term itself -->
+  <p>An <code><a href="#a">a</a></code> element that links to a <code><a
+   href="#dfn">dfn</a></code> element represents an instance of the term
+   defined by the <code><a href="#dfn">dfn</a></code> element.
 
   <div class=example>
    <p>In the following fragment, the term "GDO" is first defined in the first
-    paragraph, then used in the second. A compliant UA could provide a link
-    from the <code><a href="#abbr">abbr</a></code> element in the second
-    paragraph to the <code><a href="#dfn">dfn</a></code> element in the
-    first.</p>
+    paragraph, then used in the second.</p>
 
    <pre><p>The <dfn><abbr title="Garage Door Opener">GDO</abbr></dfn>
 is a device that allows off-world teams to open the iris.</p>
 <!-- ... later in the document: -->
 <p>Teal'c activated his <abbr title="Garage Door Opener">GDO</abbr>
 and so Hammond ordered the iris to be opened.</p></pre>
-   <!-- XXX need some examples of nesting where the top element makes
-   a crossref but the inner ones don't despite also matching the
-   algorithm above -->
-   <!-- XXX need some examples of duplicates being bad, of title
-   attributes being bad, etc -->
-   </div>
-  <!--
+
+   <p>With the addition of an <code><a href="#a">a</a></code> element, the
+    reference can be made explicit:</p>
+
+   <pre><p>The <dfn id=gdo><abbr title="Garage Door Opener">GDO</abbr></dfn>
+is a device that allows off-world teams to open the iris.</p>
+<!-- ... later in the document: -->
+<p>Teal'c activated his <a href=#gdo><abbr title="Garage Door Opener">GDO</abbr></a>
+and so Hammond ordered the iris to be opened.</p></pre>
+  </div>
+  <!--XXX
 > One useful line of retreat would be to specify that in the following
 > code, "the state of being happy" is unambiguously a definition of
 > "happiness" and not of any other subset of the <dt>.
@@ -11256,6 +11238,7 @@
 new technologies designed to allow authors to write and deploy
 Applications over the World Wide Web.</p></pre>
   </div>
+  <!-- XXX should we get rid of the following?: -->
 
   <p>The <code title=attr-abbr-title><a href="#title5">title</a></code>
    attribute may be omitted if there is a <code><a href="#dfn">dfn</a></code>
@@ -11270,7 +11253,7 @@
     href="#title5">title</a></code> attribute has been omitted. Because of
     the way <code><a href="#dfn">dfn</a></code> elements are defined, the
     second <code><a href="#abbr">abbr</a></code> element in this example
-    would be connected (in some UA-specific way) to the first.</p>
+    could be connected (in some UA-specific way) to the first.</p>
 
    <pre><p>The <dfn><abbr>Zat</abbr></dfn>, short for Zat'ni'catel, is a weapon.</p>
 <p>Jack used a <abbr>Zat</abbr> to make the boxes of evidence disappear.</p></pre>
@@ -12026,9 +12009,7 @@
 
    <dt>Element-specific attributes:
 
-   <dd>None, but the <code title=attr-title><a href="#title">title</a></code>
-    attribute has special semantics on this element when used with the
-    <code><a href="#dfn">dfn</a></code> element.
+   <dd>None.
 
    <dt>DOM interface:
 
@@ -12095,9 +12076,7 @@
 
    <dt>Element-specific attributes:
 
-   <dd>None, but the <code title=attr-title><a href="#title">title</a></code>
-    attribute has special semantics on this element when used with the
-    <code><a href="#dfn">dfn</a></code> element.
+   <dd>None.
 
    <dt>DOM interface:
 
@@ -12136,9 +12115,7 @@
 
    <dt>Element-specific attributes:
 
-   <dd>None, but the <code title=attr-title><a href="#title">title</a></code>
-    attribute has special semantics on this element when used with the
-    <code><a href="#dfn">dfn</a></code> element.
+   <dd>None.
 
    <dt>DOM interface:
 
@@ -12321,9 +12298,7 @@
 
    <dt>Element-specific attributes:
 
-   <dd>None, but the <code title=attr-title><a href="#title">title</a></code>
-    attribute has special semantics on this element when used with the
-    <code><a href="#dfn">dfn</a></code> element.
+   <dd>None.
 
    <dt>DOM interface:
 
@@ -12334,8 +12309,7 @@
    on its own, but can be useful when used together with other attributes,
    e.g. <code title=attr-class><a href="#class">class</a></code>, <code
    title=attr-lang><a href="#lang">lang</a></code>, or <code
-   title=attr-dir><a href="#dir">dir</a></code>, or when used in conjunction
-   with the <code><a href="#dfn">dfn</a></code> element.</p>
+   title=attr-dir><a href="#dir">dir</a></code>.</p>
   <!--XXXSPAN
   <p>The <code>span</code> element may be used to include a list
   inline in a paragraph. (When used in this way, the list can only
@@ -12368,9 +12342,7 @@
 
    <dt>Element-specific attributes:
 
-   <dd>None, but the <code title=attr-title><a href="#title">title</a></code>
-    attribute has special semantics on this element when used with the
-    <code><a href="#dfn">dfn</a></code> element.
+   <dd>None.
 
    <dt>DOM interface:
 

Modified: source
===================================================================
--- source	2008-04-19 06:33:42 UTC (rev 1465)
+++ source	2008-04-20 06:16:55 UTC (rev 1466)
@@ -5015,7 +5015,7 @@
   multiple lines. Each U+000A LINE FEED (LF) character represents a
   line break.</p>
 
-  <p>Some elements, such as <code>link</code> and <code>dfn</code>,
+  <p>Some elements, such as <code>link</code> and <code>abbr</code>,
   define additional semantics for the <code
   title="attr-title">title</code> attribute beyond the semantics
   described above.</p>
@@ -9259,10 +9259,10 @@
   </dl>
 
   <p>The <code>dfn</code> element represents the defining instance of
-  a term. The <span>paragraph</span>, <span title="dl">description
-  list group</span>, or <span title="sectioning
-  content">section</span> that contains the <code>dfn</code> element
-  contains the definition for the term given by the contents of the
+  a term. The <span title="paragraphs">paragraphs</span>, <span title="dl">description
+  list groups</span>, or <span title="sectioning
+  content">sections</span> that contain the <code>dfn</code> element
+  contain the definition(s) for the term given by the contents of the
   <code>dfn</code> element.</p>
 
   <p><dfn>Defining term</dfn>: If the <code>dfn</code> element has a
@@ -9289,34 +9289,14 @@
   <p class="note">The <code title="attr-title">title</code> attribute
   of ancestor elements does not affect <code>dfn</code> elements.</p>
 
-  <p id="xrefs">The <code>dfn</code> element enables automatic
-  cross-references.  Specifically, any <code>span</code>,
-  <code>abbr</code>, <code>code</code>, <code>var</code>,
-  <code>samp</code>, or <code>i</code> element that has a non-empty
-  <code title="attr-title">title</code> attribute whose value exactly
-  equals the <span title="defining term">term</span> of a
-  <code>dfn</code> element in the same document, or which has no <code
-  title="attr-title">title</code> attribute but whose
-  <code>textContent</code> exactly equals the <span title="defining
-  term">term</span> of a <code>dfn</code> element in the document, and
-  that has no <span>interactive elements</span> or <code>dfn</code>
-  elements either as ancestors or descendants, and has no other
-  elements as ancestors that are themselves matching these conditions,
-  should be presented in such a way that the user can jump from the
-  element to the first <code>dfn</code> element giving the defining
-  instance of that term.</p>
+  <p>An <code>a</code> element that links to a <code>dfn</code>
+  element represents an instance of the term defined by the
+  <code>dfn</code> element.</p>
 
-  <!-- XXX that means <dfn>x x</dfn> won't match <span>x \n x</span> -->
-
-  <!-- need to mention that <span> is useful for cross-refs that don't
-  actually use the term itself -->
-
   <div class="example">
 
    <p>In the following fragment, the term "GDO" is first defined in
-   the first paragraph, then used in the second. A compliant UA could
-   provide a link from the <code>abbr</code> element in the second
-   paragraph to the <code>dfn</code> element in the first.</p>
+   the first paragraph, then used in the second.</p>
 
    <pre><p>The <dfn><abbr title="Garage Door Opener">GDO</abbr></dfn>
 is a device that allows off-world teams to open the iris.</p>
@@ -9324,16 +9304,18 @@
 <p>Teal'c activated his <abbr title="Garage Door Opener">GDO</abbr>
 and so Hammond ordered the iris to be opened.</p></pre>
 
-   <!-- XXX need some examples of nesting where the top element makes
-   a crossref but the inner ones don't despite also matching the
-   algorithm above -->
+   <p>With the addition of an <code>a</code> element, the reference
+   can be made explicit:</p>
 
-   <!-- XXX need some examples of duplicates being bad, of title
-   attributes being bad, etc -->
+   <pre><p>The <dfn id=gdo><abbr title="Garage Door Opener">GDO</abbr></dfn>
+is a device that allows off-world teams to open the iris.</p>
+<!-- ... later in the document: -->
+<p>Teal'c activated his <a href=#gdo><abbr title="Garage Door Opener">GDO</abbr></a>
+and so Hammond ordered the iris to be opened.</p></pre>
 
   </div>
 
-<!--
+<!--XXX
 > One useful line of retreat would be to specify that in the following
 > code, "the state of being happy" is unambiguously a definition of
 > "happiness" and not of any other subset of the <dt>.
@@ -9382,6 +9364,8 @@
 Applications over the World Wide Web.</p></pre>
   </div>
 
+  <!-- XXX should we get rid of the following?: -->
+
   <p>The <code title="attr-abbr-title">title</code> attribute may be
   omitted if there is a <code>dfn</code> element in the document whose
   <span>defining term</span> is the abbreviation (the
@@ -9394,7 +9378,7 @@
    so the explanatory <code title="attr-abbr-title">title</code>
    attribute has been omitted. Because of the way <code>dfn</code>
    elements are defined, the second <code>abbr</code> element in this
-   example would be connected (in some UA-specific way) to the
+   example could be connected (in some UA-specific way) to the
    first.</p>
 
    <pre><p>The <dfn><abbr>Zat</abbr></dfn>, short for Zat'ni'catel, is a weapon.</p>
@@ -10126,7 +10110,7 @@
    <dt>Content model:</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dt>Element-specific attributes:</dt>
-   <dd>None, but the <code title="attr-title">title</code> attribute has special semantics on this element when used with the <code>dfn</code> element.</dd>
+   <dd>None.</dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>
@@ -10189,7 +10173,7 @@
    <dt>Content model:</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dt>Element-specific attributes:</dt>
-   <dd>None, but the <code title="attr-title">title</code> attribute has special semantics on this element when used with the <code>dfn</code> element.</dd>
+   <dd>None.</dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>
@@ -10218,7 +10202,7 @@
    <dt>Content model:</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dt>Element-specific attributes:</dt>
-   <dd>None, but the <code title="attr-title">title</code> attribute has special semantics on this element when used with the <code>dfn</code> element.</dd>
+   <dd>None.</dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>
@@ -10367,7 +10351,7 @@
    <dd><!--XXXSPAN Either: --><span>Phrasing content</span>.</dd>
 <!--XXXSPAN   <dd>Or: A single <code>ol</code> or <code>ul</code> element.</dd>-->
    <dt>Element-specific attributes:</dt>
-   <dd>None, but the <code title="attr-title">title</code> attribute has special semantics on this element when used with the <code>dfn</code> element.</dd>
+   <dd>None.</dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>
@@ -10375,8 +10359,8 @@
   <p>The <code>span</code> element doesn't mean anything on its own,
   but can be useful when used together with other attributes,
   e.g. <code title="attr-class">class</code>, <code
-  title="attr-lang">lang</code>, or <code title="attr-dir">dir</code>,
-  or when used in conjunction with the <code>dfn</code> element.</p>
+  title="attr-lang">lang</code>, or <code
+  title="attr-dir">dir</code>.</p>
 
 <!--XXXSPAN
   <p>The <code>span</code> element may be used to include a list
@@ -10403,7 +10387,7 @@
    <dt>Content model:</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dt>Element-specific attributes:</dt>
-   <dd>None, but the <code title="attr-title">title</code> attribute has special semantics on this element when used with the <code>dfn</code> element.</dd>
+   <dd>None.</dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>




More information about the Commit-Watchers mailing list