[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