<?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>
          The Free Software Foundation, Inc.,
          <street>59 Temple Place</street> - Suite 330,
          <city>Boston</city>, <state>MA</state> <postcode>02111-1307</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-utility">
      <title>Utility Functions</title>
      
      <xi:include href="xml/gupnp-context.xml"/>
      <xi:include href="xml/gupnp-context-manager.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"/>
    </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"/>
  <xi:include href="xml/annotation-glossary.xml"/>

  <index/>

</book>
