<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
  <!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent">
  %gtkdocentities;
  <!ENTITY LIBGDA "libgda-6.0">
  <!ENTITY GDA             "<acronym>GDA</acronym>">
]>
<book id="index">
  <bookinfo>
    <title>&package_name; Reference Manual</title>
    <releaseinfo>
      The latest version of this documentation can be found on-line at the home
      <ulink role="online-location" url="https://gnome.pages.gitlab.gnome.org/libgda/C/libgda/">wiki</ulink> page.
    </releaseinfo>
    <xi:include href="author-list.xml"/>
    <date>&builddate;</date>
    <copyright>
      <year>1999 - 2020</year>
      <holder>&copy;</holder>
    </copyright>
    <abstract>
      <para>
        GNOME Data Access (&GDA;) is an architecture whose
        purpose is to provide universal access to many different kinds and
        types of data sources. This goes from traditional relational database
        systems, to any imaginable kind of data source such as a mail server,
        a &LDAP; directory...
      </para>
      <para>
        This universality is obtained through the use of
        an easily extensible plug-in system as the mechanism for
	communication between the different components in the architecture.
      </para>
    </abstract>
    <legalnotice id="legalnotice">
      <para>
        Permission is granted to copy, distribute and/or modify this document
        under the terms of the <link linkend="fdl"><citetitle>GNU
        Free Documentation License</citetitle></link>, 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.  A copy of the
        license can be found in <link linkend="fdl">the appendix</link>.
      </para>
      <para>
        Many of the names used by companies to distinguish their products and
        services are claimed as trademarks. Where those names appear in any
        GNOME documentation, and those trademarks are made aware to the members
        of the GNOME Documentation Project, the names have been printed in caps
        or initial caps.
      </para>
    </legalnotice>
  </bookinfo>

  <part id="Getting Started">
    <title>Getting Started</title>
    <xi:include href="introduction.xml"/>
    <xi:include href="xml/libgda.xml"/>
    <xi:include href="installation.xml"/>
  </part>

  <part id="api">
    <title>API Reference</title>

    <chapter id="Connection">
      <title>Connection</title>
      <xi:include href="xml/gda-connection.xml"/>
      <xi:include href="xml/gda-connection-event.xml"/>
      <xi:include href="xml/gda-xa-transaction.xml"/>
      <xi:include href="xml/gda-transaction-status.xml"/>
      <xi:include href="xml/gda-virtual-connection.xml"/>
      <xi:include href="xml/gda-vconnection-data-model.xml"/>
      <xi:include href="xml/gda-vconnection-hub.xml"/>
    </chapter>

    <chapter id="Provider">
      <title>Provider</title>
      <xi:include href="xml/gda-provider.xml"/>
      <xi:include href="xml/gda-server-provider.xml"/>
      <xi:include href="xml/gda-virtual-provider.xml"/>
      <xi:include href="xml/gda-vprovider-data-model.xml"/>
      <xi:include href="xml/gda-vprovider-hub.xml"/>
      <xi:include href="xml/provider-support.xml"/>
      <xi:include href="xml/provider-support-sql.xml"/>
    </chapter>

    <chapter id="Data Model">
      <title>Data Model</title>
      <xi:include href="xml/gda-data-model.xml"/>
      <xi:include href="xml/gda-data-model-array.xml"/>
      <xi:include href="xml/gda-data-model-dir.xml"/>
      <xi:include href="xml/gda-data-model-import.xml"/>
      <xi:include href="xml/gda-data-model-iter.xml"/>
      <xi:include href="xml/gda-data-access-wrapper.xml"/>
      <xi:include href="xml/gda-column.xml"/>
      <xi:include href="xml/gda-row.xml"/>
      <xi:include href="xml/gda-data-pivot.xml"/>
      <xi:include href="xml/gda-data-proxy.xml"/>
      <xi:include href="xml/gda-meta-store.xml"/>
      <xi:include href="xml/gda-meta-struct.xml"/>
