-<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
-<!entity glib-Basic-Types SYSTEM "sgml/types.sgml">
-<!entity glib-Limits-of-Basic-Types SYSTEM "sgml/limits.sgml">
-<!entity glib-Standard-Macros SYSTEM "sgml/macros.sgml">
-<!entity glib-Type-Conversion-Macros SYSTEM "sgml/type_conversion.sgml">
-<!entity glib-Byte-Order-Macros SYSTEM "sgml/byte_order.sgml">
-<!entity glib-Numerical-Definitions SYSTEM "sgml/numerical.sgml">
-<!entity glib-Miscellaneous-Macros SYSTEM "sgml/macros_misc.sgml">
-<!entity glib-Memory-Allocation SYSTEM "sgml/memory.sgml">
-<!entity glib-Error-Reporting SYSTEM "sgml/error_reporting.sgml">
-<!entity glib-Warnings-and-Assertions SYSTEM "sgml/warnings.sgml">
-<!entity glib-Message-Logging SYSTEM "sgml/messages.sgml">
-<!entity glib-Pattern-Matching SYSTEM "sgml/patterns.sgml">
-<!entity glib-Timers SYSTEM "sgml/timers.sgml">
-<!entity glib-String-Utility-Functions SYSTEM "sgml/string_utils.sgml">
-<!entity glib-Character-Set-Conversion SYSTEM "sgml/conversions.sgml">
-<!entity glib-Unicode-Manipulation SYSTEM "sgml/unicode.sgml">
-<!entity glib-Random-Numbers SYSTEM "sgml/random_numbers.sgml">
-<!entity glib-Miscellaneous-Utility-Functions SYSTEM "sgml/misc_utils.sgml">
-<!entity glib-Date-and-Time-Functions SYSTEM "sgml/date.sgml">
-<!entity glib-The-Main-Event-Loop SYSTEM "sgml/main.sgml">
-<!entity glib-Threads SYSTEM "sgml/threads.sgml">
-<!entity glib-Thread-Pools SYSTEM "sgml/thread_pools.sgml">
-<!entity glib-Async-Queues SYSTEM "sgml/async_queues.sgml">
-<!entity glib-IO-Channels SYSTEM "sgml/iochannels.sgml">
-<!entity glib-Hook-Functions SYSTEM "sgml/hooks.sgml">
-<!entity glib-Lexical-Scanner SYSTEM "sgml/scanner.sgml">
-<!entity glib-Dynamic-Loading-of-Modules SYSTEM "sgml/modules.sgml">
-<!entity glib-Automatic-String-Completion SYSTEM "sgml/completion.sgml">
-<!entity glib-Windows-Compatability-Functions SYSTEM "sgml/windows.sgml">
-<!entity glib-Memory-Chunks SYSTEM "sgml/memory_chunks.sgml">
-<!entity glib-Doubly-Linked-Lists SYSTEM "sgml/linked_lists_double.sgml">
-<!entity glib-Singly-Linked-Lists SYSTEM "sgml/linked_lists_single.sgml">
-<!entity glib-Double-ended-Queues SYSTEM "sgml/queue.sgml">
-<!entity glib-Trash-Stacks SYSTEM "sgml/trash_stack.sgml">
-<!entity glib-Hash-Tables SYSTEM "sgml/hash_tables.sgml">
-<!entity glib-Strings SYSTEM "sgml/strings.sgml">
-<!entity glib-String-Chunks SYSTEM "sgml/string_chunks.sgml">
-<!entity glib-Arrays SYSTEM "sgml/arrays.sgml">
-<!entity glib-Pointer-Arrays SYSTEM "sgml/arrays_pointer.sgml">
-<!entity glib-Byte-Arrays SYSTEM "sgml/arrays_byte.sgml">
-<!entity glib-Balanced-Binary-Trees SYSTEM "sgml/trees-binary.sgml">
-<!entity glib-N-ary-Trees SYSTEM "sgml/trees-nary.sgml">
-<!entity glib-Quarks SYSTEM "sgml/quarks.sgml">
-<!entity glib-Keyed-Data-Lists SYSTEM "sgml/datalist.sgml">
-<!entity glib-Datasets SYSTEM "sgml/datasets.sgml">
-<!entity glib-Relations-and-Tuples SYSTEM "sgml/relations.sgml">
-<!entity glib-Caches SYSTEM "sgml/caches.sgml">
-<!entity glib-Memory-Allocators SYSTEM "sgml/allocators.sgml">
-<!entity glib-Spawn SYSTEM "sgml/spawn.sgml">
-<!entity glib-Fileutils SYSTEM "sgml/fileutils.sgml">
-<!entity glib-Shell SYSTEM "sgml/shell.sgml">
-<!entity glib-Markup SYSTEM "sgml/markup.sgml">
-
+<?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 id="index">
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>GLib Reference Manual</title>
+ <releaseinfo>
+ for GLib &version;
+ The latest version of this documentation can be found on-line at
+ <ulink role="online-location" url="http://library.gnome.org/devel/glib/unstable/">http://library.gnome.org/devel/glib/unstable/</ulink>.
+ </releaseinfo>
</bookinfo>
+ <chapter id="glib">
+ <title>GLib Overview</title>
+ <para>
+GLib is a general-purpose utility library, which provides many useful data
+types, macros, type conversions, string utilities, file utilities, a main
+loop abstraction, and so on. It works on many UNIX-like platforms, Windows,
+OS/2 and BeOS. GLib is released under the GNU Library General Public License
+(GNU LGPL).
+ </para>
+ <para>
+The general policy of GLib is that all functions are invisibly threadsafe with the
+exception of data structure manipulation functions, where, if you have two threads
+manipulating the <emphasis>same</emphasis> data structure, they must use a lock to
+synchronize their operation.
+ </para>
+
+ <xi:include href="building.sgml" />
+ <xi:include href="cross.sgml" />
+ <xi:include href="compiling.sgml" />
+ <xi:include href="running.sgml" />
+ <xi:include href="changes.sgml" />
+ <xi:include href="regex-syntax.sgml" />
+ <xi:include href="resources.sgml" />
+
+ </chapter>
+
<chapter id="glib-fundamentals">
<title>GLib Fundamentals</title>
- &glib-Basic-Types;
- &glib-Limits-of-Basic-Types;
- &glib-Standard-Macros;
- &glib-Type-Conversion-Macros;
- &glib-Byte-Order-Macros;
- &glib-Numerical-Definitions;
- &glib-Miscellaneous-Macros;
+ <xi:include href="xml/version.xml" />
+ <xi:include href="xml/types.xml" />
+ <xi:include href="xml/limits.xml" />
+ <xi:include href="xml/macros.xml" />
+ <xi:include href="xml/type_conversion.xml" />
+ <xi:include href="xml/byte_order.xml" />
+ <xi:include href="xml/numerical.xml" />
+ <xi:include href="xml/macros_misc.xml" />
+ <xi:include href="xml/atomic_operations.xml" />
</chapter>
<chapter id="glib-core">
<title>GLib Core Application Support</title>
- &glib-The-Main-Event-Loop;
- &glib-Threads;
- &glib-Thread-Pools;
- &glib-Async-Queues;
- &glib-Dynamic-Loading-of-Modules;
- &glib-Memory-Allocation;
- &glib-IO-Channels;
- &glib-Error-Reporting;
- &glib-Warnings-and-Assertions;
- &glib-Message-Logging;
+ <xi:include href="xml/main.xml" />
+ <xi:include href="xml/threads.xml" />
+ <xi:include href="xml/thread_pools.xml" />
+ <xi:include href="xml/async_queues.xml" />
+ <xi:include href="xml/modules.xml" />
+ <xi:include href="xml/memory.xml" />
+ <xi:include href="xml/iochannels.xml" />
+ <xi:include href="xml/error_reporting.xml" />
+ <xi:include href="xml/warnings.xml" />
+ <xi:include href="xml/messages.xml" />
</chapter>
<chapter id="glib-utilities">
<title>GLib Utilities</title>
- &glib-String-Utility-Functions;
- &glib-Character-Set-Conversion;
- &glib-Unicode-Manipulation;
- &glib-Date-and-Time-Functions;
- &glib-Random-Numbers;
- &glib-Hook-Functions;
- &glib-Miscellaneous-Utility-Functions;
- &glib-Lexical-Scanner;
- &glib-Automatic-String-Completion;
- &glib-Timers;
- &glib-Spawn;
- &glib-Fileutils;
- &glib-Shell;
- &glib-Pattern-Matching;
- &glib-Markup;
- &glib-Windows-Compatability-Functions;
+ <xi:include href="xml/string_utils.xml" />
+ <xi:include href="xml/conversions.xml" />
+ <xi:include href="xml/unicode.xml" />
+ <xi:include href="xml/base64.xml" />
+ <xi:include href="xml/checksum.xml" />
+ <xi:include href="xml/i18n.xml" />
+ <xi:include href="xml/date.xml" />
+ <xi:include href="xml/timezone.xml" />
+ <xi:include href="xml/date-time.xml" />
+ <xi:include href="xml/random_numbers.xml" />
+ <xi:include href="xml/hooks.xml" />
+ <xi:include href="xml/misc_utils.xml" />
+ <xi:include href="xml/scanner.xml" />
+ <xi:include href="xml/completion.xml" />
+ <xi:include href="xml/timers.xml" />
+ <xi:include href="xml/spawn.xml" />
+ <xi:include href="xml/fileutils.xml" />
+ <xi:include href="xml/gurifuncs.xml" />
+ <xi:include href="xml/ghostutils.xml" />
+ <xi:include href="xml/shell.xml" />
+ <xi:include href="xml/option.xml" />
+ <xi:include href="xml/patterns.xml" />
+ <xi:include href="xml/gregex.xml" />
+ <xi:include href="xml/markup.xml" />
+ <xi:include href="xml/keyfile.xml" />
+ <xi:include href="xml/bookmarkfile.xml" />
+ <xi:include href="xml/testing.xml" />
+ <xi:include href="xml/gunix.xml" />
+ <xi:include href="xml/windows.xml" />
</chapter>
<chapter id="glib-data-types">
<title>GLib Data Types</title>
- &glib-Memory-Chunks;
- &glib-Doubly-Linked-Lists;
- &glib-Singly-Linked-Lists;
- &glib-Double-ended-Queues;
- &glib-Trash-Stacks;
- &glib-Hash-Tables;
- &glib-Strings;
- &glib-String-Chunks;
- &glib-Arrays;
- &glib-Pointer-Arrays;
- &glib-Byte-Arrays;
- &glib-Balanced-Binary-Trees;
- &glib-N-ary-Trees;
- &glib-Quarks;
- &glib-Keyed-Data-Lists;
- &glib-Datasets;
- &glib-Relations-and-Tuples;
- &glib-Caches;
- &glib-Memory-Allocators;
+ <xi:include href="xml/memory_slices.xml" />
+ <xi:include href="xml/memory_chunks.xml" />
+ <xi:include href="xml/linked_lists_double.xml" />
+ <xi:include href="xml/linked_lists_single.xml" />
+ <xi:include href="xml/queue.xml" />
+ <xi:include href="xml/sequence.xml" />
+ <xi:include href="xml/trash_stack.xml" />
+ <xi:include href="xml/hash_tables.xml" />
+ <xi:include href="xml/strings.xml" />
+ <xi:include href="xml/string_chunks.xml" />
+ <xi:include href="xml/arrays.xml" />
+ <xi:include href="xml/arrays_pointer.xml" />
+ <xi:include href="xml/arrays_byte.xml" />
+ <xi:include href="xml/trees-binary.xml" />
+ <xi:include href="xml/trees-nary.xml" />
+ <xi:include href="xml/quarks.xml" />
+ <xi:include href="xml/datalist.xml" />
+ <xi:include href="xml/datasets.xml" />
+ <xi:include href="xml/relations.xml" />
+ <xi:include href="xml/caches.xml" />
+ <xi:include href="xml/allocators.xml" />
+ <xi:include href="xml/gvarianttype.xml"/>
+ <xi:include href="xml/gvariant.xml"/>
+ <xi:include href="gvariant-varargs.xml"/>
+ <xi:include href="gvariant-text.xml"/>
+ </chapter>
+
+ <chapter id="tools">
+ <title>GLib Tools</title>
+ <xi:include href="glib-gettextize.xml" />
+ <xi:include href="gtester.xml" />
+ <xi:include href="gtester-report.xml" />
</chapter>
-</book>
\ No newline at end of file
+
+ <index id="api-index-full">
+ <title>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-2" role="2.2">
+ <title>Index of new symbols in 2.2</title>
+ <xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-4" role="2.4">
+ <title>Index of new symbols in 2.4</title>
+ <xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-6" role="2.6">
+ <title>Index of new symbols in 2.6</title>
+ <xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-8" role="2.8">
+ <title>Index of new symbols in 2.8</title>
+ <xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-10" role="2.10">
+ <title>Index of new symbols in 2.10</title>
+ <xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-12" role="2.12">
+ <title>Index of new symbols in 2.12</title>
+ <xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-14" role="2.14">
+ <title>Index of new symbols in 2.14</title>
+ <xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-16" role="2.16">
+ <title>Index of new symbols in 2.16</title>
+ <xi:include href="xml/api-index-2.16.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>
+ <index id="api-index-2-28" role="2.28">
+ <title>Index of new symbols in 2.28</title>
+ <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-2-30" role="2.30">
+ <title>Index of new symbols in 2.30</title>
+ <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
+ </index>
+
+ <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+
+</book>