W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2011

html5/spec-author-view Overview.html,1.1696,1.1697 browsers.html,1.1188,1.1189 editing.html,1.1159,1.1160 spec.html,1.1826,1.1827 spec.preprocessed.html,1.678,1.679

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 27 Oct 2011 21:57:12 +0000
To: public-html-commits@w3.org
Message-Id: <E1RJXwn-0008E4-38@lionel-hutz.w3.org>
Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv31453

Modified Files:
	Overview.html browsers.html editing.html spec.html 
	spec.preprocessed.html 
Log Message:
Tweak definition to heycam's wording. (whatwg r6774)

[updated by splitter]


Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/Overview.html,v
retrieving revision 1.1696
retrieving revision 1.1697
diff -u -d -r1.1696 -r1.1697
--- Overview.html	27 Oct 2011 20:57:54 -0000	1.1696
+++ Overview.html	27 Oct 2011 21:57:05 -0000	1.1697
@@ -169,7 +169,7 @@
     <dt>Editor:</dt>
     <dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
    </dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
-      This is revision 1.5421.</p> 
+      This is revision 1.5423.</p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &copy; 2011 <a href="http://www.w3.org/"><abbr title="World Wide
    Web Consortium">W3C</abbr></a><sup>&reg;</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts

Index: browsers.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/browsers.html,v
retrieving revision 1.1188
retrieving revision 1.1189
diff -u -d -r1.1188 -r1.1189
--- browsers.html	27 Oct 2011 20:57:54 -0000	1.1188
+++ browsers.html	27 Oct 2011 21:57:05 -0000	1.1189
@@ -584,9 +584,6 @@
   [TreatNonCallableAsNull] attribute <a href="webappapis.html#function" id="function_210">Function</a>? <a href="index.html#ix-handler-window-onunload" title="handler-window-onunload">onunload</a>;
   [TreatNonCallableAsNull] attribute <a href="webappapis.html#function" id="function_211">Function</a>? <a href="index.html#ix-handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
   [TreatNonCallableAsNull] attribute <a href="webappapis.html#function" id="function_212">Function</a>? <a href="index.html#ix-handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
-
-  // legacy "interfaces"
-  readonly attribute object <a class="full-spec-link" href="http://dev.w3.org/html5/spec/browsers.html#htmldocument" title='Read about this "HTMLDocument" reference in the full HTML5 spec.'>HTMLDocument</a>;
 };</pre><dl class="domintro"><dt><var title="">window</var> . <code id="dom-window" title="dom-window"><a href="#dom-window">window</a></code></dt>
    <dt><var title="">window</var> . <code id="dom-frames" title="dom-frames"><a href="#dom-frames">frames</a></code></dt>
    <dt><var title="">window</var> . <code id="dom-self" title="dom-self"><a href="#dom-self">self</a></code></dt>

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.1826
retrieving revision 1.1827
diff -u -d -r1.1826 -r1.1827
--- spec.html	27 Oct 2011 20:58:05 -0000	1.1826
+++ spec.html	27 Oct 2011 21:57:05 -0000	1.1827
@@ -170,7 +170,7 @@
     <dt>Editor:</dt>
     <dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
    </dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
-      This is revision 1.5421.</p> 
+      This is revision 1.5423.</p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    © 2011 <a href="http://www.w3.org/"><abbr title="World Wide
    Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
@@ -23061,9 +23061,6 @@
   [TreatNonCallableAsNull] attribute <a href="#function" id="function_210">Function</a>? <a href="#ix-handler-window-onunload" title="handler-window-onunload">onunload</a>;
   [TreatNonCallableAsNull] attribute <a href="#function" id="function_211">Function</a>? <a href="#ix-handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
   [TreatNonCallableAsNull] attribute <a href="#function" id="function_212">Function</a>? <a href="#ix-handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
-
-  // legacy "interfaces"
-  readonly attribute object <a href="http://dev.w3.org/html5/spec/browsers.html#htmldocument" title='Read about this "HTMLDocument" reference in the full HTML5 spec.' class="full-spec-link">HTMLDocument</a>;
 };</pre><dl class="domintro"><dt><var title="">window</var> . <code id="dom-window" title="dom-window"><a href="#dom-window">window</a></code></dt>
    <dt><var title="">window</var> . <code id="dom-frames" title="dom-frames"><a href="#dom-frames">frames</a></code></dt>
    <dt><var title="">window</var> . <code id="dom-self" title="dom-self"><a href="#dom-self">self</a></code></dt>
@@ -24809,7 +24806,45 @@
   or digit.</p><p>User agents can provide users with a list of the keyboard
   shortcuts, but authors are encouraged to do so also. The <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute
   returns a string representing the actual key combination assigned by
