Sync with WHATWG document (through affe5ff).
authorEdward O'Connor <eoconnor@apple.com>
Fri, 24 May 2013 12:13:10 -0700
changeset 31 d0d29cfd8c51
parent 30 f44121e2ea01
child 32 498b5397ed3f
Sync with WHATWG document (through affe5ff).
Overview.html
Overview.src.html
--- a/Overview.html	Thu Jul 26 09:41:53 2012 +0200
+++ b/Overview.html	Fri May 24 12:13:10 2013 -0700
@@ -47,7 +47,7 @@
 <!--end-logo-->
 
 <h1>Web Notifications</h1>
-<h2 class="no-num no-toc" id="editor's-draft-26-july-2012">Editor's Draft 26 July 2012</h2>
+<h2 class="no-num no-toc" id="editor's-draft-24-may-2013">Editor's Draft 24 May 2013</h2>
 
 <dl>
  <dt>This Version:
@@ -64,17 +64,18 @@
  <dd><a href="http://www.w3.org/TR/2012/WD-notifications-20120614/">http://www.w3.org/TR/2012/WD-notifications-20120614/</a>
  <dd><a href="http://www.w3.org/TR/2011/WD-notifications-20110301/">http://www.w3.org/TR/2011/WD-notifications-20110301/</a>
 
- <dt>Editors:
+ <dt>W3C Editor:
+ <dd>John Gregg (<a href="http://www.google.com/">Google</a>)
+ &lt;<a href="mailto:[email protected]">[email protected]</a>&gt;</dd>
+ <dt>WHATWG Editor:
  <dd><a href="http://annevankesteren.nl/">Anne van Kesteren</a>
- (<a href="http://www.opera.com/">Opera Software ASA</a>)
+ (<a href="http://www.mozilla.org/">Mozilla</a>)
  &lt;<a href="mailto:[email protected]">[email protected]</a>&gt;</dd>
- <dd>John Gregg (<a href="http://www.google.com/">Google</a>)
- &lt;<a href="mailto:[email protected]">[email protected]</a>&gt;
 </dl>
 
 
 <!--begin-copyright-->
-<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2012 <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> © 2013 <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>
@@ -95,14 +96,23 @@
 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 26 July 2012 Editor's Draft of Web Notifications.
