[html5] r8393 - [e] (0) Vaguely try to clarify 'status bar' and 'toolbar' for the mostly obsolet [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2014-01-13 15:42:06 -0800 (Mon, 13 Jan 2014)
New Revision: 8393

Modified:
   complete.html
   index
   source
Log:
[e] (0) Vaguely try to clarify 'status bar' and 'toolbar' for the mostly obsolete BarProp APIs.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=24277
Affected topics: DOM APIs

Modified: complete.html
===================================================================
--- complete.html	2014-01-13 23:30:16 UTC (rev 8392)
+++ complete.html	2014-01-13 23:42:06 UTC (rev 8393)
@@ -65679,14 +65679,19 @@
 
    <dt><dfn id=the-status-bar-barprop-object>The status bar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents a user interface element found immediately below or after the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides information about ongoing network
+   activity or information about elements that the user's pointing device is current indicating.
+   If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return false).</dd>
 
    <dt><dfn id=the-toolbar-barprop-object>The toolbar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents the user interface element found immediately above or before the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides <a href=#session-history>session history</a> traversal
+   controls (back and forward buttons, reload buttons, etc). If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return false).</dd>
 
   </dl><p>The <dfn id=dom-window-locationbar title=dom-window-locationbar><code>locationbar</code></dfn> attribute must return

Modified: index
===================================================================
--- index	2014-01-13 23:30:16 UTC (rev 8392)
+++ index	2014-01-13 23:42:06 UTC (rev 8393)
@@ -65679,14 +65679,19 @@
 
    <dt><dfn id=the-status-bar-barprop-object>The status bar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents a user interface element found immediately below or after the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides information about ongoing network
+   activity or information about elements that the user's pointing device is current indicating.
+   If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return false).</dd>
 
    <dt><dfn id=the-toolbar-barprop-object>The toolbar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents the user interface element found immediately above or before the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides <a href=#session-history>session history</a> traversal
+   controls (back and forward buttons, reload buttons, etc). If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return false).</dd>
 
   </dl><p>The <dfn id=dom-window-locationbar title=dom-window-locationbar><code>locationbar</code></dfn> attribute must return

Modified: source
===================================================================
--- source	2014-01-13 23:30:16 UTC (rev 8392)
+++ source	2014-01-13 23:42:06 UTC (rev 8393)
@@ -73163,15 +73163,20 @@
 
    <dt><dfn>The status bar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents a user interface element found immediately below or after the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides information about ongoing network
+   activity or information about elements that the user's pointing device is current indicating.
+   If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code
    data-x="dom-BarProp-visible">visible</code> attribute may return false).</dd>
 
    <dt><dfn>The toolbar <code>BarProp</code> object</dfn></dt>
 
+<!--CLEANUP-->
    <dd>Represents the user interface element found immediately above or before the document, as
-   appropriate for the user's media. If the user agent has no such user interface element, then the
+   appropriate for the user's media, which typically provides <span>session history</span> traversal
+   controls (back and forward buttons, reload buttons, etc). If the user agent has no such user interface element, then the
    object may act as if the corresponding user interface element was absent (i.e. its <code
    data-x="dom-BarProp-visible">visible</code> attribute may return false).</dd>