<?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" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<book lang="en" id="gio" xmlns:xi="http://www.w3.org/2003/XInclude">
<title>GIO Reference Manual</title>
  <bookinfo>
    <title>GIO Reference Manual</title>
    <releaseinfo>
      for GIO &version;
      The latest version of this documentation can be found on-line at
      <ulink role="online-location" url="http://library.gnome.org/devel/gio/unstable/">http://library.gnome.org/devel/gio/unstable/</ulink>.
    </releaseinfo>
  </bookinfo>

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

  <part>
  <title>API Reference</title>
    <chapter id="file_ops">
        <title>File Operations</title>
        <xi:include href="xml/gfile.xml"/>
        <xi:include href="xml/gfileattribute.xml"/>
        <xi:include href="xml/gfileinfo.xml"/>
        <xi:include href="xml/gfileenumerator.xml"/>
        <xi:include href="xml/gioerror.xml"/>
        <xi:include href="xml/gmountoperation.xml"/>
    </chapter>
    <chapter id="file_mon">
        <title>File System Monitoring</title>
        <xi:include href="xml/gfilemonitor.xml"/>
    </chapter>
    <chapter id="async">
        <title>Asynchronous I/O</title>
        <xi:include href="xml/gcancellable.xml"/>
        <xi:include href="xml/gasyncresult.xml"/>
        <xi:include href="xml/gioscheduler.xml"/>
        <xi:include href="xml/gsimpleasyncresult.xml"/>
    </chapter>
    <chapter id="conversion">
        <title>Data conversion</title>
        <xi:include href="xml/gconverter.xml"/>
        <xi:include href="xml/gcharsetconverter.xml"/>
        <xi:include href="xml/gzcompressor.xml"/>
        <xi:include href="xml/gzdecompressor.xml"/>
    </chapter>
    <chapter id="streaming">
        <title>Streaming I/O</title>
        <xi:include href="xml/gseekable.xml"/>
        <xi:include href="xml/ginputstream.xml"/>
        <xi:include href="xml/goutputstream.xml"/>
        <xi:include href="xml/giostream.xml"/>
        <xi:include href="xml/gfileinputstream.xml"/>
        <xi:include href="xml/gfileoutputstream.xml"/>
        <xi:include href="xml/gfileiostream.xml"/>
        <xi:include href="xml/gfiledescriptorbased.xml"/>
        <xi:include href="xml/gfilterinputstream.xml"/>
        <xi:include href="xml/gfilteroutputstream.xml"/>
        <xi:include href="xml/gmemoryinputstream.xml"/>
        <xi:include href="xml/gmemoryoutputstream.xml"/>
        <xi:include href="xml/gbufferedinputstream.xml"/>
        <xi:include href="xml/gbufferedoutputstream.xml"/>
        <xi:include href="xml/gdatainputstream.xml"/>
        <xi:include href="xml/gdataoutputstream.xml"/>
        <xi:include href="xml/gunixinputstream.xml"/>
        <xi:include href="xml/gunixoutputstream.xml"/>
        <xi:include href="xml/gconverterinputstream.xml"/>
        <xi:include href="xml/gconverteroutputstream.xml"/>
    </chapter>
    <chapter id="types">
        <title>File types and applications</title>
        <xi:include href="xml/gcontenttype.xml"/>
        <xi:include href="xml/gappinfo.xml"/>
        <xi:include href="xml/gdesktopappinfo.xml"/>
    </chapter>
    <chapter id="volume_mon">
        <title>Volumes and Drives</title>
        <xi:include href="xml/gvolumemonitor.xml"/>
        <xi:include href="xml/gvolume.xml"/>
        <xi:include href="xml/gmount.xml"/>
        <xi:include href="xml/gdrive.xml"/>
        <xi:include href="xml/gunixmounts.xml"/>
    </chapter>
    <chapter id="icons">
        <title>Icons</title>
        <xi:include href="xml/gicon.xml"/>
        <xi:include href="xml/gfileicon.xml"/>
        <xi:include href="xml/gloadableicon.xml"/>
        <xi:include href="xml/gthemedicon.xml"/>
        <xi:include href="xml/gemblemedicon.xml"/>
        <xi:include href="xml/gemblem.xml"/>
    </chapter>
    <chapter id="failable_initialization">
        <title>Failable Initialization</title>
        <xi:include href="xml/ginitable.xml"/>
        <xi:include href="xml/gasyncinitable.xml"/>
    </chapter>
    <chapter id="networking">
      <title>Lowlevel network support</title>
      <xi:include href="xml/gsocket.xml"/>
      <xi:include href="xml/ginetaddress.xml"/>
      <xi:include href="xml/gsocketaddress.xml"/>
      <xi:include href="xml/ginetsocketaddress.xml"/>
      <xi:include href="xml/gunixsocketaddress.xml"/>
      <xi:include href="xml/gsocketcontrolmessage.xml"/>
      <xi:include href="xml/gunixfdlist.xml"/>
      <xi:include href="xml/gunixfdmessage.xml"/>
      <xi:include href="xml/gcredentials.xml"/>
      <xi:include href="xml/gunixcredentialsmessage.xml"/>
      <xi:include href="xml/gproxy.xml"/>
      <xi:include href="xml/gproxyaddress.xml"/>
    </chapter>
    <chapter id="highlevel-socket">
      <title>Highlevel network functionallity</title>
      <xi:include href="xml/gsocketclient.xml"/>
      <xi:include href="xml/gsocketconnection.xml"/>
      <xi:include href="xml/gunixconnection.xml"/>
      <xi:include href="xml/gtcpconnection.xml"/>
      <xi:include href="xml/gsocketlistener.xml"/>
      <xi:include href="xml/gsocketservice.xml"/>
      <xi:include href="xml/gthreadedsocketservice.xml"/>
    </chapter>
    <chapter id="resolver">
      <title>DNS resolution</title>
      <xi:include href="xml/gresolver.xml"/>
      <xi:include href="xml/gproxyresolver.xml"/>
      <xi:include href="xml/gsocketconnectable.xml"/>
      <xi:include href="xml/gnetworkaddress.xml"/>
      <xi:include href="xml/gnetworkservice.xml"/>
      <xi:include href="xml/gsrvtarget.xml"/>
    </chapter>
    <chapter id="gdbus-lowlevel">
      <title>Lowlevel D-Bus Support</title>
      <xi:include href="xml/gdbusutils.xml"/>
      <xi:include href="xml/gdbusaddress.xml"/>
      <xi:include href="xml/gdbusintrospection.xml"/>
      <xi:include href="xml/gdbuserror.xml"/>
      <xi:include href="xml/gdbusmessage.xml"/>
      <xi:include href="xml/gdbusconnection.xml"/>
      <xi:include href="xml/gdbusmethodinvocation.xml"/>
      <xi:include href="xml/gdbusserver.xml"/>
      <xi:include href="xml/gdbusauthobserver.xml"/>
    </chapter>
    <chapter id="gdbus-convenience">
      <title>Highlevel D-Bus Support</title>
      <xi:include href="xml/gdbusnameowning.xml"/>
      <xi:include href="xml/gdbusnamewatching.xml"/>
      <xi:include href="xml/gdbusproxy.xml"/>
    </chapter>
    <chapter id="utils">
        <title>Utilities</title>
        <xi:include href="xml/gfilenamecompleter.xml"/>
    </chapter>
    <chapter id="settings">
        <title>Settings</title>
        <xi:include href="xml/gsettings.xml"/>
        <xi:include href="xml/gsettingsbackend.xml"/>
    </chapter>
    <chapter id='permissions'>
        <title>Permissions</title>
        <xi:include href="xml/gpermission.xml"/>
        <xi:include href="xml/gsimplepermission.xml"/>
    </chapter>
    <chapter id="application">
        <title>Application support</title>
        <xi:include href="xml/gactiongroup.xml"/>
        <xi:include href="xml/gsimpleactiongroup.xml"/>
        <xi:include href="xml/gaction.xml"/>
        <xi:include href="xml/gsimpleaction.xml"/>
        <xi:include href="xml/gapplication.xml"/>
        <xi:include href="xml/gapplicationcommandline.xml"/>
    </chapter>
    <chapter id="periodic">
        <title>Periodic Timer</title>
        <xi:include href="xml/gperiodic.xml"/>
    </chapter>
    <chapter id="extending">
        <title>Extending GIO</title>
        <xi:include href="xml/gvfs.xml"/>
        <xi:include href="xml/giomodule.xml"/>
        <xi:include href="xml/extensionpoints.xml"/>
    </chapter>
    <chapter id="tools">
        <title>GIO Tools</title>
        <xi:include href="gio-querymodules.xml"/>
        <xi:include href="gsettings.xml"/>
        <xi:include href="glib-compile-schemas.xml"/>
        <xi:include href="gdbus.xml"/>
    </chapter>
  </part>

  <part id="migrating">
    <title>Migrating to GIO</title>
    <xi:include href="xml/migrating-posix.xml"/>
    <xi:include href="xml/migrating-gnome-vfs.xml"/>
    <xi:include href="xml/migrating-gconf.xml"/>
    <xi:include href="xml/migrating-gdbus.xml"/>
  </part>

  <chapter id="gio-hierarchy">
    <title>Object Hierarchy</title>
      <xi:include href="xml/tree_index.sgml"/>
  </chapter>
  
  <index id="api-index-full">
    <title id="index-all">Index</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-2-18" role="2.18">
    <title>Index of new symbols in 2.18</title>
    <xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-2-20" role="2.20">
    <title>Index of new symbols in 2.20</title>
    <xi:include href="xml/api-index-2.20.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-2-22" role="2.22">
    <title>Index of new symbols in 2.22</title>
    <xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-2-24" role="2.24">
    <title>Index of new symbols in 2.24</title>
    <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
  </index>
  <index id="api-index-2-26" role="2.26">
    <title>Index of new symbols in 2.26</title>
    <xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
  </index>

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

</book>
