dap commit: update normative language based on privacy review comments <http://lists.w3.org/Archives/Public/public-device-apis/2013May/0053.html>

changeset:   424:5b6c53ebd810
tag:         tip
user:        Anssi Kostiainen <anssi.kostiainen@intel.com>
date:        Tue May 28 12:00:06 2013 +0300
files:       light/Overview.html light/Overview.src.html proximity/Overview.html proximity/Overview.src.html
description:
update normative language based on privacy review comments <http://lists.w3.org/Archives/Public/public-device-apis/2013May/0053.html>


diff -r 8ae98ae385bc -r 5b6c53ebd810 light/Overview.html
--- a/light/Overview.html	Mon May 27 09:26:41 2013 +0300
+++ b/light/Overview.html	Tue May 28 12:00:06 2013 +0300
@@ -391,7 +391,7 @@
   </p>
   <h1 class="title p-name" id="title">Ambient Light Events</h1>
   
-  <h2 id="w3c-editor-s-draft-27-may-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-05-27">27 May 2013</time></h2>
+  <h2 id="w3c-editor-s-draft-28-may-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-05-28">28 May 2013</time></h2>
   <dl>
     
       <dt>This version:</dt>
@@ -555,9 +555,9 @@
         The concepts <dfn id="dfn-queue-a-task"><a href="http://dev.w3.org/html5/spec/webappapis.html#queue-a-task">
         queue a task</a></dfn>,
         <dfn id="dfn-fires-a-simple-event"><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
-        fires a simple event</a></dfn>, and <dfn id="dfn-browsing-context">
-        <a href="http://dev.w3.org/html5/spec/browsers.html#browsing-context">
-        browsing context</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
+        fires a simple event</a></dfn>, and <dfn id="dfn-top-level-browsing-context">
+        <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
+        top-level browsing context</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
       </p>
       <p>
         The terms <dfn id="dfn-event-handlers"><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">
@@ -622,6 +622,14 @@
         privacy assessment of their application taking all aspects of their
         application into consideration.
       </p>
+      <p>
+        The events defined in this specification are only fired in the
+        <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a> to avoid the privacy risk of
+        sharing the information defined in this specification with contexts
+        unfamiliar to the user. For example, a mobile device will only fire
+        these events on the active tab, and not on the background tabs or
+        within iframes.
+      </p>
     </section>
     
     <section id="device-light">
@@ -688,7 +696,7 @@
         <p>
           When the <a href="#dfn-current-light-level" class="internalDFN">current light level</a> changes, the <dfn id="dfn-user-agent-3">user agent</dfn>
           <em class="rfc2119" title="MUST">MUST</em> queue a task to <a href="#dfn-fire-a-device-light-event" class="internalDFN">fire a device light event</a>
-          at each <a href="#dfn-browsing-context" class="internalDFN">browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
+          at the <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
         </p>
         <div class="note"><div class="note-title" role="heading" aria-level="4"><span>Note</span></div><div class="">
           The definition of granularity i.e. how often the event is fired is
@@ -807,7 +815,7 @@
         <p>
           When the <a href="#dfn-current-light-level-state" class="internalDFN">current light level state</a> changes, the <dfn id="dfn-user-agent-6">user agent</dfn>
           <em class="rfc2119" title="MUST">MUST</em> queue a task to <a>fire a user proximity event</a>
-          at each <a href="#dfn-browsing-context" class="internalDFN">browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
+          at the <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
         </p>
         
         <div class="note"><div class="note-title" role="heading" aria-level="4"><span>Note</span></div><div class="">
@@ -851,6 +859,6 @@
   
 
 <section id="references" class="appendix"><!--OddPage--><h2><span class="secno">B. </span>References</h2><section id="normative-references"><h3><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-DOM4">[DOM4]</dt><dd>Anne van Kesteren; Aryeh Gregor; Lachlan Hunt; Ms2ger. <a href="http://www.w3.org/TR/dom/"><cite>DOM4</cite></a>. 6 December 2012. W3C Working Draft. URL: <a href="http://www.w3.org/TR/dom/">http://www.w3.org/TR/dom/</a>
