dap commit: Clarify in Section 7.2 that only a UPnP service type token can be used and the user agent must strip the preceeding string 'upnp:' from that UPnP service type token before initiating a network search.

changeset:   391:8621c3c1faf5
tag:         tip
user:        Rich Tibbett <richt@opera.com>
date:        Fri Feb 08 15:49:52 2013 +0100
files:       discovery-api/Overview.html discovery-api/Overview.src.html
description:
Clarify in Section 7.2 that only a UPnP service type token can be used and the user agent must strip the preceeding string 'upnp:' from that UPnP service type token before initiating a network search.


diff -r 6211d232766d -r 8621c3c1faf5 discovery-api/Overview.html
--- a/discovery-api/Overview.html	Fri Feb 08 15:23:08 2013 +0100
+++ b/discovery-api/Overview.html	Fri Feb 08 15:49:52 2013 +0100
@@ -1802,7 +1802,12 @@
              class="internalDFN">user agent</a> must also send an ST header with this <abbr title=
              "Hypertext Transfer Protocol">HTTP</abbr> request equal to the String value of <code>ssdp:all</code> or
              <code>upnp:rootdevice</code> or a single <a href="#dfn-valid-service-type"
-             class="internalDFN">valid service type</a> token. The user-agent <em class="rfc2119"
+             class="internalDFN">valid service type</a> token beginning with the String value <code>upnp:</code>. If a
+             single <a href="#dfn-valid-service-type"
+             class="internalDFN">valid service type</a> token beginning with the String value <code>upnp:</code> is to
+             be used, the user agent <em class="rfc2119"
+             title="must">must</em> strip the leading String <code>upnp:</code> before using this value in this
+             <abbr title="Hypertext Transfer Protocol">HTTP</abbr> request. The user-agent <em class="rfc2119"
              title="must">must</em> also send an MX header equal to a <dfn id=
              "dfn-maximum-upnp-advertisement-response-wait-time">maximum UPnP advertisement response wait time</dfn>
              value between <code>1</code> and <code>5</code> seconds with this <abbr title=
diff -r 6211d232766d -r 8621c3c1faf5 discovery-api/Overview.src.html
--- a/discovery-api/Overview.src.html	Fri Feb 08 15:23:08 2013 +0100
+++ b/discovery-api/Overview.src.html	Fri Feb 08 15:49:52 2013 +0100
@@ -1243,8 +1243,11 @@
           the reserved multicast address and port of <code>239.255.255.250:1900</code> and a MAN header equal to
           <code>ssdp:discover</code>. The <a>user agent</a> must also send an ST header with this HTTP request equal to
           the String value of <code>ssdp:all</code> or <code>upnp:rootdevice</code> or a single <a>valid service
-          type</a> token. The user-agent MUST also send an MX header equal to a <dfn>maximum UPnP advertisement
-          response wait time</dfn> value between <code>1</code> and <code>5</code> seconds with this HTTP request.
+          type</a> token beginning with the String value <code>upnp:</code>. If a single <a>valid service type</a>
+          token beginning with the String value <code>upnp:</code> is to be used, the user agent MUST strip the leading
+          String <code>upnp:</code> before using this value in this HTTP request. The user-agent MUST also send an MX
+          header equal to a <dfn>maximum UPnP advertisement response wait time</dfn> value between <code>1</code> and
+          <code>5</code> seconds with this HTTP request.
         </p>
         <p>
           The user agent MUST listen for any incoming responses to any <a>search request for UPnP root devices</a>.

Received on Friday, 8 February 2013 14:49:53 UTC