Clarify relationship to the WHATWG Notifications document. Regenerate Overview.html.
authorEdward O'Connor <eoconnor@apple.com>
Fri, 09 May 2014 15:31:52 -0700
changeset 40 951a6f33b7b0
parent 39 954dc2126532
child 41 17f9bafc1981
child 43 e89ddc23c6e1
Clarify relationship to the WHATWG Notifications document. Regenerate Overview.html.
Overview.html
Overview.src.html
--- a/Overview.html	Wed Apr 30 14:41:03 2014 -0700
+++ b/Overview.html	Fri May 09 15:31:52 2014 -0700
@@ -47,7 +47,7 @@
 <!--end-logo-->
 
 <h1>Web Notifications</h1>
-<h2 class="no-num no-toc" id="editor's-draft-15-august-2013">Editor's Draft 15 August 2013</h2>
+<h2 class="no-num no-toc" id="editor's-draft-9-may-2014">Editor's Draft 9 May 2014</h2>
 
 <dl>
  <dt>This Version:
@@ -64,7 +64,7 @@
  <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>W3C Editor:
+ <dt>Former 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:
@@ -75,7 +75,7 @@
 
 
 <!--begin-copyright-->
-<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>
+<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>
 <!--end-copyright-->
 
 </div>
@@ -96,17 +96,11 @@
 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 15 August 2013 Editor's Draft of Web Notifications.
+<p>This is the 9 May 2014 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 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
@@ -114,6 +108,21 @@
 Group expects to advance this Working Draft to Recommendation
 Status.</p>
 
+<p class="alt">This feature is also being worked on by
+the <a href="http://www.whatwg.org/">WHATWG</a>. The bulk of the
+text of this specification is 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 two specifications are normatively identical up to WHATWG
+revision <a href="https://github.com/whatwg/notifications/commit/998421f">998421f</a>
+(W3C
+revision <a href="https://dvcs.w3.org/hg/notifications/raw-file/498b5397ed3f/Overview.html">498b5397ed3f</a>).
+Since that revision, the WHATWG is exploring new features which may be
+incorporated into future levels of this specification. Bugfixes and
+editorial changes have been merged to minimize divergence.</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
 obsoleted by other documents at any time. It is inappropriate to cite this
@@ -148,10 +157,11 @@
    <li><a href="#permission"><span class="secno">4.3 </span>Permission</a></li>
    <li><a href="#notification-lists"><span class="secno">4.4 </span>Notification lists</a></li>
    <li><a href="#showing-a-notification"><span class="secno">4.5 </span>Showing a notification</a></li>
-   <li><a href="#closing-a-notification"><span class="secno">4.6 </span>Closing a notification</a></li>
-   <li><a href="#pending-notifications"><span class="secno">4.7 </span>Pending notifications</a></li>
-   <li><a href="#displaying-notifications"><span class="secno">4.8 </span>Displaying notifications</a></li>
-   <li><a href="#replacing-a-notification"><span class="secno">4.9 </span>Replacing a notification</a></ol></li>
+   <li><a href="#activating-a-notification"><span class="secno">4.6 </span>Activating a notification</a></li>
+   <li><a href="#closing-a-notification"><span class="secno">4.7 </span>Closing a notification</a></li>
+   <li><a href="#pending-notifications"><span class="secno">4.8 </span>Pending notifications</a></li>
+   <li><a href="#displaying-notifications"><span class="secno">4.9 </span>Displaying notifications</a></li>
+   <li><a href="#replacing-a-notification"><span class="secno">4.10 </span>Replacing a notification</a></ol></li>
  <li><a href="#api"><span class="secno">5 </span>API</a></li>
  <li><a href="#examples"><span class="secno">6 </span>Examples</a>
   <ol class="toc">
@@ -243,7 +253,7 @@
 
 <p>Each <a href="#concept-notification" title="concept-notification">notification</a> <em>can</em>
 have an associated <dfn id="body">body</dfn>, <dfn id="tag">tag</dfn>, <dfn id="icon-url">icon URL</dfn>, and
-<dfn id="icon">icon</dfn>.
+<dfn id="icon-image">icon image</dfn>.
 
 
 <h3 id="direction-0"><span class="secno">4.1 </span>Direction</h3>
@@ -342,15 +352,32 @@
  the <a href="#display-steps">display steps</a> and terminate these steps.
 
  <li><p>If the device has limitations on the number of concurrent
- notifications, either immediately call to a notifications platform which
+ notifications, either immediately call to a notification platform which
  natively supports queueing, or append <var title="">notification</var> to the
  <a href="#list-of-pending-notifications">list of pending notifications</a>.
 </ol>
 
-<h3 id="closing-a-notification"><span class="secno">4.6 </span>Closing a notification</h3>
+<h3 id="activating-a-notification"><span class="secno">4.6 </span>Activating a notification</h3>
+
+<p>When a <a href="#concept-notification" title="concept-notification">notification</a>
+<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>
+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
+the event listener for the event named <code title="">click</code> as a means of focusing the
+browsing context related to the notification.
+
+<h3 id="closing-a-notification"><span class="secno">4.7 </span>Closing a notification</h3>
 
 <p>When a <a href="#concept-notification" title="concept-notification">notification</a> is closed,
-either by the underlying notifications platform or by the user, the
+either by the underlying notification platform or by the user, the
 <a href="#close-steps">close steps</a> for it must be run.
 
 <p>The <dfn id="close-steps">close steps</dfn> for a given <var title="">notification</var> are:
