CVS WWW/2011/tracking-protection/drafts

Update of /w3ccvs/WWW/2011/tracking-protection/drafts
In directory gil:/tmp/cvs-serv11761

Modified Files:
	tracking-dnt.html 
Log Message:
changes to the API parameter types proposed by Adrian Bateman
[Repeat of prior reverted changes, now with correct line endings.]


--- /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html	2013/02/12 22:45:17	1.186
+++ /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html	2013/02/12 22:48:35	1.187
@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <html lang="en" dir="ltr">
 <head>
   <title>Tracking Preference Expression (DNT)</title>
@@ -1341,6 +1341,10 @@
         <p class="issue" data-number="144" title="What constraints on user agents should be imposed for user/granted exceptions">
           <b>[PENDING REVIEW]</b> but mostly addressed in the proposal here.
         </p>
+      </section>
+
+      <section id="exceptions-principles" class="informative">
+        <h2>Motivating Principles and Use Cases</h2>
 
         <p>
           The following principles guide the design of user-agent-managed
@@ -1619,33 +1623,32 @@
         <section id="exceptions-javascript-api-rqst">
           <h3>API to Request a Site-specific Exception</h3>
 
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>integer storeSiteSpecificTrackingException (
-                  optional sequence&lt;DOMString&gt; arrayOfDomainStrings,
-                  optional siteName,
-                  optional explanationString,
-                  optional detailURI)
+                  StoreSiteSpecificExceptionPropertyBag properties)
             </dt>
             <dd>
               Called by a page to store a site-specific tracking
               exception.
             </dd>
           </dl>
+          <dl class="idl" title="dictionary StoreExceptionPropertyBag">
+              <dt>DOMString? siteName</dt>
+              <dd>A user-readable string for the name of the top-level origin.</dd>
+              <dt>DOMString? explanationString</dt>
+              <dd>A short explanation of the request.</dd>
+              <dt>DOMString? detailURI</dt>
+              <dd>A location at which further information about this request can be found.</dd>
+          </dl>
+          <dl class="idl" title="dictionary StoreSiteSpecificExceptionPropertyBag : StoreExceptionPropertyBag">
+              <dt>sequence&lt;DOMString&gt; arrayOfDomainStrings</dt>
+              <dd>A JavaScript array of strings.</dd>
+          </dl>
 
           <p>
             The <code>storeSiteSpecificTrackingException</code> method takes
-            four optional arguments:
+            a dictionary argument of type <a>StoreSiteSpecificExceptionPropertyBag</a> that allows optional information to be provided.
           </p>
-          <ul>
-            <li><code>arrayOfDomainStrings</code>, a JavaScript array of
-              strings,</li>
-            <li><code>siteName</code>, a user-readable string for the
-              name of the top-level origin,</li>
-            <li><code>explanationString</code>, a short explanation of the
-            request, and</li>
-            <li><code>detailURI</code>, a location at which further
-              information about this request can be found.</li>
-          </ul>
           <p>
             If the request does not include the
             <code>arrayOfDomainStrings</code>, then this request is for a
@@ -1717,7 +1720,7 @@
         <section id="exceptions-javascript-api-cancel">
           <h3>API to Cancel a Site-specific Exception</h3>
           
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>boolean removeSiteSpecificTrackingException( )</dt>
             <dd>
               Ensures that the database of remembered grants no longer
@@ -1739,7 +1742,7 @@
         <section id="exceptions-javascript-api-confirm">
           <h3>API to Confirm a Site-specific Exception</h3>
 
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>boolean confirmSiteSpecificTrackingException (
                   optional sequence&lt;DOMString&gt; arrayOfDomainStrings)
             </dt>
@@ -1807,7 +1810,7 @@
         <section id="exceptions-javascript-api-ww-rqst">
           <h3>API to Request a Web-wide Exception</h3>
 
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>integer storeWebWideTrackingException (
                        optional siteName,
                        optional explanationString,
@@ -1842,7 +1845,7 @@
         <section id="exceptions-javascript-api-ww-cancel">
           <h3>API to Cancel a Web-wide Exception</h3>
 
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>boolean removeWebWideTrackingException( )</dt>
             <dd>
               Ensures that the database of remembered grants no longer
@@ -1864,7 +1867,7 @@
         <section id="exceptions-javascript-api-ww-confirm">
           <h3>API to Confirm a Web-wide Exception</h3>
 
-          <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+          <dl class="idl" title='partial interface Navigator'>
             <dt>boolean confirmWebWideTrackingException ()
             </dt>
           </dl>

Received on Tuesday, 12 February 2013 22:48:35 UTC