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 glib-Basic-Types SYSTEM "xml/types.xml">
   5 <!ENTITY glib-Limits-of-Basic-Types SYSTEM "xml/limits.xml">
   6 <!ENTITY glib-Standard-Macros SYSTEM "xml/macros.xml">
   7 <!ENTITY glib-Type-Conversion-Macros SYSTEM "xml/type_conversion.xml">
   8 <!ENTITY glib-Byte-Order-Macros SYSTEM "xml/byte_order.xml">
   9 <!ENTITY glib-Numerical-Definitions SYSTEM "xml/numerical.xml">
  10 <!ENTITY glib-Miscellaneous-Macros SYSTEM "xml/macros_misc.xml">
  11 <!ENTITY glib-Atomic-Operations SYSTEM "xml/atomic_operations.xml">
  12 <!ENTITY glib-Memory-Allocation SYSTEM "xml/memory.xml">
  13 <!ENTITY glib-Error-Reporting SYSTEM "xml/error_reporting.xml">
  14 <!ENTITY glib-Warnings-and-Assertions SYSTEM "xml/warnings.xml">
  15 <!ENTITY glib-Message-Logging SYSTEM "xml/messages.xml">
  16 <!ENTITY glib-Pattern-Matching SYSTEM "xml/patterns.xml">
  17 <!ENTITY glib-Timers SYSTEM "xml/timers.xml">
  18 <!ENTITY glib-String-Utility-Functions SYSTEM "xml/string_utils.xml">
  19 <!ENTITY glib-Character-Set-Conversion SYSTEM "xml/conversions.xml">
  20 <!ENTITY glib-Unicode-Manipulation SYSTEM "xml/unicode.xml">
  21 <!ENTITY glib-Random-Numbers SYSTEM "xml/random_numbers.xml">
  22 <!ENTITY glib-Miscellaneous-Utility-Functions SYSTEM "xml/misc_utils.xml">
  23 <!ENTITY glib-Date-and-Time-Functions SYSTEM "xml/date.xml">
  24 <!ENTITY glib-The-Main-Event-Loop SYSTEM "xml/main.xml">
  25 <!ENTITY glib-Threads SYSTEM "xml/threads.xml">
  26 <!ENTITY glib-Thread-Pools SYSTEM "xml/thread_pools.xml">
  27 <!ENTITY glib-Async-Queues SYSTEM "xml/async_queues.xml">
  28 <!ENTITY glib-IO-Channels SYSTEM "xml/iochannels.xml">
  29 <!ENTITY glib-Hook-Functions SYSTEM "xml/hooks.xml">
  30 <!ENTITY glib-Lexical-Scanner SYSTEM "xml/scanner.xml">
  31 <!ENTITY glib-Dynamic-Loading-of-Modules SYSTEM "xml/modules.xml">
  32 <!ENTITY glib-Automatic-String-Completion SYSTEM "xml/completion.xml">
  33 <!ENTITY glib-Windows-Compatibility-Functions SYSTEM "xml/windows.xml">
  34 <!ENTITY glib-Memory-Chunks SYSTEM "xml/memory_chunks.xml">
  35 <!ENTITY glib-Memory-Slices SYSTEM "xml/memory_slices.xml">
  36 <!ENTITY glib-Doubly-Linked-Lists SYSTEM "xml/linked_lists_double.xml">
  37 <!ENTITY glib-Singly-Linked-Lists SYSTEM "xml/linked_lists_single.xml">
  38 <!ENTITY glib-Double-ended-Queues SYSTEM "xml/queue.xml">
  39 <!ENTITY glib-Trash-Stacks SYSTEM "xml/trash_stack.xml">
  40 <!ENTITY glib-Hash-Tables SYSTEM "xml/hash_tables.xml">
  41 <!ENTITY glib-Strings SYSTEM "xml/strings.xml">
  42 <!ENTITY glib-String-Chunks SYSTEM "xml/string_chunks.xml">
  43 <!ENTITY glib-Arrays SYSTEM "xml/arrays.xml">
  44 <!ENTITY glib-Pointer-Arrays SYSTEM "xml/arrays_pointer.xml">
  45 <!ENTITY glib-Byte-Arrays SYSTEM "xml/arrays_byte.xml">
  46 <!ENTITY glib-Balanced-Binary-Trees SYSTEM "xml/trees-binary.xml">
  47 <!ENTITY glib-N-ary-Trees SYSTEM "xml/trees-nary.xml">
  48 <!ENTITY glib-Quarks SYSTEM "xml/quarks.xml">
  49 <!ENTITY glib-Keyed-Data-Lists SYSTEM "xml/datalist.xml">
  50 <!ENTITY glib-Datasets SYSTEM "xml/datasets.xml">
  51 <!ENTITY glib-Relations-and-Tuples SYSTEM "xml/relations.xml">
  52 <!ENTITY glib-Caches SYSTEM "xml/caches.xml">
  53 <!ENTITY glib-Memory-Allocators SYSTEM "xml/allocators.xml">
  54 <!ENTITY glib-Spawn SYSTEM "xml/spawn.xml">
  55 <!ENTITY glib-Fileutils SYSTEM "xml/fileutils.xml">
  56 <!ENTITY glib-Shell SYSTEM "xml/shell.xml">
  57 <!ENTITY glib-Option SYSTEM "xml/option.xml">
  58 <!ENTITY glib-Markup SYSTEM "xml/markup.xml">
  59 <!ENTITY glib-Keyfile SYSTEM "xml/keyfile.xml">
  60 <!ENTITY glib-Bookmarkfile SYSTEM "xml/bookmarkfile.xml">
  61 <!ENTITY glib-Base64 SYSTEM "xml/base64.xml">
  62 <!ENTITY glib-i18n SYSTEM "xml/i18n.xml">
  63 <!ENTITY glib-Version SYSTEM "xml/version.xml">
  64
  65 <!ENTITY glib-Compiling SYSTEM "compiling.sgml">
  66 <!ENTITY glib-Building SYSTEM "building.sgml">
  67 <!ENTITY glib-Cross SYSTEM "cross.sgml">
  68 <!ENTITY glib-Running SYSTEM "running.sgml">
  69 <!ENTITY glib-Resources SYSTEM "resources.sgml">
  70 <!ENTITY glib-Changes SYSTEM "changes.sgml">
  71
  72 <!ENTITY glib-gettextize SYSTEM "glib-gettextize.xml">
  73
  74 <!ENTITY version SYSTEM "version.xml">
  75 ]>
  76 <book id="index">
  77   <bookinfo>
  78     <title>GLib Reference Manual</title>
  79     <releaseinfo>for GLib &version;</releaseinfo>
  80   </bookinfo>
  81
  82   <chapter id="glib">
  83     <title>GLib Overview</title>
  84     <para>
  85 GLib is a general-purpose utility library, which provides many useful data
  86 types, macros, type conversions, string utilities, file utilities, a main
  87 loop abstraction, and so on. It works on many UNIX-like platforms, Windows,
  88 OS/2 and BeOS. GLib is released under the GNU Library General Public License
  89 (GNU LGPL).
  90     </para>
  91     <para>
  92 The general policy of GLib is that all functions are invisibly threadsafe with the
  93 exception of data structure manipulation functions, where, if you have two threads
  94 manipulating the <emphasis>same</emphasis> data structure, they must use a lock to
  95 synchronize their operation.
  96     </para>
  97
  98     &glib-Building;
  99     &glib-Cross;
 100     &glib-Compiling;
 101     &glib-Running;
 102     &glib-Changes;
 103     &glib-Resources;
 104
 105   </chapter>
 106
 107   <chapter id="glib-fundamentals">
 108     <title>GLib Fundamentals</title>
 109     &glib-Version;
 110     &glib-Basic-Types;
 111     &glib-Limits-of-Basic-Types;
 112     &glib-Standard-Macros;
 113     &glib-Type-Conversion-Macros;
 114     &glib-Byte-Order-Macros;
 115     &glib-Numerical-Definitions;
 116     &glib-Miscellaneous-Macros;
 117     &glib-Atomic-Operations;
 118   </chapter>
 119
 120   <chapter id="glib-core">
 121     <title>GLib Core Application Support</title>
 122     &glib-The-Main-Event-Loop;
 123     &glib-Threads;
 124     &glib-Thread-Pools;
 125     &glib-Async-Queues;
 126     &glib-Dynamic-Loading-of-Modules;
 127     &glib-Memory-Allocation;
 128     &glib-IO-Channels;
 129     &glib-Error-Reporting;
 130     &glib-Warnings-and-Assertions;
 131     &glib-Message-Logging;
 132   </chapter>
 133
 134   <chapter id="glib-utilities">
 135     <title>GLib Utilities</title>
 136     &glib-String-Utility-Functions;
 137     &glib-Character-Set-Conversion;
 138     &glib-Unicode-Manipulation;
 139     &glib-Base64;
 140     &glib-i18n;
 141     &glib-Date-and-Time-Functions;
 142     &glib-Random-Numbers;
 143     &glib-Hook-Functions;
 144     &glib-Miscellaneous-Utility-Functions;
 145     &glib-Lexical-Scanner;
 146     &glib-Automatic-String-Completion;
 147     &glib-Timers;
 148     &glib-Spawn;
 149     &glib-Fileutils;
 150     &glib-Shell;
 151     &glib-Option;
 152     &glib-Pattern-Matching;
 153     &glib-Markup;
 154     &glib-Keyfile;
 155     &glib-Bookmarkfile;
 156     &glib-Windows-Compatibility-Functions;
 157   </chapter>
 158
 159   <chapter id="glib-data-types">
 160     <title>GLib Data Types</title>
 161     &glib-Memory-Slices;
 162     &glib-Memory-Chunks;
 163     &glib-Doubly-Linked-Lists;
 164     &glib-Singly-Linked-Lists;
 165     &glib-Double-ended-Queues;
 166     &glib-Trash-Stacks;
 167     &glib-Hash-Tables;
 168     &glib-Strings;
 169     &glib-String-Chunks;
 170     &glib-Arrays;
 171     &glib-Pointer-Arrays;
 172     &glib-Byte-Arrays;
 173     &glib-Balanced-Binary-Trees;
 174     &glib-N-ary-Trees;
 175     &glib-Quarks;
 176     &glib-Keyed-Data-Lists;
 177     &glib-Datasets;
 178     &glib-Relations-and-Tuples;
 179     &glib-Caches;
 180     &glib-Memory-Allocators;
 181   </chapter>
 182
 183   <chapter id="tools">
 184     <title>GLib Tools</title>
 185
 186     &glib-gettextize;
 187   </chapter>
 188
 189   <index>
 190     <title>Index</title>
 191   </index>
 192   <index role="deprecated">
 193     <title>Index of deprecated symbols</title>
 194   </index>
 195   <index role="2.2">
 196     <title>Index of new symbols in 2.2</title>
 197   </index>
 198   <index role="2.4">
 199     <title>Index of new symbols in 2.4</title>
 200   </index>
 201   <index role="2.6">
 202     <title>Index of new symbols in 2.6</title>
 203   </index>
 204   <index role="2.8">
 205     <title>Index of new symbols in 2.8</title>
 206   </index>
 207   <index role="2.10">
 208     <title>Index of new symbols in 2.10</title>
 209   </index>
 210
 211 </book>