-  the user agent.</p><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn aria-haspopup="true" role="button" tabindex="0"><code>accesskey</code></dfn> attribute</h4><p>All <a href="#html-elements" id="html-elements_35">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_3">accesskey</a></code> content attribute set. The
+  the user agent.</p><div class="example">
+
+   <p>In this example, an author has provided a button that can be
+   invoked using a shortcut key. To support full keyboards, the author
+   has provided "C" as a possible key. To support devices equipped
+   only with numeric keypads, the author has provided "1" as another
+   possibly key.</p>
+
+   <pre>&lt;input type=button value=Collect onclick="collect()"
+       <strong>accesskey="C 1"</strong> id=c&gt;</pre>
+
+  </div><div class="example">
+
+   <p>To tell the user what the shortcut key is, the author has 
+   this script here opted to explicitly add the key combination to the
+   button's label:</p>
+
+   <pre>function addShortcutKeyLabel(button) {
+<strong>  if (button.accessKeyLabel != '')
+    button.value += ' (' + button.accessKeyLabel + ')';</strong>
+}
+addShortcutKeyLabel(document.getElementById('c'));</pre>
+
+   <p>Browsers on different platforms will show different labels, even
+   for the same key combination, based on the convention prevalent on
+   that platform. For example, if the key combination is the Control
+   key, the Shift key, and the letter C, a Windows browser might
+   display "<samp>Ctrl+Shift+C</samp>", whereas a Mac browser might
+   display "<samp>^⇧C</samp>", while an Emacs browser might
+   just display "<samp>C-C</samp>". Similarly, if the key combination
+   is the Alt key and the Escape key, Windows might use
+   "<samp>Alt+Esc</samp>", Mac might use
+   "<samp>⌥⎋</samp>", and an Emacs browser might use
+   "<samp>M-ESC</samp>" or "<samp>ESC ESC</samp>".</p>
+
+   <p>In general, therefore, it is unwise to attempt to parse the
+   value returned from the <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute.</p>
+
+  </div><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn aria-haspopup="true" role="button" tabindex="0"><code>accesskey</code></dfn> attribute</h4><p>All <a href="#html-elements" id="html-elements_35">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_3">accesskey</a></code> content attribute set. The
   <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_4">accesskey</a></code> attribute's value is
   used by the user agent as a guide for creating a keyboard shortcut
   that activates or focuses the element.</p><p>If specified, the value must be an <a href="#ordered-set-of-unique-space-separated-tokens" id="ordered-set-of-unique-space-separated-tokens_1">ordered set of unique

Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/editing.html,v
retrieving revision 1.1159
retrieving revision 1.1160
diff -u -d -r1.1159 -r1.1160
--- editing.html	24 Oct 2011 17:57:05 -0000	1.1159
+++ editing.html	27 Oct 2011 21:57:05 -0000	1.1160
@@ -313,7 +313,45 @@
   or digit.<p>User agents can provide users with a list of the keyboard
   shortcuts, but authors are encouraged to do so also. The <code title="dom-accessKeyLabel"><a href="commands.html#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute
   returns a string representing the actual key combination assigned by
-  the user agent.<h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn aria-haspopup="true" role="button" tabindex="0"><code>accesskey</code></dfn> attribute</h4><p>All <a href="infrastructure.html#html-elements" id="html-elements_35">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_3">accesskey</a></code> content attribute set. The
+  the user agent.<div class="example">
+
+   <p>In this example, an author has provided a button that can be
+   invoked using a shortcut key. To support full keyboards, the author
+   has provided "C" as a possible key. To support devices equipped
+   only with numeric keypads, the author has provided "1" as another
+   possibly key.</p>
+
+   <pre>&lt;input type=button value=Collect onclick="collect()"
+       <strong>accesskey="C 1"</strong> id=c&gt;</pre>
+
+  </div><div class="example">
+
+   <p>To tell the user what the shortcut key is, the author has 
+   this script here opted to explicitly add the key combination to the
+   button's label:</p>
+
+   <pre>function addShortcutKeyLabel(button) {
+<strong>  if (button.accessKeyLabel != '')
+    button.value += ' (' + button.accessKeyLabel + ')';</strong>
+}
+addShortcutKeyLabel(document.getElementById('c'));</pre>
+
+   <p>Browsers on different platforms will show different labels, even
+   for the same key combination, based on the convention prevalent on
+   that platform. For example, if the key combination is the Control
+   key, the Shift key, and the letter C, a Windows browser might
+   display "<samp>Ctrl+Shift+C</samp>", whereas a Mac browser might
+   display "<samp>^&#8679;C</samp>", while an Emacs browser might
+   just display "<samp>C-C</samp>". Similarly, if the key combination
+   is the Alt key and the Escape key, Windows might use
+   "<samp>Alt+Esc</samp>", Mac might use
+   "<samp>&#8997;&#9099;</samp>", and an Emacs browser might use
+   "<samp>M-ESC</samp>" or "<samp>ESC ESC</samp>".</p>
+
+   <p>In general, therefore, it is unwise to attempt to parse the
+   value returned from the <code title="dom-accessKeyLabel"><a href="commands.html#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute.</p>
+
+  </div><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn aria-haspopup="true" role="button" tabindex="0"><code>accesskey</code></dfn> attribute</h4><p>All <a href="infrastructure.html#html-elements" id="html-elements_35">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_3">accesskey</a></code> content attribute set. The
   <code title="attr-accesskey"><a href="#the-accesskey-attribute" id="accesskey_4">accesskey</a></code> attribute's value is
   used by the user agent as a guide for creating a keyboard shortcut
   that activates or focuses the element.<p>If specified, the value must be an <a href="common-microsyntaxes.html#ordered-set-of-unique-space-separated-tokens" id="ordered-set-of-unique-space-separated-tokens_1">ordered set of unique

