Updates to Service Discovery & Messaging according to feedback @ http://lists.w3.org/Archives/Public/public-device-apis/2012Aug/0095.html
authorRich Tibbett <richt@opera.com>
Tue, 25 Sep 2012 13:33:45 +0200
changeset 231a0e6b501258d
parent 230 3c13dc93cfb1
child 232 32487cf058c5
Updates to Service Discovery & Messaging according to feedback @ http://lists.w3.org/Archives/Public/public-device-apis/2012Aug/0095.html
discovery-api/Overview.html
discovery-api/Overview.src.html
     1.1 --- a/discovery-api/Overview.html	Tue Sep 25 12:48:42 2012 +0200
     1.2 +++ b/discovery-api/Overview.html	Tue Sep 25 13:33:45 2012 +0200
     1.3 @@ -673,7 +673,7 @@
     1.4              </li>
     1.5  
     1.6              <li>
     1.7 -               Set <var>services manager</var>'s <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute to the length of <var>services</var>.
     1.8 +               Set <var>services manager</var>'s <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute to the number of services currently found in the <a href="#dfn-list-of-available-service-records" class="internalDFN">list of available service records</a> whose <code>type</code> property matches any of the tokens requested in <var>requested control types</var>.
     1.9              </li>
    1.10  
    1.11              <li>
    1.12 @@ -805,7 +805,8 @@
    1.13            </dt>
    1.14            <dd>
    1.15              <p>
    1.16 -              Returns the current number of services matching one of the app-requested <a href="#dfn-valid-service-type" class="internalDFN">valid service type</a> tokens that are actively available within the user's current network.
    1.17 +              Returns the current number of services matching one of the app-requested <a href="#dfn-valid-service-type" class="internalDFN">valid service type</a> tokens in the
    1.18 +              <a href="#dfn-list-of-available-service-records" class="internalDFN">list of available service records</a>.
    1.19              </p>
    1.20            </dd>
    1.21          </dl>
    1.22 @@ -816,25 +817,9 @@
    1.23             </p>
    1.24  
    1.25             <p>
    1.26 -              The <dfn id="dom-networkservices-servicesavailable"><code>servicesAvailable</code></dfn> attribute <em class="rfc2119" title="must">must</em> return the number of services available in the
    1.27 -              user's network that match the <a href="#dfn-valid-service-type" class="internalDFN">valid service type</a> that was initially used to create the current <a href="#networkservices"><code>NetworkServices</code></a> object.
    1.28 +              The <dfn id="dom-networkservices-servicesavailable"><code>servicesAvailable</code></dfn> attribute <em class="rfc2119" title="must">must</em> return the number of services in the <a href="#dfn-list-of-available-service-records" class="internalDFN">list of available service records</a> whose <code>type</code> attribute matches any of the <a href="#dfn-valid-service-type" class="internalDFN">valid service type</a> tokens that was initially used to create the current <a href="#networkservices"><code>NetworkServices</code></a> object.
    1.29             </p>
    1.30  
    1.31 -           <p>
    1.32 -             When a previously unknown instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes available on the user's current network, the <a href="#dfn-user-agent" class="internalDFN">user agent</a> <em class="rfc2119" title="must">must</em> increment the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
    1.33 -             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
    1.34 -             to dispatch a newly created event with the name <code>serviceavailable</code> that uses the <code>Event</code> interface, which does
    1.35 -             not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
    1.36 -             object.
    1.37 -           </p>
    1.38 -
    1.39 -           <p>
    1.40 -             When a previously known instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes unavailable on the user's current network, the <a href="#dfn-user-agent" class="internalDFN">user agent</a> <em class="rfc2119" title="must">must</em> decrement the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
    1.41 -             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
    1.42 -              to dispatch a newly created event with the name <code>serviceunavailable</code> that uses the <code>Event</code> interface, which does
    1.43 -              not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
    1.44 -              object.
    1.45 -           </p>
    1.46          </div>
    1.47  
    1.48        </section>
     2.1 --- a/discovery-api/Overview.src.html	Tue Sep 25 12:48:42 2012 +0200
     2.2 +++ b/discovery-api/Overview.src.html	Tue Sep 25 13:33:45 2012 +0200
     2.3 @@ -426,7 +426,7 @@
     2.4              </li>
     2.5  
     2.6              <li>
     2.7 -               Set <var>services manager</var>'s <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute to the length of <var>services</var>.
     2.8 +               Set <var>services manager</var>'s <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute to the number of services currently found in the <a>list of available service records</a> whose <code>type</code> property matches any of the tokens requested in <var>requested control types</var>.
     2.9              </li>
    2.10  
    2.11              <li>
    2.12 @@ -559,7 +559,8 @@
    2.13            </dt>
    2.14            <dd>
    2.15              <p>
    2.16 -              Returns the current number of services matching one of the app-requested <a>valid service type</a> tokens that are actively available within the user's current network.
    2.17 +              Returns the current number of services matching one of the app-requested <a>valid service type</a> tokens in the
    2.18 +              <a>list of available service records</a>.
    2.19              </p>
    2.20            </dd>
    2.21          </dl>
    2.22 @@ -570,25 +571,9 @@
    2.23             </p>
    2.24  
    2.25             <p>
    2.26 -              The <dfn id="dom-networkservices-servicesavailable"><code>servicesAvailable</code></dfn> attribute MUST return the number of services available in the
    2.27 -              user's network that match the <a>valid service type</a> that was initially used to create the current <a href="#networkservices"><code>NetworkServices</code></a> object.
    2.28 +              The <dfn id="dom-networkservices-servicesavailable"><code>servicesAvailable</code></dfn> attribute MUST return the number of services in the <a>list of available service records</a> whose <code>type</code> attribute matches any of the <a>valid service type</a> tokens that was initially used to create the current <a href="#networkservices"><code>NetworkServices</code></a> object.
    2.29             </p>
    2.30  
    2.31 -           <p>
    2.32 -             When a previously unknown instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes available on the user's current network, the <a>user agent</a> MUST increment the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
    2.33 -             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
    2.34 -             to dispatch a newly created event with the name <code>serviceavailable</code> that uses the <code>Event</code> interface, which does
    2.35 -             not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
    2.36 -             object.
    2.37 -           </p>
    2.38 -
    2.39 -           <p>
    2.40 -             When a previously known instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes unavailable on the user's current network, the <a>user agent</a> MUST decrement the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
    2.41 -             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
    2.42 -              to dispatch a newly created event with the name <code>serviceunavailable</code> that uses the <code>Event</code> interface, which does
    2.43 -              not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
    2.44 -              object.
    2.45 -           </p>
    2.46          </div>
    2.47  
    2.48        </section>