-</dd><dt id="bib-HTML5">[HTML5]</dt><dd>Robin Berjon et al. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 17 December 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
+</dd><dt id="bib-HTML5">[HTML5]</dt><dd>Robin Berjon et al. <a href="http://www.w3.org/TR/html5/"><cite>HTML5.</cite></a>. 17 December 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
 </dd><dt id="bib-RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119.  URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a> 
 </dd></dl></section></section></body></html>
\ No newline at end of file
diff -r 8ae98ae385bc -r 5b6c53ebd810 light/Overview.src.html
--- a/light/Overview.src.html	Mon May 27 09:26:41 2013 +0300
+++ b/light/Overview.src.html	Tue May 28 12:00:06 2013 +0300
@@ -82,8 +82,8 @@
         queue a task</a></dfn>,
         <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
         fires a simple event</a></dfn>, and <dfn>
-        <a href="http://dev.w3.org/html5/spec/browsers.html#browsing-context">
-        browsing context</a></dfn> are defined in [[!HTML5]].
+        <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
+        top-level browsing context</a></dfn> are defined in [[!HTML5]].
       </p>
       <p>
         The terms <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">
@@ -148,6 +148,14 @@
         privacy assessment of their application taking all aspects of their
         application into consideration.
       </p>
+      <p>
+        The events defined in this specification are only fired in the
+        <a>top-level browsing context</a> to avoid the privacy risk of
+        sharing the information defined in this specification with contexts
+        unfamiliar to the user. For example, a mobile device will only fire
+        these events on the active tab, and not on the background tabs or
+        within iframes.
+      </p>
     </section>
     
     <section>
@@ -224,7 +232,7 @@
         <p>
           When the <a>current light level</a> changes, the <dfn>user agent</dfn>
           MUST queue a task to <a>fire a device light event</a>
-          at each <a>browsing context</a>'s <a>Window</a> object.
+          at the <a>top-level browsing context</a>'s <a>Window</a> object.
         </p>
         <div class="note">
           The definition of granularity i.e. how often the event is fired is
@@ -366,7 +374,7 @@
         <p>
           When the <a>current light level state</a> changes, the <dfn>user agent</dfn>
           MUST queue a task to <a>fire a user proximity event</a>
-          at each <a>browsing context</a>'s <a>Window</a> object.
+          at the <a>top-level browsing context</a>'s <a>Window</a> object.
         </p>
         
         <div class="note">
diff -r 8ae98ae385bc -r 5b6c53ebd810 proximity/Overview.html
--- a/proximity/Overview.html	Mon May 27 09:26:41 2013 +0300
+++ b/proximity/Overview.html	Tue May 28 12:00:06 2013 +0300
@@ -391,7 +391,7 @@
   </p>
   <h1 class="title p-name" id="title">Proximity Events</h1>
   
-  <h2 id="w3c-editor-s-draft-27-may-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-05-27">27 May 2013</time></h2>
+  <h2 id="w3c-editor-s-draft-28-may-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-05-28">28 May 2013</time></h2>
   <dl>
     
       <dt>This version:</dt>
@@ -577,9 +577,9 @@
         The concepts <dfn id="dfn-queue-a-task"><a href="http://dev.w3.org/html5/spec/webappapis.html#queue-a-task">
         queue a task</a></dfn>,
         <dfn id="dfn-fires-a-simple-event"><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
-        fires a simple event</a></dfn>, and <dfn id="dfn-browsing-context">
-        <a href="http://dev.w3.org/html5/spec/browsers.html#browsing-context">
-        browsing context</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
+        fires a simple event</a></dfn>, and <dfn id="dfn-top-level-browsing-context">
+        <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
+        top-level browsing context</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
       </p>
       <p>
         Event constructor behavior is defined in
@@ -655,6 +655,13 @@
         privacy assessment of their application taking all aspects of their
         application into consideration.
       </p>
+      <p>
+        The device proximity and user proximity events are only fired in the
+        <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a> to avoid the privacy risk of
+        sharing the information about proximity with contexts unfamiliar to
+        the user. For example, a mobile device will only fire these events on
+        the active tab, and not on the background tabs or within iframes.
+      </p>
     </section>
     
     <section id="device-proximity">
