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-Sequences SYSTEM "xml/sequence.xml">
  40 <!ENTITY glib-Trash-Stacks SYSTEM "xml/trash_stack.xml">
  41 <!ENTITY glib-Hash-Tables SYSTEM "xml/hash_tables.xml">
  42 <!ENTITY glib-Strings SYSTEM "xml/strings.xml">
  43 <!ENTITY glib-String-Chunks SYSTEM "xml/string_chunks.xml">
  44 <!ENTITY glib-Arrays SYSTEM "xml/arrays.xml">
  45 <!ENTITY glib-Pointer-Arrays SYSTEM "xml/arrays_pointer.xml">
  46 <!ENTITY glib-Byte-Arrays SYSTEM "xml/arrays_byte.xml">
  47 <!ENTITY glib-Balanced-Binary-Trees SYSTEM "xml/trees-binary.xml">
  48 <!ENTITY glib-N-ary-Trees SYSTEM "xml/trees-nary.xml">
  49 <!ENTITY glib-Quarks SYSTEM "xml/quarks.xml">
  50 <!ENTITY glib-Keyed-Data-Lists SYSTEM "xml/datalist.xml">
  51 <!ENTITY glib-Datasets SYSTEM "xml/datasets.xml">
  52 <!ENTITY glib-Relations-and-Tuples SYSTEM "xml/relations.xml">
  53 <!ENTITY glib-Caches SYSTEM "xml/caches.xml">
  54 <!ENTITY glib-Memory-Allocators SYSTEM "xml/allocators.xml">
  55 <!ENTITY glib-Spawn SYSTEM "xml/spawn.xml">
  56 <!ENTITY glib-Fileutils SYSTEM "xml/fileutils.xml">
  57 <!ENTITY glib-Shell SYSTEM "xml/shell.xml">
  58 <!ENTITY glib-Option SYSTEM "xml/option.xml">
  59 <!ENTITY glib-Markup SYSTEM "xml/markup.xml">
  60 <!ENTITY glib-Keyfile SYSTEM "xml/keyfile.xml">
  61 <!ENTITY glib-Bookmarkfile SYSTEM "xml/bookmarkfile.xml">
  62 <!ENTITY glib-Base64 SYSTEM "xml/base64.xml">
  63 <!ENTITY glib-Checksum SYSTEM "xml/checksum.xml">
  64 <!ENTITY glib-i18n SYSTEM "xml/i18n.xml">
  65 <!ENTITY glib-Regex SYSTEM "xml/gregex.xml">
  66 <!ENTITY glib-Version SYSTEM "xml/version.xml">
  67 <!ENTITY glib-Uri SYSTEM "xml/gurifuncs.xml">
  68 <!ENTITY glib-Testing SYSTEM "xml/testing.xml">
  69 <!ENTITY glib-Hostutils SYSTEM "xml/ghostutils.xml">
  70
  71 <!ENTITY glib-Compiling SYSTEM "compiling.sgml">
  72 <!ENTITY glib-Building SYSTEM "building.sgml">
  73 <!ENTITY glib-Cross SYSTEM "cross.sgml">
  74 <!ENTITY glib-Running SYSTEM "running.sgml">
  75 <!ENTITY glib-Resources SYSTEM "resources.sgml">
  76 <!ENTITY glib-Changes SYSTEM "changes.sgml">
  77 <!ENTITY glib-RegexSyntax SYSTEM "regex-syntax.sgml">
  78
  79 <!ENTITY glib-gettextize SYSTEM "glib-gettextize.xml">
  80 <!ENTITY gtester SYSTEM "gtester.xml">
  81 <!ENTITY gtester-report SYSTEM "gtester-report.xml">
  82
  83 <!ENTITY version SYSTEM "version.xml">
  84 ]>
  85 <book id="index">
  86   <bookinfo>
  87     <title>GLib Reference Manual</title>
  88     <releaseinfo>
  89       for GLib &version;
  90       The latest version of this documentation can be found on-line at
  91       <ulink role="online-location" url="http://library.gnome.org/devel/glib/unstable/">http://library.gnome.org/devel/glib/unstable/</ulink>.
  92     </releaseinfo>
  93   </bookinfo>
  94
  95   <chapter id="glib">
  96     <title>GLib Overview</title>
  97     <para>
  98 GLib is a general-purpose utility library, which provides many useful data
  99 types, macros, type conversions, string utilities, file utilities, a main
 100 loop abstraction, and so on. It works on many UNIX-like platforms, Windows,
 101 OS/2 and BeOS. GLib is released under the GNU Library General Public License
 102 (GNU LGPL).
 103     </para>
 104     <para>
 105 The general policy of GLib is that all functions are invisibly threadsafe with the
 106 exception of data structure manipulation functions, where, if you have two threads
 107 manipulating the <emphasis>same</emphasis> data structure, they must use a lock to
 108 synchronize their operation.
 109     </para>
 110
 111     &glib-Building;
 112     &glib-Cross;
 113     &glib-Compiling;
 114     &glib-Running;
 115     &glib-Changes;
 116     &glib-RegexSyntax;
 117     &glib-Resources;
 118
 119   </chapter>
 120
 121   <chapter id="glib-fundamentals">
 122     <title>GLib Fundamentals</title>
 123     &glib-Version;
 124     &glib-Basic-Types;
 125     &glib-Limits-of-Basic-Types;
 126     &glib-Standard-Macros;
 127     &glib-Type-Conversion-Macros;
 128     &glib-Byte-Order-Macros;
 129     &glib-Numerical-Definitions;
 130     &glib-Miscellaneous-Macros;
 131     &glib-Atomic-Operations;
 132   </chapter>
 133
 134   <chapter id="glib-core">
 135     <title>GLib Core Application Support</title>
 136     &glib-The-Main-Event-Loop;
 137     &glib-Threads;
 138     &glib-Thread-Pools;
 139     &glib-Async-Queues;
 140     &glib-Dynamic-Loading-of-Modules;
 141     &glib-Memory-Allocation;
 142     &glib-IO-Channels;
 143     &glib-Error-Reporting;
 144     &glib-Warnings-and-Assertions;
 145     &glib-Message-Logging;
 146   </chapter>
 147
 148   <chapter id="glib-utilities">
 149     <title>GLib Utilities</title>
 150     &glib-String-Utility-Functions;
 151     &glib-Character-Set-Conversion;
 152     &glib-Unicode-Manipulation;
 153     &glib-Base64;
 154     &glib-Checksum;
 155     &glib-i18n;
 156     &glib-Date-and-Time-Functions;
 157     &glib-Random-Numbers;
 158     &glib-Hook-Functions;
 159     &glib-Miscellaneous-Utility-Functions;
 160     &glib-Lexical-Scanner;
 161     &glib-Automatic-String-Completion;
 162     &glib-Timers;
 163     &glib-Spawn;
 164     &glib-Fileutils;
 165     &glib-Uri;
 166     &glib-Hostutils;
 167     &glib-Shell;
 168     &glib-Option;
 169     &glib-Pattern-Matching;
 170     &glib-Regex;
 171     &glib-Markup;
 172     &glib-Keyfile;
 173     &glib-Bookmarkfile;
 174     &glib-Testing;
 175     &glib-Windows-Compatibility-Functions;
 176   </chapter>
 177
 178   <chapter id="glib-data-types">
 179     <title>GLib Data Types</title>
 180     &glib-Memory-Slices;
 181     &glib-Memory-Chunks;
 182     &glib-Doubly-Linked-Lists;
 183     &glib-Singly-Linked-Lists;
 184     &glib-Double-ended-Queues;
 185     &glib-Sequences;
 186     &glib-Trash-Stacks;
 187     &glib-Hash-Tables;
 188     &glib-Strings;
 189     &glib-String-Chunks;
 190     &glib-Arrays;
 191     &glib-Pointer-Arrays;
 192     &glib-Byte-Arrays;
 193     &glib-Balanced-Binary-Trees;
 194     &glib-N-ary-Trees;
 195     &glib-Quarks;
 196     &glib-Keyed-Data-Lists;
 197     &glib-Datasets;
 198     &glib-Relations-and-Tuples;
 199     &glib-Caches;
 200     &glib-Memory-Allocators;
 201   </chapter>
 202
 203   <chapter id="tools">
 204     <title>GLib Tools</title>
 205
 206     &glib-gettextize;
 207     &gtester;
 208     &gtester-report;
 209   </chapter>
 210
 211   <index>
 212     <title>Index</title>
 213   </index>
 214   <index role="deprecated">
 215     <title>Index of deprecated symbols</title>
 216   </index>
 217   <index role="2.2">
 218     <title>Index of new symbols in 2.2</title>
 219   </index>
 220   <index role="2.4">
 221     <title>Index of new symbols in 2.4</title>
 222   </index>
 223   <index role="2.6">
 224     <title>Index of new symbols in 2.6</title>
 225   </index>
 226   <index role="2.8">
 227     <title>Index of new symbols in 2.8</title>
 228   </index>
 229   <index role="2.10">
 230     <title>Index of new symbols in 2.10</title>
 231   </index>
 232   <index role="2.12">
 233     <title>Index of new symbols in 2.12</title>
 234   </index>
 235   <index role="2.14">
 236     <title>Index of new symbols in 2.14</title>
 237   </index>
 238   <index role="2.16">
 239     <title>Index of new symbols in 2.16</title>
 240   </index>
 241   <index role="2.18">
 242     <title>Index of new symbols in 2.18</title>
 243   </index>
 244   <index role="2.20">
 245     <title>Index of new symbols in 2.20</title>
 246   </index>
 247   <index role="2.22">
 248     <title>Index of new symbols in 2.22</title>
 249   </index>
 250
 251 </book>