<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
  <bookinfo>
    <title>GUPnP Reference Manual</title>

    <releaseinfo>Version <xi:include href="version.xml" parse="text"/></releaseinfo>

    <copyright>
      <year>2007</year>
      <year>2008</year>
      <year>2009</year>
      <holder>OpenedHand Ltd</holder>
      <holder>Nokia Corporation</holder>
    </copyright>

    <legalnotice>
      <para>
        Permission is granted to copy, distribute and/or modify this
        document under the terms of the <citetitle>GNU Free
        Documentation License</citetitle>, Version 1.1 or any later
        version published by the Free Software Foundation with no
        Invariant Sections, no Front-Cover Texts, and no Back-Cover
        Texts. You may obtain a copy of the <citetitle>GNU Free
        Documentation License</citetitle> from the Free Software
        Foundation by visiting <ulink type="http"
        url="http://www.fsf.org">their Web site</ulink> or by writing
        to:

        <address>
          Free Software Foundation
          <street>51 Franklin Street</street>, Fifth Floor
          <city>Boston</city>, <state>MA</state> <postcode>02110-1335</postcode>,
          <country>USA</country>
        </address>
      </para>
    </legalnotice>
  </bookinfo>

  <part id="tutorial">
    <title>Tutorial</title>
    <xi:include href="overview.xml"/>
    <xi:include href="xml/client-tutorial.xml"/>
    <xi:include href="xml/server-tutorial.xml"/>
  </part>
  
  <part id="api">
    <title>Reference</title>
    
    <chapter id="api-device-info">
      <title>Device Information</title>
      
      <xi:include href="xml/gupnp-device-info.xml"/>
      <xi:include href="xml/gupnp-service-info.xml"/>
      <xi:include href="xml/gupnp-service-introspection.xml"/>
    </chapter>
    
    <chapter id="api-device-control">
      <title>Device Control</title>
      
      <xi:include href="xml/gupnp-control-point.xml"/>
      <xi:include href="xml/gupnp-device-proxy.xml"/>
      <xi:include href="xml/gupnp-service-proxy.xml"/>
    </chapter>
    
    <chapter id="api-device-impl">
      <title>Device Implementation</title>
      
      <xi:include href="xml/gupnp-device.xml"/>
      <xi:include href="xml/gupnp-root-device.xml"/>
      <xi:include href="xml/gupnp-service.xml"/>
    </chapter>

    <chapter id="api-context">
      <title>Network context handling</title>

      <xi:include href="xml/gupnp-context.xml"/>
      <xi:include href="xml/gupnp-context-manager.xml"/>
    </chapter>
    
    <chapter id="api-utility">
      <title>Utility Functions</title>
      
      <xi:include href="xml/gupnp-acl.xml"/>
      <xi:include href="xml/gupnp-white-list.xml"/>
      <xi:include href="xml/gupnp-resource-factory.xml"/>
      <xi:include href="xml/gupnp-xml-doc.xml"/>
      <xi:include href="xml/gupnp-error.xml"/>
      <xi:include href="xml/gupnp-types.xml"/>
      <xi:include href="xml/gupnp-misc.xml"/>
    </chapter>

    <chapter id="api-tools">
      <title>Tools</title>
      <xi:include href="gupnp-binding-tool.xml"/>
    </chapter>
  </part>

  <part id="schemas">
    <title>XML Schemas</title>
    <chapter id="schemas-device">
      <title>Device Description</title>
      <para>
        This is the schema for the UPnP Device Description document, in the
        RELAX NG Compact syntax.
      </para>
      <programlisting><xi:include href="device-description.rnc" parse="text"/></programlisting>
    </chapter>
    <chapter id="schemas-service">
      <title>Service Description</title>
      <para>
        This is the schema for the UPnP Service Description document, in the
        RELAX NG Compact syntax.
      </para>
      <programlisting><xi:include href="service-description.rnc" parse="text"/></programlisting>
    </chapter>
  </part>

  <xi:include href="glossary.xml"/>

  <index id="api-index-full">
    <title>Index of all symbols</title>
    <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-deprecated" role="deprecated">
    <title>Index of deprecated symbols</title>
    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-12-3" role="0.12.3">
    <title>Index of new symbols in 0.12.3</title>
    <xi:include href="xml/api-index-0.12.3.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-13-0" role="0.13.0">
    <title>Index of new symbols in 0.13.0</title>
    <xi:include href="xml/api-index-0.13.0.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-13-3" role="0.13.3">
    <title>Index of new symbols in 0.13.3</title>
    <xi:include href="xml/api-index-0.13.3.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-17-0" role="0.17.0">
    <title>Index of new symbols in 0.17.0</title>
    <xi:include href="xml/api-index-0.17.0.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-17-2" role="0.17.2">
    <title>Index of new symbols in 0.17.2</title>
    <xi:include href="xml/api-index-0.17.2.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-19-1" role="0.19.1">
    <title>Index of new symbols in 0.19.1</title>
    <xi:include href="xml/api-index-0.19.1.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-19-2" role="0.19.2">
    <title>Index of new symbols in 0.19.2</title>
    <xi:include href="xml/api-index-0.19.2.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-3" role="0.20.3">
    <title>Index of new symbols in 0.20.3</title>
    <xi:include href="xml/api-index-0.20.3.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-4" role="0.20.4">
    <title>Index of new symbols in 0.20.4</title>
    <xi:include href="xml/api-index-0.20.4.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-5" role="0.20.5">
    <title>Index of new symbols in 0.20.5</title>
    <xi:include href="xml/api-index-0.20.5.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-8" role="0.20.8">
    <title>Index of new symbols in 0.20.8</title>
    <xi:include href="xml/api-index-0.20.8.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-9" role="0.20.9">
    <title>Index of new symbols in 0.20.9</title>
    <xi:include href="xml/api-index-0.20.9.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-11" role="0.20.11">
    <title>Index of new symbols in 0.20.11</title>
    <xi:include href="xml/api-index-0.20.11.xml"><xi:fallback /></xi:include>
  </index>

  <index id="api-index-0-20-12" role="0.20.12">
    <title>Index of new symbols in 0.20.12</title>
    <xi:include href="xml/api-index-0.20.12.xml"><xi:fallback /></xi:include>
  </index>

  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>

</book>