<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<book id="index">
  <bookinfo>
    <title>Grilo Reference Manual</title>
    <releaseinfo>
      The latest version of this software can be found on-line at
      <ulink role="online-location" url="http://git.gnome.org/browse/grilo">http://git.gnome.org/browse/grilo</ulink>
      and 
      <ulink role="online-location" url="http://git.gnome.org/browse/grilo-plugins">http://git.gnome.org/browse/grilo-plugins</ulink>.
    </releaseinfo>
  </bookinfo>

  <preface>
    <title>Overview</title>
    <xi:include href="overview.xml"/>
  </preface>

  <reference>
    <title>Tutorial</title>

    <chapter>
    <title>Quick start guide</title>
    <xi:include href="quick-start.xml"/>
    </chapter>

    <chapter>
    <title>Environment Setup</title>
    <xi:include href="environment-setup.xml"/>
    </chapter>

    <chapter>
    <title>Writing applications with Grilo</title>
    <xi:include href="writing-apps.xml"/>
    </chapter>

    <chapter>
      <title>Writing plugins for Grilo</title>
      <section id="writing-plugins">
        <section id="media-source-plugins">
          <title>Source plugins</title>
          <xi:include href="plugins-sources.xml"/>
        </section>
        <section id="testing-plugins">
          <title>Testing your plugins</title>
          <xi:include href="plugins-testing.xml"/>
        </section>
      </section>
    </chapter>
  </reference>

  <reference>
    <title>Object Index</title>
    <xi:include href="xml/tree_index.sgml"/>
  </reference>

  <reference>
    <title>API Reference</title>

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

    <chapter id="plugin-management">
      <title>Plug-in management</title>
      <xi:include href="xml/grl-registry.xml"/>
    </chapter>

    <chapter id="sources">
      <title>Data sources</title>
      <xi:include href="xml/grl-plugin.xml"/>
      <xi:include href="xml/grl-source.xml"/>
    </chapter>

    <chapter id="caps-options">
    <title>Capabilities and Options</title>
      <xi:include href="xml/grl-caps.xml"/>
      <xi:include href="xml/grl-operation-options.xml"/>
    </chapter>

    <chapter id="multiple">
      <title>Search in multiple sources</title>
      <xi:include href="xml/grl-multiple.xml"/>
    </chapter>

    <chapter id="configure">
      <title>Configuring plug-ins</title>
      <xi:include href="xml/grl-config.xml"/>
    </chapter>

    <chapter id="data">
      <title>Media data</title>
      <xi:include href="xml/grl-data.xml"/>
      <xi:include href="xml/grl-related-keys.xml"/>
      <xi:include href="xml/grl-media.xml"/>
    </chapter>

    <chapter id="misc">
      <title>Misc</title>
      <xi:include href="xml/grl-metadata-key.xml"/>
      <xi:include href="xml/grl-log.xml"/>
      <xi:include href="xml/grl-error.xml"/>
      <xi:include href="xml/grl-definitions.xml"/>
      <xi:include href="xml/grl-operation.xml"/>
      <xi:include href="xml/grl-util.xml"/>
    </chapter>
  </reference>

    <reference>
      <title>Grilo Libraries</title>

      <para>
        To ease the creation of plugins, a library system was created. The most common
        functions for a plugin can be found in a library.
      </para>
      <para>
        Grilo provides some standard libraries you can use to create plugins.
      </para>

      <chapter id="grilo-net">
        <title>Grilo Net Classes</title>
        <xi:include href="xml/grl-net-wc.xml"/>
      </chapter>

      <chapter id="grilo-pls">
        <title>Grilo Playlist Functions</title>
        <xi:include href="xml/grl-pls.xml"/>
      </chapter>
    </reference>

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

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