Merge b2ee703 from WHATWG. Addresses remaining PFWG comment.
authorEdward O'Connor <eoconnor@apple.com>
Mon, 19 Jan 2015 13:01:57 -0800
changeset 43 e89ddc23c6e1
parent 40 951a6f33b7b0
child 44 044187e76fc8
Merge b2ee703 from WHATWG. Addresses remaining PFWG comment.
Overview.html
Overview.src.html
--- a/Overview.html	Fri May 09 15:31:52 2014 -0700
+++ b/Overview.html	Mon Jan 19 13:01:57 2015 -0800
@@ -47,7 +47,7 @@
 <!--end-logo-->
 
 <h1>Web Notifications</h1>
-<h2 class="no-num no-toc" id="editor's-draft-9-may-2014">Editor's Draft 9 May 2014</h2>
+<h2 class="no-num no-toc" id="editor's-draft-19-january-2015">Editor's Draft 19 January 2015</h2>
 
 <dl>
  <dt>This Version:
@@ -75,7 +75,7 @@
 
 
 <!--begin-copyright-->
-<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2014 <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 Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
+<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2015 <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 Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
 <!--end-copyright-->
 
 </div>
@@ -96,7 +96,7 @@
 found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a>
 at http://www.w3.org/TR/.</em>
 
-<p>This is the 9 May 2014 Editor's Draft of Web Notifications.
+<p>This is the 19 January 2015 Editor's Draft of Web Notifications.
 Please send comments to
 <a href="mailto:public-web-notification@w3.org">public-web-notification@w3.org</a>
 (<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
@@ -255,6 +255,9 @@
 have an associated <dfn id="body">body</dfn>, <dfn id="tag">tag</dfn>, <dfn id="icon-url">icon URL</dfn>, and
 <dfn id="icon-image">icon image</dfn>.
 
+<p class="note">Developers are encouraged to not convey information
+through an icon, sound, or vibration pattern that is not otherwise
+accessible to the end user.
 
 <h3 id="direction-0"><span class="secno">4.1 </span>Direction</h3>
 
@@ -331,10 +334,10 @@
 <ol>
  <li><p>If <a href="#permission-0">permission</a> for <var title="">notification</var>'s
  <a href="#origin">origin</a> is not "<code title="">granted</code>", cancel any ongoing
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch">fetch</a> for
+ <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch">fetch</a> for
  <var title="">notification</var>'s <a href="#icon-url">icon URL</a>,
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
- <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">queue a task</a> to
+ <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
  named <code title="">error</code> on <var title="">notification</var>, and
  terminate these steps.
 
@@ -363,14 +366,14 @@
 <var title="">notification</var> is activated by the user, assuming the underlying
 notification platform supports activation, the user agent must, for each
 <code><a href="#notification">Notification</a></code> object representing <var title="">notification</var>,
-<a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
-<a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+<a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">queue a task</a> to
+<a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
 named <code title="">click</code> on the <code><a href="#notification">Notification</a></code> object.
 
 <p class="note">Throughout the web platform "activate" is intentionally misnamed as "click".
 
 <p class="note">User agents are strongly encouraged to make
-<code class="external" title="dom-window-focus"><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/editing.html#dom-window-focus">window.focus()</a></code> work from within
+<code class="external" title="dom-window-focus"><a href="https://html.spec.whatwg.org/multipage/interaction.html#dom-window-focus">window.focus()</a></code> work from within
 the event listener for the event named <code title="">click</code> as a means of focusing the
 browsing context related to the notification.
 
@@ -387,11 +390,11 @@
  <a href="#list-of-pending-notifications">list of pending notifications</a> nor in the
  <a href="#list-of-active-notifications">list of active notifications</a>, terminate these steps.
 
- <li><p><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">Queue a task</a> to remove
+ <li><p><a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">Queue a task</a> to remove
  <var title="">notification</var> from either the
  <a href="#list-of-pending-notifications">list of pending notifications</a> or the
  <a href="#list-of-active-notifications">list of active notifications</a>, and
- <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
  named <code title="">close</code> on <var title="">notification</var>.
 </ol>
 
@@ -417,17 +420,17 @@
  <li>
   <p>If the notification platform supports icons,
   <var title="">notification</var>'s <a href="#icon-url">icon URL</a> is set and has not
-  yet been <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetched</a>,
-  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch">fetch</a> it and wait for the resource to
+  yet been <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch" title="fetch">fetched</a>,
+  <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch">fetch</a> it and wait for the resource to
   be fully downloaded.
 
-  <p>Once <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetching</a> has
+  <p>Once <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch" title="fetch">fetching</a> has
   finished and the image format is supported, set
   <var title="">notification</var>'s <a href="#icon-image">icon image</a> to the decoded resource.
   (Otherwise <var title="">notification</var> has no <a href="#icon-image">icon image</a>.)
 
  <li>
-  <p><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">Queue a task</a> to run these substeps:
+  <p><a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">Queue a task</a> to run these substeps:
 
   <ol>
    <li><p>Display <var title="">notification</var> on the device (e.g. by
@@ -435,14 +438,14 @@
 
    <li><p>If displaying fails (e.g. the notification platform returns an
    error),
-   <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+   <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
    named <code title="">error</code> on <var title="">notification</var> and
    terminate these steps.
 
    <li><p>Append <var title="">notification</var> to the
    <a href="#list-of-active-notifications">list of active notifications</a>.
 
-   <li><p><a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">Fire an event</a>
+   <li><p><a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">Fire an event</a>
    named <code title="">show</code> on <var title="">notification</var>.
   </ol>
 </ol>
@@ -458,31 +461,31 @@
  <li>
   <p>If the notification platform supports icons,
   <var title="">new</var>'s <a href="#icon-url">icon URL</a> is set and has not
-  yet been <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetched</a>,
-  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch">fetch</a> it and wait for the resource to
+  yet been <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch" title="fetch">fetched</a>,
+  <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch">fetch</a> it and wait for the resource to
   be fully downloaded.
 
-  <p>Once <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetching</a> has
+  <p>Once <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch" title="fetch">fetching</a> has
   finished and the image format is supported, set
   <var title="">new</var>'s <a href="#icon-image">icon image</a> to the decoded resource.
   (Otherwise <var title="">new</var> has no <a href="#icon-image">icon image</a>.)
 
  <li><p>If <var title="">old</var> is in the
  <a href="#list-of-pending-notifications">list of pending notifications</a>,
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to replace
+ <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">queue a task</a> to replace
  <var title="">old</var> with <var title="">new</var>, in the same position, in
  the <a href="#list-of-pending-notifications">list of pending notifications</a>, and
- <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
  named <code title="">close</code> on <var title="">old</var>.
 
  <li>
   <p>Otherwise,
-  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to replace
+  <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">queue a task</a> to replace
   <var title="">old</var> with <var title="">new</var>, in the same position, in
   the <a href="#list-of-active-notifications">list of active notifications</a>,
-  <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+  <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
   named <code title="">close</code> on <var title="">old</var>, and
-  <a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+  <a class="external" href="https://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
   named <code title="">show</code> on <var title="">new</var>.
 
   <p>If the notification platform does not support replacement this
@@ -503,14 +506,14 @@
 <a href="#dom-notification" title="dom-Notification">constructor</a>.
 
 <pre class="idl">[<a href="#dom-notification" title="dom-Notification">Constructor</a>(DOMString <var title="">title</var>, optional <a href="#notificationoptions">NotificationOptions</a> <var title="">options</var>)]
-interface <dfn id="notification">Notification</dfn> : <a class="external" href="http://dom.spec.whatwg.org/#eventtarget">EventTarget</a> {
+interface <dfn id="notification">Notification</dfn> : <a class="external" href="https://dom.spec.whatwg.org/#eventtarget">EventTarget</a> {
   static readonly attribute <a href="#notificationpermission">NotificationPermission</a> <a href="#dom-notification-permission" title="dom-Notification-permission">permission</a>;
   static void <a href="#dom-notification-requestpermission" title="dom-Notification-requestPermission">requestPermission</a>(optional <a href="#notificationpermissioncallback">NotificationPermissionCallback</a> <var title="">callback</var>);
 
-  attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onclick" title="handler-onclick">onclick</a>;
-  attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onshow" title="handler-onshow">onshow</a>;
-  attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onerror" title="handler-onerror">onerror</a>;
-  attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onclose" title="handler-onclose">onclose</a>;
+  attribute <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onclick" title="handler-onclick">onclick</a>;
+  attribute <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onshow" title="handler-onshow">onshow</a>;
+  attribute <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onerror" title="handler-onerror">onerror</a>;
+  attribute <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onclose" title="handler-onclose">onclose</a>;
 
   readonly attribute DOMString <a href="#dom-notification-title" title="dom-Notification-title">title</a>;
   readonly attribute <a href="#notificationdirection">NotificationDirection</a> <a href="#dom-notification-dir" title="dom-Notification-dir">dir</a>;
@@ -576,9 +579,9 @@
  <var title="">notification</var>'s <a href="#tag">tag</a> to <code title="">tag</code>.
 
  <li><p>If <var title="">options</var>'s <code title="">icon</code> is present,
- <a class="external" href="http://url.spec.whatwg.org/#concept-url-parser" title="concept-url-parser">parse</a>
- <code title="">icon</code> using the <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#api-base-url">API base URL</a>
- specified by the <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#entry-settings-object">entry settings object</a>, and if that
+ <a class="external" href="https://url.spec.whatwg.org/#concept-url-parser" title="concept-url-parser">parse</a>
+ <code title="">icon</code> using the <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#api-base-url">API base URL</a>
+ specified by the <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#entry-settings-object">entry settings object</a>, and if that
  does not return failure, set <var title="">notification</var>'s <a href="#icon-url">icon URL</a> to the
  return value. (Otherwise <a href="#icon-url">icon URL</a> is not set.)
 
@@ -586,7 +589,7 @@
  steps asynchronouusly.
 
  <li><p>If the notification platform supports icons, the user agent may
- start <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetching</a>
+ start <a class="external" href="https://html.spec.whatwg.org/multipage/infrastructure.html#fetch" title="fetch">fetching</a>
  <var title="">notification</var>'s <a href="#icon-url">icon URL</a> at this point, if
  <a href="#icon-url">icon URL</a> is set.
 
@@ -612,7 +615,7 @@
  <var title="">permission</var> to "<code title="">granted</code>", or
  "<code title="">denied</code>" otherwise.
 
- <li><p><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">Queue a task</a> to set
+ <li><p><a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">Queue a task</a> to set
  <a href="#permission-0">permission</a> to <var title="">permission</var> and invoke
  <var title="">callback</var> with <var title="">permission</var> as single
  argument if <var title="">callback</var> is given.
@@ -623,16 +626,16 @@
 for other APIs should not use this pattern and instead employ one of the
 <a href="http://robert.ocallahan.org/2011/06/permissions-for-web-applications_30.html">many more suitable alternatives</a>.
 
-<p>The following are the <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#event-handlers">event handlers</a>
+<p>The following are the <a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#event-handlers">event handlers</a>
 (and their corresponding
-<a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#event-handler-event-type" title="event handler event type">event handler event types</a>)
+<a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#event-handler-event-type" title="event handler event type">event handler event types</a>)
 that must be supported as attributes by the <code><a href="#notification">Notification</a></code> object.
 
 <table>
  <thead>
   <tr>
-   <th><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#event-handlers" title="event handlers">event handler</a>
-   <th><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#event-handler-event-type">event handler event type</a>
+   <th><a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#event-handlers" title="event handlers">event handler</a>
+   <th><a class="external" href="https://html.spec.whatwg.org/multipage/webappapis.html#event-handler-event-type">event handler event type</a>
  <tbody>
   <tr>
    <td><dfn id="handler-onclick" title="handler-onclick"><code>onclick</code></dfn>
@@ -671,7 +674,7 @@
 
 <p>The <dfn id="dom-notification-icon" title="dom-Notification-icon"><code>icon</code></dfn> attribute must return the
 <a href="#concept-notification" title="concept-notification">notification</a>'s <a href="#icon-url">icon URL</a>,
-<a class="external" href="http://url.spec.whatwg.org/#concept-url-serializer" title="concept-url-serializer">serialized</a>, and the
+<a class="external" href="https://url.spec.whatwg.org/#concept-url-serializer" title="concept-url-serializer">serialized</a>, and the
 empty string otherwise.
 
 
@@ -760,10 +763,10 @@
 <dd><cite><a href="http://www.unicode.org/reports/tr9/">Unicode Bidirectional Algorithm</a></cite>, Mark Davis. Unicode Consortium.
 
 <dt id="refsDOM">[DOM]
-<dd><cite><a href="http://dom.spec.whatwg.org/">DOM</a></cite>, Anne van Kesteren, Aryeh Gregor and Ms2ger. WHATWG.
+<dd><cite><a href="https://dom.spec.whatwg.org/">DOM</a></cite>, Anne van Kesteren, Aryeh Gregor and Ms2ger. WHATWG.
 
 <dt id="refsHTML">[HTML]
-<dd><cite><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/">HTML</a></cite>, Ian Hickson. WHATWG.
+<dd><cite><a href="https://html.spec.whatwg.org/multipage/">HTML</a></cite>, Ian Hickson. WHATWG.
 
 <dt id="refsLANG">[LANG]
 <dd><cite><a href="http://tools.ietf.org/html/bcp47">Tags for Identifying Languages; Matching of Language Tags</a></cite>, Addison Phillips and Mark Davis. IETF.
@@ -772,7 +775,7 @@
 <dd><cite><a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a></cite>, Scott Bradner. IETF.
 
 <dt id="refsURL">[URL]
-<dd><cite><a href="http://url.spec.whatwg.org/">URL</a></cite>, Anne van Kesteren. WHATWG.
+<dd><cite><a href="https://url.spec.whatwg.org/">URL</a></cite>, Anne van Kesteren. WHATWG.
 
 <dt id="refsWEBIDL">[WEBIDL]
 <dd><cite><a href="http://heycam.github.io/webidl/">Web IDL</a></cite>, Cameron McCormack. W3C.
@@ -796,6 +799,7 @@
 James Graham,
 Jon Lee,
 Jonas Sicking,
+Michael Cooper,
 Michael Henretty,
 Olli Pettay, and
 Simon Pieters
--- a/Overview.src.html	Fri May 09 15:31:52 2014 -0700
+++ b/Overview.src.html	Mon Jan 19 13:01:57 2015 -0800
@@ -231,6 +231,9 @@
 have an associated <dfn>body</dfn>, <dfn>tag</dfn>, <dfn>icon URL</dfn>, and
 <dfn>icon image</dfn>.
 
+<p class=note>Developers are encouraged to not convey information
+through an icon, sound, or vibration pattern that is not otherwise
+accessible to the end user.
 
 <h3>Direction</h3>
 
@@ -751,6 +754,7 @@
 James Graham,
 Jon Lee,
 Jonas Sicking,
+Michael Cooper,
 Michael Henretty,
 Olli Pettay, and
 Simon Pieters