<!--      <xi:include href="xml/gda-data-select.xml"/> -->
    </chapter>

    <chapter id="Data Handlers">
      <title>Data Handlers</title>
      <xi:include href="xml/gda-blob-op.xml"/>
      <xi:include href="xml/gda-value.xml"/>
      <xi:include href="xml/gda-holder.xml"/>
      <xi:include href="xml/gda-set.xml"/>
      <xi:include href="xml/gda-data-handler.xml"/>
      <xi:include href="xml/gda-data-comparator.xml"/>
      <xi:include href="xml/gda-handler-bin.xml"/>
      <xi:include href="xml/gda-handler-boolean.xml"/>
      <xi:include href="xml/gda-handler-numerical.xml"/>
      <xi:include href="xml/gda-handler-string.xml"/>
      <xi:include href="xml/gda-handler-time.xml"/>
      <xi:include href="xml/gda-handler-type.xml"/>
      <xi:include href="xml/gda-quark-list.xml"/>
      <xi:include href="xml/gda-attributes-manager.xml"/>
    </chapter>

    <chapter id="DDL and DB Catalog">
      <title>DB Catalog</title>
      <xi:include href="xml/gda-db-base.xml"/>
      <xi:include href="xml/gda-db-buildable.xml"/>
      <xi:include href="xml/gda-ddl-modifiable.xml"/>
      <xi:include href="xml/gda-db-column.xml"/>
      <xi:include href="xml/gda-db-catalog.xml"/>
      <xi:include href="xml/gda-db-fkey.xml"/>
      <xi:include href="xml/gda-db-table.xml"/>
      <xi:include href="xml/gda-db-view.xml"/>
      <xi:include href="xml/gda-db-index.xml"/>
      <xi:include href="xml/gda-db-index-field.xml"/>
    </chapter>

    <chapter id="Statement">
      <title>Statement</title>
      <xi:include href="xml/gda-pstmt.xml"/>
      <xi:include href="xml/gda-sql-parser.xml"/>
      <xi:include href="xml/gda-sql-builder.xml"/>
      <xi:include href="xml/gda-statement.xml"/>
      <xi:include href="xml/gda-sql-statement.xml"/>
      <xi:include href="xml/gda-repetitive-statement.xml"/>
      <xi:include href="xml/gda-batch.xml"/>
    </chapter>

    <chapter id="Tree Manager">
      <title>Tree Manager</title>
      <xi:include href="xml/gda-tree.xml"/>
      <xi:include href="xml/gda-tree-node.xml"/>
      <xi:include href="xml/gda-tree-manager.xml"/>
      <xi:include href="xml/gda-tree-mgr-columns.xml"/>
      <xi:include href="xml/gda-tree-mgr-label.xml"/>
      <xi:include href="xml/gda-tree-mgr-schemas.xml"/>
      <xi:include href="xml/gda-tree-mgr-select.xml"/>
      <xi:include href="xml/gda-tree-mgr-tables.xml"/>
    </chapter>

    <chapter id="Server Operation">
      <title>Server Operation</title>
      <xi:include href="xml/gda-server-operation.xml"/>
      <xi:include href="xml/gda-server-operation-nodes.xml"/>
      <xi:include href="xml/gda-server-operation-sequences.xml"/>
    </chapter>

    <chapter id="Report">
      <title>Report</title>
      <xi:include href="xml/gda-report-engine.xml"/>
      <xi:include href="xml/gda-report-document.xml"/>
      <xi:include href="xml/gda-report-rml-document.xml"/>
      <xi:include href="xml/gda-report-docbook-document.xml"/>
    </chapter>

    <chapter id="Utilities">
      <title>Utilities</title>
      <xi:include href="xml/gda-lockable.xml"/>
      <xi:include href="xml/gda-log.xml"/>
      <xi:include href="xml/gda-util.xml"/>

      <xi:include href="xml/gda-config.xml"/>
      <xi:include href="xml/gda-connect.xml"/>
      
      <xi:include href="xml/gda-worker.xml"/>
    </chapter>
  </part>

  <chapter id="object-tree">
    <title>Object Hierarchy</title>
    <xi:include href="xml/tree_index.sgml"/>
  </chapter>
  <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>
  <index id="api-index-6-0" role="6.0">
    <title>Index of new API in 6.0</title>
    <xi:include href="xml/api-index-6.0.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-5-2" role="5.2">
    <title>Index of new API in 5.2</title>
    <xi:include href="xml/api-index-5.2.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-5-2-0" role="5.2.0">
    <title>Index of new API in 5.2.0</title>
    <xi:include href="xml/api-index-5.2.0.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-5-0-2" role="5.0.2">
    <title>Index of new API in 5.0.2</title>
    <xi:include href="xml/api-index-5.0.2.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-5-0" role="5.0">
    <title>Index of new API in 5.0</title>
    <xi:include href="xml/api-index-5.0.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-10" role="4.2.10">
    <title>Index of new API in 4.2.10</title>
    <xi:include href="xml/api-index-4.2.10.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-9" role="4.2.9">
    <title>Index of new API in 4.2.9</title>
    <xi:include href="xml/api-index-4.2.9.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-8" role="4.2.8">
    <title>Index of new API in 4.2.8</title>
    <xi:include href="xml/api-index-4.2.8.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-6" role="4.2.6">
    <title>Index of new API in 4.2.6</title>
    <xi:include href="xml/api-index-4.2.6.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-4" role="4.2.4">
    <title>Index of new API in 4.2.4</title>
    <xi:include href="xml/api-index-4.2.4.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-3" role="4.2.3">
    <title>Index of new API in 4.2.3</title>
    <xi:include href="xml/api-index-4.2.3.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2-1" role="4.2.1">
    <title>Index of new API in 4.2.1</title>
    <xi:include href="xml/api-index-4.2.1.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-2" role="4.2">
    <title>Index of new API in 4.2</title>
    <xi:include href="xml/api-index-4.2.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-4-0-3" role="4.0.3">
    <title>Index of new API in 4.0.3</title>
    <xi:include href="xml/api-index-4.0.3.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-3-2" role="3.2">
    <title>Index of new API in 3.2</title>
    <xi:include href="xml/api-index-3.2.xml"><xi:fallback /></xi:include>
  </index>
  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</book>