@@ -739,7 +746,7 @@
         <p>
           When the <a href="#dfn-current-device-proximity" class="internalDFN">current device proximity</a> changes, the <dfn id="dfn-user-agent-3">user
           agent</dfn> <em class="rfc2119" title="MUST">MUST</em> queue a task to <a href="#dfn-fire-a-device-proximity-event" class="internalDFN">fire a device proximity event</a>
-          at each <a href="#dfn-browsing-context" class="internalDFN">browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
+          at the <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
         </p>
         <div class="note"><div class="note-title" role="heading" aria-level="4"><span>Note</span></div><div class="">
           The definition of granularity i.e. how often the event is fired is
@@ -830,7 +837,7 @@
         <p>
           When the <a href="#dfn-current-user-proximity-state" class="internalDFN">current user proximity state</a> changes, the <dfn id="dfn-user-agent-6">user
           agent</dfn> <em class="rfc2119" title="MUST">MUST</em> queue a task to <a href="#dfn-fire-a-user-proximity-event" class="internalDFN">fire a user proximity event</a>
-          at each <a href="#dfn-browsing-context" class="internalDFN">browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
+          at the <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
         </p>
         <section id="event-handlers-1">
           <h4><span class="secno">6.1.1 </span>Event handlers</h4>
@@ -868,6 +875,6 @@
   
 
 <section id="references" class="appendix"><!--OddPage--><h2><span class="secno">B. </span>References</h2><section id="normative-references"><h3><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-DOM4">[DOM4]</dt><dd>Anne van Kesteren; Aryeh Gregor; Lachlan Hunt; Ms2ger. <a href="http://www.w3.org/TR/dom/"><cite>DOM4</cite></a>. 6 December 2012. W3C Working Draft. URL: <a href="http://www.w3.org/TR/dom/">http://www.w3.org/TR/dom/</a>
-</dd><dt id="bib-HTML5">[HTML5]</dt><dd>Robin Berjon et al. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 17 December 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
+</dd><dt id="bib-HTML5">[HTML5]</dt><dd>Robin Berjon et al. <a href="http://www.w3.org/TR/html5/"><cite>HTML5.</cite></a>. 17 December 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
 </dd><dt id="bib-RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119.  URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a> 
 </dd></dl></section></section></body></html>
\ No newline at end of file
diff -r 8ae98ae385bc -r 5b6c53ebd810 proximity/Overview.src.html
--- a/proximity/Overview.src.html	Mon May 27 09:26:41 2013 +0300
+++ b/proximity/Overview.src.html	Tue May 28 12:00:06 2013 +0300
@@ -104,8 +104,8 @@
         queue a task</a></dfn>,
         <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
         fires a simple event</a></dfn>, and <dfn>
-        <a href="http://dev.w3.org/html5/spec/browsers.html#browsing-context">
-        browsing context</a></dfn> are defined in [[!HTML5]].
+        <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
+        top-level browsing context</a></dfn> are defined in [[!HTML5]].
       </p>
       <p>
         Event constructor behavior is defined in
@@ -181,6 +181,14 @@
         privacy assessment of their application taking all aspects of their
         application into consideration.
       </p>
+      <p>
+        The events defined in this specification are only fired in the
+        <a>top-level browsing context</a> to avoid the privacy risk of
+        sharing the information defined in this specification with contexts
+        unfamiliar to the user. For example, a mobile device will only fire
+        these events on the active tab, and not on the background tabs or
+        within iframes.
+      </p>
     </section>
     
     <section>
@@ -286,7 +294,7 @@
         <p>
           When the <a>current device proximity</a> changes, the <dfn>user
           agent</dfn> MUST queue a task to <a>fire a device proximity event</a>
-          at each <a>browsing context</a>'s <a>Window</a> object.
+          at the <a>top-level browsing context</a>'s <a>Window</a> object.
         </p>
         <div class="note">
           The definition of granularity i.e. how often the event is fired is
@@ -386,7 +394,7 @@
         <p>
           When the <a>current user proximity state</a> changes, the <dfn>user
           agent</dfn> MUST queue a task to <a>fire a user proximity event</a>
-          at each <a>browsing context</a>'s <a>Window</a> object.
+          at the <a>top-level browsing context</a>'s <a>Window</a> object.
         </p>
         <section>
           <h2>Event handlers</h2>

Received on Tuesday, 28 May 2013 09:00:26 UTC