Move informative text introducing NSD events to Introduction section
authorRich Tibbett <richt@opera.com>
Wed, 27 Feb 2013 15:27:46 +0100
changeset 3977d43f1efc56f
parent 396 1375b4c4b759
child 398 19eb703af1c9
Move informative text introducing NSD events to Introduction section
discovery-api/Overview.src.html
     1.1 --- a/discovery-api/Overview.src.html	Mon Feb 25 13:06:28 2013 +0200
     1.2 +++ b/discovery-api/Overview.src.html	Wed Feb 27 15:27:46 2013 +0100
     1.3 @@ -148,6 +148,10 @@
     1.4          messaging format supported by the Local-networked Device, if such event subscription functionality is provided
     1.5          by the connected Local-networked Service.
     1.6        </p>
     1.7 +      <p>
     1.8 +        Services available within the local network can connect and disconnect at different times during the execution of a web page. The user agent can inform a web page when the state of networked services matching any of the requested valid service types change. Web pages can use this information to enable in-page experiences for communicating the state of networked services with the ability to change the particular service or set of services the page is connected to (by re-invoking the <a href=
     1.9 +        "#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method defined herein).
    1.10 +      </p>
    1.11        <div class="example">
    1.12          <p>
    1.13            Example of requesting a DNS-SD advertised service:
    1.14 @@ -652,6 +656,7 @@
    1.15  "http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#interface-eventtarget"
    1.16       class="externalDFN">EventTarget</a>;
    1.17  </pre>
    1.18 +
    1.19        <section>
    1.20          <h2>
    1.21            Attributes
    1.22 @@ -751,14 +756,6 @@
    1.23            <var>id</var> argument provided. When no <a href="#networkservice"><code>NetworkService</code></a> objects
    1.24            match the given argument, the method MUST return null.
    1.25          </p>
    1.26 -        <p>
    1.27 -          Services available within the local network can connect and disconnect at different times during the
    1.28 -          execution of a web page. A <a>user agent</a> can inform a web page when the state of networked services
    1.29 -          matching the requested <a>valid service type</a> change. Web pages can use this information to enable in-page
    1.30 -          experiences for communicating the state of networked services with the ability to change the particular
    1.31 -          service or set of services the page is connected to by re-invoking the <a href=
    1.32 -          "#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method.
    1.33 -        </p>
    1.34        </section>
    1.35        <section>
    1.36          <h2>
    1.37 @@ -1746,7 +1743,8 @@
    1.38        </p>
    1.39        <p>
    1.40          A user agent MUST garbage collect the <a><code>NetworkService</code></a> <a>indexed properties</a> of a
    1.41 -        <a><code>NetworkServices</code></a> object when that <a><code>NetworkServices</code></a> object itself has been
    1.42 +        <a><code>NetworkServices</code></a> object, passing each indexed property's <code>id</code> attribute as the
    1.43 +        only argument to the rule for <a>removing an available service<a>, when that <a><code>NetworkServices</code></a> object itself has been
    1.44          garbage-collected.
    1.45        </p>
    1.46      </section>