Add GRegex for regular expression matching. (#50075)
[platform/upstream/glib.git] / docs / reference / glib / glib-docs.sgml
index a0147f5..1b12ed5 100644 (file)
@@ -8,6 +8,7 @@
 <!ENTITY glib-Byte-Order-Macros SYSTEM "xml/byte_order.xml">
 <!ENTITY glib-Numerical-Definitions SYSTEM "xml/numerical.xml">
 <!ENTITY glib-Miscellaneous-Macros SYSTEM "xml/macros_misc.xml">
+<!ENTITY glib-Atomic-Operations SYSTEM "xml/atomic_operations.xml">
 <!ENTITY glib-Memory-Allocation SYSTEM "xml/memory.xml">
 <!ENTITY glib-Error-Reporting SYSTEM "xml/error_reporting.xml">
 <!ENTITY glib-Warnings-and-Assertions SYSTEM "xml/warnings.xml">
 <!ENTITY glib-Lexical-Scanner SYSTEM "xml/scanner.xml">
 <!ENTITY glib-Dynamic-Loading-of-Modules SYSTEM "xml/modules.xml">
 <!ENTITY glib-Automatic-String-Completion SYSTEM "xml/completion.xml">
-<!ENTITY glib-Windows-Compatability-Functions SYSTEM "xml/windows.xml">
+<!ENTITY glib-Windows-Compatibility-Functions SYSTEM "xml/windows.xml">
 <!ENTITY glib-Memory-Chunks SYSTEM "xml/memory_chunks.xml">
+<!ENTITY glib-Memory-Slices SYSTEM "xml/memory_slices.xml">
 <!ENTITY glib-Doubly-Linked-Lists SYSTEM "xml/linked_lists_double.xml">
 <!ENTITY glib-Singly-Linked-Lists SYSTEM "xml/linked_lists_single.xml">
 <!ENTITY glib-Double-ended-Queues SYSTEM "xml/queue.xml">
+<!ENTITY glib-Sequences SYSTEM "xml/sequence.xml">
 <!ENTITY glib-Trash-Stacks SYSTEM "xml/trash_stack.xml">
 <!ENTITY glib-Hash-Tables SYSTEM "xml/hash_tables.xml">
 <!ENTITY glib-Strings SYSTEM "xml/strings.xml">
 <!ENTITY glib-Spawn SYSTEM "xml/spawn.xml">
 <!ENTITY glib-Fileutils SYSTEM "xml/fileutils.xml">
 <!ENTITY glib-Shell SYSTEM "xml/shell.xml">
+<!ENTITY glib-Option SYSTEM "xml/option.xml">
 <!ENTITY glib-Markup SYSTEM "xml/markup.xml">
+<!ENTITY glib-Keyfile SYSTEM "xml/keyfile.xml">
+<!ENTITY glib-Bookmarkfile SYSTEM "xml/bookmarkfile.xml">
+<!ENTITY glib-Base64 SYSTEM "xml/base64.xml">
+<!ENTITY glib-i18n SYSTEM "xml/i18n.xml">
+<!ENTITY glib-Regex SYSTEM "xml/gregex.xml">
+<!ENTITY glib-Version SYSTEM "xml/version.xml">
 
 <!ENTITY glib-Compiling SYSTEM "compiling.sgml">
 <!ENTITY glib-Building SYSTEM "building.sgml">
+<!ENTITY glib-Cross SYSTEM "cross.sgml">
 <!ENTITY glib-Running SYSTEM "running.sgml">
 <!ENTITY glib-Resources SYSTEM "resources.sgml">
 <!ENTITY glib-Changes SYSTEM "changes.sgml">
+<!ENTITY glib-RegexSyntax SYSTEM "regex-syntax.sgml">
+
+<!ENTITY glib-gettextize SYSTEM "glib-gettextize.xml">
 
 <!ENTITY version SYSTEM "version.xml">
 ]>
@@ -78,42 +92,25 @@ OS/2 and BeOS. GLib is released under the GNU Library General Public License
 (GNU LGPL). 
     </para>
     <para>