@@ -368,7 +395,7 @@
  named <code title="">close</code> on <var title="">notification</var>.
 </ol>
 
-<h3 id="pending-notifications"><span class="secno">4.7 </span>Pending notifications</h3>
+<h3 id="pending-notifications"><span class="secno">4.8 </span>Pending notifications</h3>
 
 <p>Whenever the <a href="#list-of-pending-notifications">list of pending notifications</a> is not empty, the
 user agent must wait and monitor changes in the available notification space
@@ -381,7 +408,7 @@
 <a href="#list-of-pending-notifications">list of pending notifications</a> and then remove it from the
 <a href="#list-of-pending-notifications">list of pending notifications</a>.
 
-<h3 id="displaying-notifications"><span class="secno">4.8 </span>Displaying notifications</h3>
+<h3 id="displaying-notifications"><span class="secno">4.9 </span>Displaying notifications</h3>
 
 <p>The <dfn id="display-steps">display steps</dfn> for a given <var title="">notification</var>
 are:
@@ -396,8 +423,8 @@
 
   <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
   finished and the image format is supported, set
-  <var title="">notification</var>'s <a href="#icon">icon</a> to the decoded resource.
-  (Otherwise <var title="">notification</var> has no <a href="#icon">icon</a>.)
+  <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:
@@ -421,7 +448,7 @@
 </ol>
 
 
-<h3 id="replacing-a-notification"><span class="secno">4.9 </span>Replacing a notification</h3>
+<h3 id="replacing-a-notification"><span class="secno">4.10 </span>Replacing a notification</h3>
 
 <p>The <dfn id="replace-steps">replace steps</dfn> for replacing an <var title="">old</var>
 <a href="#concept-notification" title="concept-notification">notification</a> with a
@@ -437,8 +464,8 @@
 
   <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
   finished and the image format is supported, set
-  <var title="">new</var>'s <a href="#icon">icon</a> to the decoded resource.
-  (Otherwise <var title="">new</var> has no <a href="#icon">icon</a>.)
+  <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>,
@@ -485,6 +512,7 @@
   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>;
 
+  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>;
   readonly attribute DOMString <a href="#dom-notification-dir" title="dom-Notification-dir">lang</a>;
   readonly attribute DOMString <a href="#dom-notification-dir" title="dom-Notification-dir">body</a>;
@@ -549,12 +577,10 @@
 
  <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#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 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.)
+ <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
+ 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.)
 
  <li><p>Return <var title="">notification</var>, but continue running these
  steps asynchronouusly.
@@ -626,6 +652,9 @@
 must run the <a href="#close-steps">close steps</a> for the
 <a href="#concept-notification" title="concept-notification">notification</a>.
 
+<p>The <dfn id="dom-notification-title" title="dom-Notification-title"><code>title</code></dfn> attribute must return the
+<a href="#concept-notification" title="concept-notification">notification</a>'s <a href="#title">title</a>.
+
 <p>The <dfn id="dom-notification-dir" title="dom-Notification-dir"><code>dir</code></dfn> attribute must return the
 <a href="#concept-notification" title="concept-notification">notification</a>'s <a href="#direction">direction</a>.
 
@@ -743,10 +772,10 @@
 <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 Standard</a></cite>, Anne van Kesteren. WHATWG.
+<dd><cite><a href="http://url.spec.whatwg.org/">URL</a></cite>, Anne van Kesteren. WHATWG.
 
 <dt id="refsWEBIDL">[WEBIDL]
-<dd><cite><a href="http://dev.w3.org/2006/webapi/WebIDL/">Web IDL</a></cite>, Cameron McCormack. W3C.
+<dd><cite><a href="http://heycam.github.io/webidl/">Web IDL</a></cite>, Cameron McCormack. W3C.
 
 </dl></div>
 
@@ -762,10 +791,12 @@
 Drew Wilson,
 Jake Archibald,
 Edward O'Connor,
+Frederick Hirsch,
 Ian Hickson,
 James Graham,
 Jon Lee,
 Jonas Sicking,
+Michael Henretty,
 Olli Pettay, and
 Simon Pieters
 for being awesome.
--- a/Overview.src.html	Wed Apr 30 14:41:03 2014 -0700
+++ b/Overview.src.html	Fri May 09 15:31:52 2014 -0700
@@ -71,7 +71,7 @@
  <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>W3C Editor:
+ <dt>Former 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:
@@ -105,12 +105,6 @@
 <a href="mailto:[email protected]">[email protected]</a>
 (<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
 
-<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
@@ -118,6 +112,21 @@
 Group expects to advance this Working Draft to Recommendation
 Status.</p>
 
+<p class="alt">This feature is also being worked on by
+the <a href="http://www.whatwg.org/">WHATWG</a>. The bulk of the
+text of this specification is 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 two specifications are normatively identical up to WHATWG
+revision <a href="https://github.com/whatwg/notifications/commit/998421f">998421f</a>
+(W3C
+revision <a href="https://dvcs.w3.org/hg/notifications/raw-file/498b5397ed3f/Overview.html">498b5397ed3f</a>).
+Since that revision, the WHATWG is exploring new features which may be
+incorporated into future levels of this specification. Bugfixes and
+editorial changes have been merged to minimize divergence.</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
 obsoleted by other documents at any time. It is inappropriate to cite this