Move informative text introducing NSD events to Introduction section
authorRich Tibbett <richt@opera.com>
Wed, 27 Feb 2013 15:27:46 +0100
changeset 397 7d43f1efc56f
parent 396 1375b4c4b759
child 398 19eb703af1c9
Move informative text introducing NSD events to Introduction section
discovery-api/Overview.src.html
--- a/discovery-api/Overview.src.html	Mon Feb 25 13:06:28 2013 +0200
+++ b/discovery-api/Overview.src.html	Wed Feb 27 15:27:46 2013 +0100
@@ -148,6 +148,10 @@
         messaging format supported by the Local-networked Device, if such event subscription functionality is provided
         by the connected Local-networked Service.
       </p>
+      <p>
+        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=
+        "#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method defined herein).
+      </p>
       <div class="example">
         <p>
           Example of requesting a DNS-SD advertised service:
@@ -652,6 +656,7 @@
 "http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#interface-eventtarget"
      class="externalDFN">EventTarget</a>;
 </pre>
+
       <section>
         <h2>
           Attributes
@@ -751,14 +756,6 @@
           <var>id</var> argument provided. When no <a href="#networkservice"><code>NetworkService</code></a> objects
           match the given argument, the method MUST return null.
         </p>
-        <p>
-          Services available within the local network can connect and disconnect at different times during the
-          execution of a web page. A <a>user agent</a> can inform a web page when the state of networked services
-          matching the requested <a>valid service type</a> 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=
-          "#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method.
-        </p>
       </section>
       <section>
         <h2>
@@ -1746,7 +1743,8 @@
       </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 when that <a><code>NetworkServices</code></a> object itself has been
+        <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.
       </p>
     </section>