-GLib depends on the following: 
-<variablelist>
-
-<varlistentry>
-<term><function>iconv()</function></term>
-<listitem><para>
-In order to implement conversions between character sets,
-GLib requires an implementation of the standard <function>iconv()</function> 
-routine. Most modern systems will have a suitable implementation, however
-many older systems lack an <function>iconv()</function> implementation. On 
-such systems, you must install the 
-<ulink url="http://clisp.cons.org/~haible/packages-libiconv.html">libiconv</ulink> library.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>a thread implementation</term>
-<listitem><para>
-The thread support in GLib can be based upon several native thread 
-implementations, e.g. POSIX threads, DCE threads or Solaris threads.
-</para></listitem>
-</varlistentry>
-
-</variablelist>    
+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>
 
     &glib-Building;
+    &glib-Cross;
     &glib-Compiling;
     &glib-Running;
     &glib-Changes;
+    &glib-RegexSyntax;
     &glib-Resources;
  
   </chapter> 
 
   <chapter id="glib-fundamentals">
     <title>GLib Fundamentals</title>
+    &glib-Version;
     &glib-Basic-Types;
     &glib-Limits-of-Basic-Types;
     &glib-Standard-Macros;
@@ -121,6 +118,7 @@ implementations, e.g. POSIX threads, DCE threads or Solaris threads.
     &glib-Byte-Order-Macros;
     &glib-Numerical-Definitions;
     &glib-Miscellaneous-Macros;
+    &glib-Atomic-Operations;
   </chapter>
 
   <chapter id="glib-core">
@@ -142,6 +140,8 @@ implementations, e.g. POSIX threads, DCE threads or Solaris threads.
     &glib-String-Utility-Functions;
     &glib-Character-Set-Conversion;
     &glib-Unicode-Manipulation;
+    &glib-Base64;
+    &glib-i18n;
     &glib-Date-and-Time-Functions;
     &glib-Random-Numbers;   
     &glib-Hook-Functions;
@@ -152,17 +152,23 @@ implementations, e.g. POSIX threads, DCE threads or Solaris threads.
     &glib-Spawn;
     &glib-Fileutils;
     &glib-Shell;
+    &glib-Option;
     &glib-Pattern-Matching;
+    &glib-Regex;
     &glib-Markup;
-    &glib-Windows-Compatability-Functions;
+    &glib-Keyfile;
+    &glib-Bookmarkfile;
+    &glib-Windows-Compatibility-Functions;
   </chapter>
 
   <chapter id="glib-data-types">
     <title>GLib Data Types</title>
+    &glib-Memory-Slices;
     &glib-Memory-Chunks;
     &glib-Doubly-Linked-Lists;
     &glib-Singly-Linked-Lists;
     &glib-Double-ended-Queues;
+    &glib-Sequences;
     &glib-Trash-Stacks;
     &glib-Hash-Tables;
     &glib-Strings;
@@ -179,4 +185,39 @@ implementations, e.g. POSIX threads, DCE threads or Solaris threads.
     &glib-Caches;
     &glib-Memory-Allocators;
   </chapter>
+
+  <chapter id="tools">
+    <title>GLib Tools</title>
+
+    &glib-gettextize;
+  </chapter>
+
+  <index>
+    <title>Index</title>
+  </index>
+  <index role="deprecated">
+    <title>Index of deprecated symbols</title>
+  </index>
+  <index role="2.2">
+    <title>Index of new symbols in 2.2</title>
+  </index>
+  <index role="2.4">
+    <title>Index of new symbols in 2.4</title>
+  </index>  
+  <index role="2.6">
+    <title>Index of new symbols in 2.6</title>
+  </index>  
+  <index role="2.8">
+    <title>Index of new symbols in 2.8</title>
+  </index>  
+  <index role="2.10">
+    <title>Index of new symbols in 2.10</title>
+  </index>  
+  <index role="2.12">
+    <title>Index of new symbols in 2.12</title>
+  </index>  
+  <index role="2.14">
+    <title>Index of new symbols in 2.14</title>
+  </index>  
+
 </book>