+<p>This is the 24 May 2013 Editor's Draft of Web Notifications.
 Please send comments to
 <a href="mailto:[email protected]">[email protected]</a>
 (<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
 
-<p>This document was developed by the
-<a href="http://www.w3.org/2010/web-notifications/">Web Notification Working Group</a>.
-The Working Group expects to advance this Working Draft to Recommendation Status.
+<p class="alt">The bulk of the text of this specification is also
+available in the
+WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications API
+Standard</a>, under a license that permits reuse of the specification
+text.</p>
+
+<p>The W3C
+<a href="http://www.w3.org/2010/web-notifications/">Web Notification
+Working Group</a> is the W3C working group responsible for this
+specification's progress along the W3C Recommendation track. The Working
+Group expects to advance this Working Draft to Recommendation
+Status.</p>
 
 <p>Publication as a Working Draft does not imply endorsement by the W3C
 Membership. This is a draft document and may be updated, replaced or
@@ -153,6 +163,7 @@
 <!--end-toc-->
 
 
+
 <h2 id="introduction"><span class="secno">1 </span>Introduction</h2>
 
 <p>This specification provides an API to display notifications to alert
@@ -313,7 +324,7 @@
  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="http://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.
 
@@ -353,7 +364,7 @@
  <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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="http://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>
 
@@ -397,14 +408,14 @@
 
    <li><p>If displaying fails (e.g. the notification platform returns an
    error),
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+   <a class="external" href="http://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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">Fire an event</a>
+   <li><p><a class="external" href="http://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>
@@ -434,7 +445,7 @@
  <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
  <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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+ <a class="external" href="http://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>
@@ -442,9 +453,9 @@
   <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
   <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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+  <a class="external" href="http://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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-event-fire" title="concept-event-fire">fire an event</a>
+  <a class="external" href="http://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
@@ -465,9 +476,9 @@
 <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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#eventtarget">EventTarget</a> {
+interface <dfn id="notification">Notification</dfn> : <a class="external" href="http://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>(<a href="#notificationpermissioncallback">NotificationPermissionCallback</a> <var title="">callback</var>);
+  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>;
@@ -509,8 +520,7 @@
  <code><a href="#notification">Notification</a></code> object.
 
  <li><p>Set <var title="">notification</var>'s <a href="#title">title</a> to
- <var title="">title</var>,
- <a class="external" href="http://dev.w3.org/2006/webapi/WebIDL/#dfn-obtain-unicode" title="convert a DOMString to a sequence of Unicode characters">converted to Unicode</a>.
+ <var title="">title</var>.
 
  <li><p>Set <var title="">notification</var>'s <a href="#direction">direction</a> to
  <var title="">options</var>'s <code title="">dir</code>.
@@ -526,8 +536,7 @@
 
  <li><p>If <var title="">options</var>'s <code title="">body</code> is present,
  set <var title="">notification</var>'s <a href="#body">body</a> to
- <code title="">body</code>,
- <a class="external" href="http://dev.w3.org/2006/webapi/WebIDL/#dfn-obtain-unicode" title="convert a DOMString to a sequence of Unicode characters">converted to Unicode</a>.
+ <code title="">body</code>.
 
  <li><p>If <var title="">options</var>'s <code title="">tag</code> is present, set
  <var title="">notification</var>'s <a href="#tag">tag</a> to <code title="">tag</code>.
@@ -535,7 +544,7 @@
  <li><p>If <var title="">options</var>'s <code title="">icon</code> is present,
  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/urls.html#resolve-a-url" title="resolve a URL">resolve</a>
  <code title="">icon</code> against the
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#entry-script">entry script</a>'s
+ <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#entry-script">entry script</a>'s
  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#script's-base-url" title="script's base URL">base URL</a>, and
  if that does not fail, set
  <var title="">notification</var>'s <a href="#icon-url">icon URL</a> to the resulting
@@ -575,7 +584,7 @@
  <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
  <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.
+ argument if <var title="">callback</var> is given.
 </ol>
 
 <p class="warning">In designing the platform notifications are the one
@@ -649,7 +658,7 @@
 
 <p>Web applications frequently operate concurrently in multiple instances, such as when a
 	user opens a mail application in multiple browser tabs.  Since the desktop is a shared
-	resource, Web Notifications provides a way for these instances to easily coordinate, by
+	resource, the notifications API provides a way for these instances to easily coordinate, by
 	using the <code title="">tag</code> member.
 
 <p>Notifications which represent the same conceptual event can be tagged in the same way,
@@ -692,13 +701,15 @@
 	a similar result could be achieved using the
 	<code title="dom-Notification-close"><a href="#dom-notification-close">close()</a></code> method.
 
+
+
 <h2 class="no-num" id="references">References</h2>
 
 <div id="anolis-references"><dl><dt id="refsBIDI">[BIDI]
 <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://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html">DOM4</a></cite>, Anne van Kesteren, Aryeh Gregor and Ms2ger. W3C.
+<dd><cite><a href="http://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.
@@ -714,6 +725,8 @@
 
 </dl></div>
 
+
+
 <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
 
 <p>Thanks to
@@ -722,10 +735,16 @@
 David Håsäther,
 Doug Turner,
 Drew Wilson,
+Jake Archibald,
 Edward O'Connor,
 Ian Hickson,
 James Graham,
 Jon Lee,
-Jonas Sicking, and
-Olli Pettay,
+Jonas Sicking,
+Olli Pettay, and
+Simon Pieters
 for being awesome.
+
+Special thanks to Anne van Kesteren for his continuing work on the
+WHATWG's <a href="http://notifications.spec.whatwg.org/">Notifications
+API Standard</a>.
--- a/Overview.src.html	Thu Jul 26 09:41:53 2012 +0200
+++ b/Overview.src.html	Fri May 24 12:13:10 2013 -0700
@@ -71,12 +71,13 @@
  <dd><a href="http://www.w3.org/TR/2012/WD-notifications-20120614/">http://www.w3.org/TR/2012/WD-notifications-20120614/</a>
  <dd><a href="http://www.w3.org/TR/2011/WD-notifications-20110301/">http://www.w3.org/TR/2011/WD-notifications-20110301/</a>
 
- <dt>Editors:
+ <dt>W3C Editor:
+ <dd>John Gregg (<a href="http://www.google.com/">Google</a>)
+ &lt;<a href="mailto:[email protected]">[email protected]</a>&gt;</dd>
+ <dt>WHATWG Editor:
  <dd><a href="http://annevankesteren.nl/">Anne van Kesteren</a>
- (<a href="http://www.opera.com/">Opera Software ASA</a>)
+ (<a href="http://www.mozilla.org/">Mozilla</a>)
  &lt;<a href="mailto:[email protected]">[email protected]</a>&gt;</dd>
- <dd>John Gregg (<a href="http://www.google.com/">Google</a>)
- &lt;<a href="mailto:[email protected]">[email protected]</a>>
 </dl>
 
 <!-- copyright -->
@@ -104,9 +105,18 @@
 <a href="mailto:[email protected]">[email protected]</a>
 (<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
 
-<p>This document was developed by the
-<a href="http://www.w3.org/2010/web-notifications/">Web Notification Working Group</a>.
-The Working Group expects to advance this Working Draft to Recommendation Status.
+<p class="alt">The bulk of the text of this specification is also
+available in the
+WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications API
+Standard</a>, under a license that permits reuse of the specification
+text.</p>
+
+<p>The W3C
+<a href="http://www.w3.org/2010/web-notifications/">Web Notification
+Working Group</a> is the W3C working group responsible for this
+specification's progress along the W3C Recommendation track. The Working
+Group expects to advance this Working Draft to Recommendation
+Status.</p>
 
 <p>Publication as a Working Draft does not imply endorsement by the W3C
 Membership. This is a draft document and may be updated, replaced or
@@ -130,6 +140,7 @@
 <!-- toc -->
 
 
+
 <h2>Introduction</h2>
 
 <p>This specification provides an API to display notifications to alert
@@ -444,7 +455,7 @@
 <pre class="idl">[<span title=dom-Notification>Constructor</span>(DOMString <var title>title</var>, optional <span>NotificationOptions</span> <var title>options</var>)]
 interface <dfn>Notification</dfn> : <span data-anolis-spec=dom>EventTarget</span> {
   static readonly attribute <span>NotificationPermission</span> <span title=dom-Notification-permission>permission</span>;
-  static void <span title=dom-Notification-requestPermission>requestPermission</span>(<span>NotificationPermissionCallback</span> <var title>callback</var>);
+  static void <span title=dom-Notification-requestPermission>requestPermission</span>(optional <span>NotificationPermissionCallback</span> <var title>callback</var>);
 
   attribute <span data-anolis-spec=html>EventHandler</span> <span title=handler-onclick>onclick</span>;
   attribute <span data-anolis-spec=html>EventHandler</span> <span title=handler-onshow>onshow</span>;
@@ -486,8 +497,7 @@
  <code>Notification</code> object.
 
  <li><p>Set <var title>notification</var>'s <span>title</span> to
- <var title>title</var>,
- <span data-anolis-spec=webidl title="convert a DOMString to a sequence of Unicode characters">converted to Unicode</span>.
+ <var title>title</var>.
 
  <li><p>Set <var title>notification</var>'s <span>direction</span> to
  <var title>options</var>'s <code title>dir</code>.
@@ -503,8 +513,7 @@
 
  <li><p>If <var title>options</var>'s <code title>body</code> is present,
  set <var title>notification</var>'s <span>body</span> to
- <code title>body</code>,
- <span data-anolis-spec=webidl title="convert a DOMString to a sequence of Unicode characters">converted to Unicode</span>.
+ <code title>body</code>.
 
  <li><p>If <var title>options</var>'s <code title>tag</code> is present, set
  <var title>notification</var>'s <span>tag</span> to <code title>tag</code>.
@@ -552,7 +561,7 @@
  <li><p><span data-anolis-spec=html>Queue a task</span> to set
  <span>permission</span> to <var title>permission</var> and invoke
  <var title>callback</var> with <var title>permission</var> as single
- argument.
+ argument if <var title>callback</var> is given.
 </ol>
 
 <p class=warning>In designing the platform notifications are the one
@@ -626,7 +635,7 @@
 
 <p>Web applications frequently operate concurrently in multiple instances, such as when a
 	user opens a mail application in multiple browser tabs.  Since the desktop is a shared
-	resource, Web Notifications provides a way for these instances to easily coordinate, by
+	resource, the notifications API provides a way for these instances to easily coordinate, by
 	using the <code title>tag</code> member.
 
 <p>Notifications which represent the same conceptual event can be tagged in the same way,
@@ -669,10 +678,14 @@
 	a similar result could be achieved using the
 	<code title=dom-Notification-close>close()</code> method.
 
+
+
 <h2 class=no-num>References</h2>
 
 <div id=anolis-references></div>
 
+
+
 <h2 class=no-num>Acknowledgments</h2>
 
 <p>Thanks to
@@ -681,10 +694,16 @@
 David Håsäther,
 Doug Turner,
 Drew Wilson,
+Jake Archibald,
 Edward O'Connor,
 Ian Hickson,
 James Graham,
 Jon Lee,
-Jonas Sicking, and
-Olli Pettay,
+Jonas Sicking,
+Olli Pettay, and
+Simon Pieters
 for being awesome.
+
+Special thanks to Anne van Kesteren for his continuing work on the
+WHATWG's <a href="http://notifications.spec.whatwg.org/">Notifications
+API Standard</a>.