docs/reference/glib/glib-docs.sgml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
   4 <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
   5 <!ENTITY version SYSTEM "version.xml">
   6 ]>
   7 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
   8   <bookinfo>
   9     <title>GLib Reference Manual</title>
  10     <releaseinfo>
  11       for GLib &version;
  12       The latest version of this documentation can be found on-line at
  13       <ulink role="online-location" url="http://library.gnome.org/devel/glib/unstable/">http://library.gnome.org/devel/glib/unstable/</ulink>.
  14     </releaseinfo>
  15   </bookinfo>
  16
  17   <chapter id="glib">
  18     <title>GLib Overview</title>
  19     <para>
  20 GLib is a general-purpose utility library, which provides many useful data
  21 types, macros, type conversions, string utilities, file utilities, a main
  22 loop abstraction, and so on. It works on many UNIX-like platforms, Windows,
  23 OS/2 and BeOS. GLib is released under the GNU Library General Public License
  24 (GNU LGPL).
  25     </para>
  26     <para>
  27 The general policy of GLib is that all functions are invisibly threadsafe with the
  28 exception of data structure manipulation functions, where, if you have two threads
  29 manipulating the <emphasis>same</emphasis> data structure, they must use a lock to
  30 synchronize their operation.
  31     </para>
  32
  33     <xi:include href="building.sgml" />
  34     <xi:include href="cross.sgml" />
  35     <xi:include href="running.sgml" />
  36     <xi:include href="changes.sgml" />
  37     <xi:include href="regex-syntax.sgml" />
  38     <xi:include href="resources.sgml" />
  39
  40   </chapter>
  41
  42   <chapter id="glib-fundamentals">
  43     <title>GLib Fundamentals</title>
  44     <xi:include href="xml/version.xml" />
  45     <xi:include href="xml/types.xml" />
  46     <xi:include href="xml/limits.xml" />
  47     <xi:include href="xml/macros.xml" />
  48     <xi:include href="xml/type_conversion.xml" />
  49     <xi:include href="xml/byte_order.xml" />
  50     <xi:include href="xml/numerical.xml" />
  51     <xi:include href="xml/macros_misc.xml" />
  52     <xi:include href="xml/atomic_operations.xml" />
  53   </chapter>
  54
  55   <chapter id="glib-core">
  56     <title>GLib Core Application Support</title>
  57     <xi:include href="xml/main.xml" />
  58     <xi:include href="xml/threads.xml" />
  59     <xi:include href="xml/thread_pools.xml" />
  60     <xi:include href="xml/async_queues.xml" />
  61     <xi:include href="xml/modules.xml" />
  62     <xi:include href="xml/memory.xml" />
  63     <xi:include href="xml/iochannels.xml" />
  64     <xi:include href="xml/error_reporting.xml" />
  65     <xi:include href="xml/warnings.xml" />
  66     <xi:include href="xml/messages.xml" />
  67   </chapter>
  68
  69   <chapter id="glib-utilities">
  70     <title>GLib Utilities</title>
  71       <xi:include href="xml/string_utils.xml" />
  72       <xi:include href="xml/conversions.xml" />
  73       <xi:include href="xml/unicode.xml" />
  74       <xi:include href="xml/base64.xml" />
  75       <xi:include href="xml/checksum.xml" />
  76       <xi:include href="xml/i18n.xml" />
  77       <xi:include href="xml/date.xml" />
  78       <xi:include href="xml/random_numbers.xml" />
  79       <xi:include href="xml/hooks.xml" />
  80       <xi:include href="xml/misc_utils.xml" />
  81       <xi:include href="xml/scanner.xml" />
  82       <xi:include href="xml/completion.xml" />
  83       <xi:include href="xml/timers.xml" />
  84       <xi:include href="xml/spawn.xml" />
  85       <xi:include href="xml/fileutils.xml" />
  86       <xi:include href="xml/gurifuncs.xml" />
  87       <xi:include href="xml/ghostutils.xml" />
  88       <xi:include href="xml/shell.xml" />
  89       <xi:include href="xml/option.xml" />
  90       <xi:include href="xml/patterns.xml" />
  91       <xi:include href="xml/gregex.xml" />
  92       <xi:include href="xml/markup.xml" />
  93       <xi:include href="xml/keyfile.xml" />
  94       <xi:include href="xml/bookmarkfile.xml" />
  95       <xi:include href="xml/testing.xml" />
  96       <xi:include href="xml/windows.xml" />
  97   </chapter>
  98
  99   <chapter id="glib-data-types">
 100     <title>GLib Data Types</title>
 101       <xi:include href="xml/memory_slices.xml" />
 102       <xi:include href="xml/memory_chunks.xml" />
 103       <xi:include href="xml/linked_lists_double.xml" />
 104       <xi:include href="xml/linked_lists_single.xml" />
 105       <xi:include href="xml/queue.xml" />
 106       <xi:include href="xml/sequence.xml" />
 107       <xi:include href="xml/trash_stack.xml" />
 108       <xi:include href="xml/hash_tables.xml" />
 109       <xi:include href="xml/strings.xml" />
 110       <xi:include href="xml/string_chunks.xml" />
 111       <xi:include href="xml/arrays.xml" />
 112       <xi:include href="xml/arrays_pointer.xml" />
 113       <xi:include href="xml/arrays_byte.xml" />
 114       <xi:include href="xml/trees-binary.xml" />
 115       <xi:include href="xml/trees-nary.xml" />
 116       <xi:include href="xml/quarks.xml" />
 117       <xi:include href="xml/datalist.xml" />
 118       <xi:include href="xml/datasets.xml" />
 119       <xi:include href="xml/relations.xml" />
 120       <xi:include href="xml/caches.xml" />
 121       <xi:include href="xml/allocators.xml" />
 122       <xi:include href="xml/gvarianttype.xml"/>
 123       <xi:include href="xml/gvariant.xml"/>
 124   </chapter>
 125
 126   <chapter id="tools">
 127     <title>GLib Tools</title>
 128     <xi:include href="glib-gettextize.xml" />
 129     <xi:include href="gtester.xml" />
 130     <xi:include href="gtester-report.xml" />
 131   </chapter>
 132
 133   <index id="api-index-full">
 134     <title>Index</title>
 135     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
 136   </index>
 137   <index id="api-index-deprecated" role="deprecated">
 138     <title>Index of deprecated symbols</title>
 139     <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
 140   </index>
 141   <index id="api-index-2-2" role="2.2">
 142     <title>Index of new symbols in 2.2</title>
 143     <xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
 144   </index>
 145   <index id="api-index-2-4" role="2.4">
 146     <title>Index of new symbols in 2.4</title>
 147     <xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
 148   </index>
 149   <index id="api-index-2-6" role="2.6">
 150     <title>Index of new symbols in 2.6</title>
 151     <xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
 152   </index>
 153   <index id="api-index-2-8" role="2.8">
 154     <title>Index of new symbols in 2.8</title>
 155     <xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
 156   </index>
 157   <index id="api-index-2-10" role="2.10">
 158     <title>Index of new symbols in 2.10</title>
 159     <xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
 160   </index>
 161   <index id="api-index-2-12" role="2.12">
 162     <title>Index of new symbols in 2.12</title>
 163     <xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include>
 164   </index>
 165   <index id="api-index-2-14" role="2.14">
 166     <title>Index of new symbols in 2.14</title>
 167     <xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include>
 168   </index>
 169   <index id="api-index-2-16" role="2.16">
 170     <title>Index of new symbols in 2.16</title>
 171     <xi:include href="xml/api-index-2.16.xml"><xi:fallback /></xi:include>
 172   </index>
 173   <index id="api-index-2-18" role="2.18">
 174     <title>Index of new symbols in 2.18</title>
 175     <xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
 176   </index>
 177   <index id="api-index-2-20" role="2.20">
 178     <title>Index of new symbols in 2.20</title>
 179     <xi:include href="xml/api-index-2.20.xml"><xi:fallback /></xi:include>
 180   </index>
 181   <index id="api-index-2-22" role="2.22">
 182     <title>Index of new symbols in 2.22</title>
 183     <xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
 184   </index>
 185   <index id="api-index-2-24" role="2.24">
 186     <title>Index of new symbols in 2.24</title>
 187     <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
 188   </index>
 189
 190 </book>