discovery-api/Overview.src.html
author Dominique Hazael-Massieux <dom@w3.org>
Wed, 11 Jan 2017 10:30:32 +0100
changeset 594 ffb713303c21
parent 484 608edb43c84d
permissions -rw-r--r--
Shelve Network Service Discovery API

per https://lists.w3.org/Archives/Public/public-device-apis/2017Jan/0000.html
<!DOCTYPE html>
<!--

  THIS IS THE WORKING VERSION OF THE CURRENT SPECIFICATION!

  This specification is built using ReSpec.js <http://dev.w3.org/2009/dap/ReSpec.js/documentation.html>

  From time to time it's necessary to HTML5 Tidy this document using the tool @ <http://w3c.github.com/tidy-html5/>.

  The command used to format this document (Overview.src.html) is as follows (replacing all = signs with - signs!):

  @> tidy ==new-blocklevel-tags section ==char-encoding utf8 ==tidy-mark no ==indent yes ==indent-spaces 2 ==indent-attributes yes ==wrap 120 ==fix-bad-comments yes -m Overview.src.html

  To publish a new compiled version (Overview.html), we need to open this file (Overview.src.html) in any web browser.
  Once it has loaded we press 'Ctrl + Shift + S' (or 'Cmd' + 'Shift' + 'S' on Mac) and then select
  'Save as HTML (Source)' from the resulting menu.

  We then replace Overview.html with the produced HTML source of this process.

  Next we run HTML5 Tidy over our new Overview.html file with the following command (replacing all = signs with - signs!):

  @> tidy ==new-blocklevel-tags section ==char-encoding utf8 ==tidy-mark no ==indent yes ==indent-spaces 2 ==indent-attributes yes ==wrap 120 ==hide-comments yes -m Overview.html

  Now the specification is ready to be published :)

-->
<html>
  <head>
    <title>
      Network Service Discovery
    </title>
    <meta http-equiv='Content-Type'
          content='text/html; charset=utf-8'>
    <script type="text/javascript"
          class='remove'>
var respecConfig = {
          specStatus:   "ED",
          //publishDate:  "2013-09-05",
          shortName:    "discovery-api",
          edDraftURI:   "http://dvcs.w3.org/hg/dap/raw-file/tip/discovery-api/Overview.html",
          previousMaturity: "WD",
          previousPublishDate: "2014-02-20",
          editors: [
            {
              name:       "Rich Tibbett",
              //url:        "http://richt.me/",
              company:    "Opera Software ASA",
              companyURL: "http://opera.com/"
            }
          ],

          wg:           "Device and Sensors Working Group",
          wgURI:        "https://www.w3.org/2009/dap/",
          wgPublicList: "public-device-apis",
          wgPatentURI:  "https://www.w3.org/2004/01/pp-impl/43696/status",

    //          extraCSS:     ["http://dvcs.w3.org/hg/dap/raw-file/tip/discovery-api/css/respec.nsd.css"],
    //          inlineCSS:    true,
          noIDLIn:      true

      };
    </script>
    <script src='http://www.w3.org/Tools/respec/respec-w3c-common'
          type="text/javascript"
          class='remove'
          async="">
</script>
    <style>
/* Custom ReSpec CSS (by Rich Tibbett) */

     /* Add better spacing to sections */
     section, .section { margin-bottom: 2em; }

     /* Add addition spacing to <ol> and <ul> for rule definition */
     ol.rule li, ul.rule li { padding:0.6em; }

     pre.widl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
     pre.widl :link, pre.widl :visited { color: #000; background: transparent; }
     pre.widl:before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }

     div.example { border: solid thin black; background: #FFFFF0; color: black; padding: 0.5em 1em; position: relative; margin: 1em 0 1em 4.6em; width: auto; }
     div.example:before { content: "EXAMPLE"; font: bold small sans-serif; padding: 0.5em; background: white; color: black; position: absolute; top: 0; margin: -1px 0 0 -7.6em; width: 5em; border: thin solid black; border-radius: 0 0 0 0.5em }

     dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
     hr + dl.domintro, div.impl + dl.domintro { margin-top: 2.5em; margin-bottom: 1.5em; }
     dl.domintro dt, dl.domintro dt * { color: black; text-decoration: none; }
     dl.domintro dd { margin: 0.5em 0 1em 2em; padding: 0; }
     dl.domintro dd p { margin: 0.5em 0; }
     dl.domintro code {font-size: inherit; font-style: italic; }
     dl.domintro:before { display: table; margin: -1em -0.5em 0.5em auto; width: auto; content: 'This box is non-normative. Implementation requirements are given below this box.'; color: red; border: solid 2px; background: white; padding: 0 0.25em; font-size:0.8em; }

     table { border-collapse:collapse; border-style:hidden hidden none hidden }
     table thead { border-bottom:solid }
     table tbody th:first-child { border-left:solid }
     table td, table th { border-left:solid; border-right:solid; border-bottom:solid thin; vertical-align:top; padding:0.2em }
    </style>
    <script type="text/javascript"
          class="remove">
// RESPEC DEFINITIONS STYLE OVERLOAD
        window.addEventListener('load', function() {
          var overrideStyleEl = document.createElement('style');
          overrideStyleEl.textContent += "\n  a.externalDFN { color: #00C; border-bottom: 1px dashed #00C; }";
          overrideStyleEl.textContent += "\n  a.internalDFN { color: #00C; text-decoration: solid; }";
          document.querySelector('body').appendChild(overrideStyleEl);
        }, false);
    </script>
  </head>
  <body>
    <section id='abstract'>
      <p>
        This specification defines a mechanism for an HTML document to discover and subsequently communicate with
        <abbr title="Hypertext Transfer Protocol">HTTP</abbr>-based services advertised via common discovery protocols
        within the current network.
      </p>
    </section>
    <section id='sotd'>
      <p>
        <strong>Work on this document has been discontinued and it should not be referenced or used as a basis for implementation.</strong> The <a href="https://www.w3.org/TR/presentation-api/">Presentation API</a> and the <a href="https://www.w3.org/TR/remote-playback/">Remote Playback API</a> address a subset of the use cases this API attempted to address.
      </p>
    </section>
  </body>
</html>