Index: spec.preprocessed.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.preprocessed.html,v
retrieving revision 1.678
retrieving revision 1.679
diff -u -d -r1.678 -r1.679
--- spec.preprocessed.html	27 Oct 2011 20:58:13 -0000	1.678
+++ spec.preprocessed.html	27 Oct 2011 21:57:10 -0000	1.679
@@ -183,7 +183,7 @@
     <dt>Editor:</dt>
     <dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
    </dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
-      This is revision 1.5421.</p> 
+      This is revision 1.5423.</p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2011 <a href="http://www.w3.org/"><abbr title="World Wide
    Web Consortium">W3C</abbr></a><sup>&#174;</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
@@ -22927,9 +22927,6 @@
   [TreatNonCallableAsNull] attribute <a href="#function">Function</a>? <a href="#ix-handler-window-onunload" title="handler-window-onunload">onunload</a>;
   [TreatNonCallableAsNull] attribute <a href="#function">Function</a>? <a href="#ix-handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
   [TreatNonCallableAsNull] attribute <a href="#function">Function</a>? <a href="#ix-handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
-
-  // legacy "interfaces"
-  readonly attribute object <a href="#htmldocument" title="HTMLDocument">HTMLDocument</a>;
 };</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window" id="dom-window"><a href="#dom-window">window</a></code></dt>
    <dt><var title="">window</var> . <code title="dom-frames" id="dom-frames"><a href="#dom-frames">frames</a></code></dt>
    <dt><var title="">window</var> . <code title="dom-self" id="dom-self"><a href="#dom-self">self</a></code></dt>
@@ -24689,7 +24686,45 @@
   or digit.</p><p>User agents can provide users with a list of the keyboard
   shortcuts, but authors are encouraged to do so also. The <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute
   returns a string representing the actual key combination assigned by
-  the user agent.</p><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn role="button" tabindex="0" aria-haspopup="true"><code>accesskey</code></dfn> attribute</h4><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute set. The
+  the user agent.</p><div class="example">
+
+   <p>In this example, an author has provided a button that can be
+   invoked using a shortcut key. To support full keyboards, the author
+   has provided "C" as a possible key. To support devices equipped
+   only with numeric keypads, the author has provided "1" as another
+   possibly key.</p>
+
+   <pre>&lt;input type=button value=Collect onclick="collect()"
+       <strong>accesskey="C 1"</strong> id=c&gt;</pre>
+
+  </div><div class="example">
+
+   <p>To tell the user what the shortcut key is, the author has 
+   this script here opted to explicitly add the key combination to the
+   button's label:</p>
+
+   <pre>function addShortcutKeyLabel(button) {
+<strong>  if (button.accessKeyLabel != '')
+    button.value += ' (' + button.accessKeyLabel + ')';</strong>
+}
+addShortcutKeyLabel(document.getElementById('c'));</pre>
+
+   <p>Browsers on different platforms will show different labels, even
+   for the same key combination, based on the convention prevalent on
+   that platform. For example, if the key combination is the Control
+   key, the Shift key, and the letter C, a Windows browser might
+   display "<samp>Ctrl+Shift+C</samp>", whereas a Mac browser might
+   display "<samp>^&#8679;C</samp>", while an Emacs browser might
+   just display "<samp>C-C</samp>". Similarly, if the key combination
+   is the Alt key and the Escape key, Windows might use
+   "<samp>Alt+Esc</samp>", Mac might use
+   "<samp>&#8997;&#9099;</samp>", and an Emacs browser might use
+   "<samp>M-ESC</samp>" or "<samp>ESC ESC</samp>".</p>
+
+   <p>In general, therefore, it is unwise to attempt to parse the
+   value returned from the <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute.</p>
+
+  </div><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn role="button" tabindex="0" aria-haspopup="true"><code>accesskey</code></dfn> attribute</h4><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute set. The
   <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute's value is
   used by the user agent as a guide for creating a keyboard shortcut
   that activates or focuses the element.</p><p>If specified, the value must be an <a href="#ordered-set-of-unique-space-separated-tokens">ordered set of unique
Received on Thursday, 27 October 2011 21:57:20 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 27 October 2011 21:57:21 GMT