[giow] (0) More tweaking of title='' conf critera.

Affected topics: HTML, Rendering

git-svn-id: http://svn.whatwg.org/webapps@7249 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

@@ -11346,11 +11346,11 @@ <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <code title=attr
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the
@@ -11387,7 +11387,8 @@ <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <code title=attr
 
   <p>The <dfn id=advisory-information>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol><li><p>If the element is a <code><a href=#the-link-element>link</a></code>, <code><a href=#the-style-element>style</a></code>,
    <code><a href=#the-dfn-element>dfn</a></code>, <code><a href=#the-abbr-element>abbr</a></code>, or <code><a href=#the-title-element>title</a></code> element,
@@ -11403,7 +11404,11 @@ <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <code title=attr
 
    <li><p>Otherwise, return the empty string.</li>
 
-  </ol><hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
+  </ol><p>User agents should inform the user when elements have
+  <a href=#advisory-information>advisory information</a>, otherwise the information would
+  not be discoverable.</p>
+
+  <hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
   must <a href=#reflect>reflect</a> the <code title=attr-title><a href=#attr-title>title</a></code>
   content attribute.</p>
 
@@ -25836,12 +25841,12 @@ <h6 id=a-key-part-of-the-content><span class=secno>4.8.1.1.10 </span>A key part
       present and has a non-empty value.</p>
 
       <!-- search for title-warning if modifying this paragraph -->
-      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -62076,7 +62081,8 @@ <h4 id=footnotes><span class=secno>4.13.5 </span>Footnotes</h4>
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 
-  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute should be used.</p>
+  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class=example>
 
@@ -62092,6 +62098,28 @@ <h4 id=footnotes><span class=secno>4.13.5 </span>Footnotes</h4>
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class=note>Unfortunately, relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class=note>If the <code title=attr-title><a href=#attr-title>title</a></code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class=example>
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title=attr-title><a href=#attr-title>title</a></code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
   used, pointing to an element later in the document. The convention
   is that the contents of the link be a number in square brackets.</p>
@@ -99105,7 +99133,8 @@ <h4 id=links,-forms,-and-navigation><span class=secno>14.7.1 </span>Links, forms
   <h4 id=the-title-attribute-0><span class=secno>14.7.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h4>
 
   <p>User agents are expected to expose the <a href=#advisory-information>advisory
-  information</a> of elements upon user request.</p>
+  information</a> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the

index

@@ -11346,11 +11346,11 @@ interface <dfn id=htmlunknownelement>HTMLUnknownElement</dfn> : <a href=#htmlele
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the
@@ -11387,7 +11387,8 @@ Transport Protocol"&gt;HTTP&lt;/abbr&gt; today.&lt;/p&gt;</pre> <!-- DO NOT REWR
 
   <p>The <dfn id=advisory-information>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol><li><p>If the element is a <code><a href=#the-link-element>link</a></code>, <code><a href=#the-style-element>style</a></code>,
    <code><a href=#the-dfn-element>dfn</a></code>, <code><a href=#the-abbr-element>abbr</a></code>, or <code><a href=#the-title-element>title</a></code> element,
@@ -11403,7 +11404,11 @@ Transport Protocol"&gt;HTTP&lt;/abbr&gt; today.&lt;/p&gt;</pre> <!-- DO NOT REWR
 
    <li><p>Otherwise, return the empty string.</li>
 
-  </ol><hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
+  </ol><p>User agents should inform the user when elements have
+  <a href=#advisory-information>advisory information</a>, otherwise the information would
+  not be discoverable.</p>
+
+  <hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
   must <a href=#reflect>reflect</a> the <code title=attr-title><a href=#attr-title>title</a></code>
   content attribute.</p>
 
@@ -25836,12 +25841,12 @@ of various sizes."&gt;</strong></pre>
       present and has a non-empty value.</p>
 
       <!-- search for title-warning if modifying this paragraph -->
-      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -62076,7 +62081,8 @@ fur
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 
-  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute should be used.</p>
+  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class=example>
 
@@ -62092,6 +62098,28 @@ closing for lunch&lt;/span&gt;.</pre>
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class=note>Unfortunately, relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class=note>If the <code title=attr-title><a href=#attr-title>title</a></code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class=example>
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title=attr-title><a href=#attr-title>title</a></code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
   used, pointing to an element later in the document. The convention
   is that the contents of the link be a number in square brackets.</p>
@@ -99105,7 +99133,8 @@ keygen { binding: <i title="">keygen</i>; }</pre>
   <h4 id=the-title-attribute-0><span class=secno>14.7.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h4>
 
   <p>User agents are expected to expose the <a href=#advisory-information>advisory
-  information</a> of elements upon user request.</p>
+  information</a> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the

source

@@ -11746,11 +11746,11 @@ interface <dfn>HTMLUnknownElement</dfn> : <span>HTMLElement</span> { };</pre>
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class="note">Relying on the <code title="attr-title">title</code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title="attr-title">title</code> attribute of the
@@ -11789,7 +11789,8 @@ Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></pre> <!-- DO NOT REWRAP THIS L
 
   <p>The <dfn>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol>
 
@@ -11810,6 +11811,10 @@ Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></pre> <!-- DO NOT REWRAP THIS L
 
   </ol>
 
+  <p>User agents should inform the user when elements have
+  <span>advisory information</span>, otherwise the information would
+  not be discoverable.</p>
+
   <hr>
 
   <p>The <dfn title="dom-title"><code>title</code></dfn> IDL attribute
@@ -27821,12 +27826,12 @@ of various sizes."></strong></pre>
 
       <!-- search for title-warning if modifying this paragraph -->
       <p class="note">Relying on the <code
-      title="attr-title">title</code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      title="attr-title">title</code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -72523,7 +72528,8 @@ fur
   <hr>
 
   <p>For short inline annotations, the <code
-  title="attr-title">title</code> attribute should be used.</p>
+  title="attr-title">title</code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class="example">
 
@@ -72540,6 +72546,29 @@ closing for lunch&lt;/span>.</pre>
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class="note">Unfortunately, relying on the <code
+  title="attr-title">title</code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class="note">If the <code title="attr-title">title</code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class="example">
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title="attr-title">title</code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr>
 
   <p>For longer annotations, the <code>a</code> element should be
@@ -115784,7 +115813,8 @@ keygen { binding: <i title="">keygen</i>; }</pre>
   <h4>The <code title="attr-title">title</code> attribute</h4>
 
   <p>User agents are expected to expose the <span>advisory
-  information</span> of elements upon user request.</p>
+  information</span> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the