discovery-api/Overview.src.html
changeset 441 b4b2569b4e9b
parent 440 fcbaadc4fd54
child 447 5e36d90b8960
--- a/discovery-api/Overview.src.html	Mon Aug 12 16:20:17 2013 +1000
+++ b/discovery-api/Overview.src.html	Mon Aug 12 18:16:00 2013 +1000
@@ -71,9 +71,6 @@
      /* Add better spacing to sections */
      section, .section { margin-bottom: 2em; }
 
-     /* Reduce note & issue render size */
-     .note, .issue { font-size:0.8em; }
-
      /* Add addition spacing to <ol> and <ul> for rule definition */
      ol.rule li, ul.rule li { padding:0.6em; }
 
@@ -616,9 +613,9 @@
           </p>
           <p>
             When a <a href="#networkservice"><code>NetworkService</code></a> object is provided to a Web page, the
-            <a>user agent</a> MUST add the <code>url</code> property to the <dfn>entry script origin's URL
-            whitelist</dfn>. This list enables the Web page to override and initiate cross-site resource requests
-            towards these URLs, and any sub-resources of these URLs, within the current <a href=
+            <a>user agent</a> MUST add its <a href="#dom-networkservice-url"><code>url</code></a> to the <dfn>entry
+            script origin's URL whitelist</dfn>. This list enables the Web page to override and initiate cross-site
+            resource requests towards these URLs, and any sub-resources of these URLs, within the current <a href=
             "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
                class="externalDFN">entry script</a>'s <a href=
                "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
@@ -630,10 +627,14 @@
             "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
                class="externalDFN">entry script</a>'s <a href=
                "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
-               class="externalDFN">origin</a> then the <a>user agent</a> <em class="ct">MUST</em> remove all previously
-               whitelisted urls from the <a>entry script origin's URL whitelist</a>. There is no persistence to network
-               service selections provided to a web page. It is not possible to access a previously white-listed
-               networked service without the necessary user authorization in all of the following cases:
+               class="externalDFN">origin</a> or permission to access a given networked service is revoked at any time
+               by the platform or user then the <a>user agent</a> <em class="ct">MUST</em> remove its previously
+               whitelisted urls from the <a>entry script origin's URL whitelist</a>.
+          </p>
+          <p>
+            There is no implied persistence to networked service sharing provided to a web page. It MUST NOT be
+            possible to access a previously white-listed networked service without user authorization in all of the
+            following cases:
           </p>
           <ul>
             <li>If the current script is reloaded at any point in the same or different window.
@@ -1804,22 +1805,21 @@
         Garbage collection
       </h3>
       <p>
-        A user agent MUST only garbage collect a <a><code>NetworkServices</code></a> object and remove its entry from
-        the <a>list of active service managers</a> when the user has navigated away from the <a href=
-        "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
-           class="externalDFN">entry script</a>'s <a href=
-           "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
-           class="externalDFN">origin</a> in which the current <a><code>NetworkServices</code></a> object was provided.
+        There is an <dfn>implied strong reference</dfn> from any IDL attribute in this API that returns a pre-existing
+        object to that object.
+      </p>
+      <p class="note">
+        For example, if a <a><code>NetworkServices</code></a> object has one or more <a>indexed properties</a> attached
+        to it then there is a strong reference from that <a><code>NetworkServices</code></a> object toward each of its
+        <a>indexed properties</a>.
       </p>
       <p>
-        A user agent MUST NOT garbage collect individual <a><code>NetworkService</code></a> objects until their parent
-        <a><code>NetworkServices</code></a> object has been garbage collected.
-      </p>
-      <p>
-        A user agent MUST garbage collect the <a><code>NetworkService</code></a> <a>indexed properties</a> of a
-        <a><code>NetworkServices</code></a> object, passing each indexed property's <code>id</code> attribute as the
-        only argument to the rule for <a>removing an available service</a>, when that
-        <a><code>NetworkServices</code></a> object itself has been garbage-collected.
+        If a <a>user agent</a> is to <dfn>make disappear</dfn> a <a><code>NetworkServices</code></a> object (this
+        happens when a <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#document"
+           class="externalDFN"><code>Document</code></a> object goes away), the <a>user agent</a> MUST remove this
+           object from the <a>list of active service managers</a> and remove the <a href=
+           "#dom-networkservice-url"><code>url</code></a> of each of its <a>indexed properties</a> from the <a>entry
+           script origin's URL whitelist</a>.
       </p>
     </section>
     <section>