discovery-api/Overview.src.html
changeset 441 b4b2569b4e9b
parent 440 fcbaadc4fd54
child 447 5e36d90b8960
     1.1 --- a/discovery-api/Overview.src.html	Mon Aug 12 16:20:17 2013 +1000
     1.2 +++ b/discovery-api/Overview.src.html	Mon Aug 12 18:16:00 2013 +1000
     1.3 @@ -71,9 +71,6 @@
     1.4       /* Add better spacing to sections */
     1.5       section, .section { margin-bottom: 2em; }
     1.6  
     1.7 -     /* Reduce note & issue render size */
     1.8 -     .note, .issue { font-size:0.8em; }
     1.9 -
    1.10       /* Add addition spacing to <ol> and <ul> for rule definition */
    1.11       ol.rule li, ul.rule li { padding:0.6em; }
    1.12  
    1.13 @@ -616,9 +613,9 @@
    1.14            </p>
    1.15            <p>
    1.16              When a <a href="#networkservice"><code>NetworkService</code></a> object is provided to a Web page, the
    1.17 -            <a>user agent</a> MUST add the <code>url</code> property to the <dfn>entry script origin's URL
    1.18 -            whitelist</dfn>. This list enables the Web page to override and initiate cross-site resource requests
    1.19 -            towards these URLs, and any sub-resources of these URLs, within the current <a href=
    1.20 +            <a>user agent</a> MUST add its <a href="#dom-networkservice-url"><code>url</code></a> to the <dfn>entry
    1.21 +            script origin's URL whitelist</dfn>. This list enables the Web page to override and initiate cross-site
    1.22 +            resource requests towards these URLs, and any sub-resources of these URLs, within the current <a href=
    1.23              "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
    1.24                 class="externalDFN">entry script</a>'s <a href=
    1.25                 "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
    1.26 @@ -630,10 +627,14 @@
    1.27              "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
    1.28                 class="externalDFN">entry script</a>'s <a href=
    1.29                 "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
    1.30 -               class="externalDFN">origin</a> then the <a>user agent</a> <em class="ct">MUST</em> remove all previously
    1.31 -               whitelisted urls from the <a>entry script origin's URL whitelist</a>. There is no persistence to network
    1.32 -               service selections provided to a web page. It is not possible to access a previously white-listed
    1.33 -               networked service without the necessary user authorization in all of the following cases:
    1.34 +               class="externalDFN">origin</a> or permission to access a given networked service is revoked at any time
    1.35 +               by the platform or user then the <a>user agent</a> <em class="ct">MUST</em> remove its previously
    1.36 +               whitelisted urls from the <a>entry script origin's URL whitelist</a>.
    1.37 +          </p>
    1.38 +          <p>
    1.39 +            There is no implied persistence to networked service sharing provided to a web page. It MUST NOT be
    1.40 +            possible to access a previously white-listed networked service without user authorization in all of the
    1.41 +            following cases:
    1.42            </p>
    1.43            <ul>
    1.44              <li>If the current script is reloaded at any point in the same or different window.
    1.45 @@ -1804,22 +1805,21 @@
    1.46          Garbage collection
    1.47        </h3>
    1.48        <p>
    1.49 -        A user agent MUST only garbage collect a <a><code>NetworkServices</code></a> object and remove its entry from
    1.50 -        the <a>list of active service managers</a> when the user has navigated away from the <a href=
    1.51 -        "http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script"
    1.52 -           class="externalDFN">entry script</a>'s <a href=
    1.53 -           "http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin"
    1.54 -           class="externalDFN">origin</a> in which the current <a><code>NetworkServices</code></a> object was provided.
    1.55 +        There is an <dfn>implied strong reference</dfn> from any IDL attribute in this API that returns a pre-existing
    1.56 +        object to that object.
    1.57 +      </p>
    1.58 +      <p class="note">
    1.59 +        For example, if a <a><code>NetworkServices</code></a> object has one or more <a>indexed properties</a> attached
    1.60 +        to it then there is a strong reference from that <a><code>NetworkServices</code></a> object toward each of its
    1.61 +        <a>indexed properties</a>.
    1.62        </p>
    1.63        <p>
    1.64 -        A user agent MUST NOT garbage collect individual <a><code>NetworkService</code></a> objects until their parent
    1.65 -        <a><code>NetworkServices</code></a> object has been garbage collected.
    1.66 -      </p>
    1.67 -      <p>
    1.68 -        A user agent MUST garbage collect the <a><code>NetworkService</code></a> <a>indexed properties</a> of a
    1.69 -        <a><code>NetworkServices</code></a> object, passing each indexed property's <code>id</code> attribute as the
    1.70 -        only argument to the rule for <a>removing an available service</a>, when that
    1.71 -        <a><code>NetworkServices</code></a> object itself has been garbage-collected.
    1.72 +        If a <a>user agent</a> is to <dfn>make disappear</dfn> a <a><code>NetworkServices</code></a> object (this
    1.73 +        happens when a <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#document"
    1.74 +           class="externalDFN"><code>Document</code></a> object goes away), the <a>user agent</a> MUST remove this
    1.75 +           object from the <a>list of active service managers</a> and remove the <a href=
    1.76 +           "#dom-networkservice-url"><code>url</code></a> of each of its <a>indexed properties</a> from the <a>entry
    1.77 +           script origin's URL whitelist</a>.
    1.78        </p>
    1.79      </section>
    1.80      <section>