Split glib.h into many header files mostly according to the resp.
authorSebastian Wilhelmi <wilhelmi@ira.uka.de>
Thu, 12 Oct 2000 11:52:07 +0000 (11:52 +0000)
committerSebastian Wilhelmi <wilhelmi@src.gnome.org>
Thu, 12 Oct 2000 11:52:07 +0000 (11:52 +0000)
2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>

* glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
into many header files mostly according to the resp. *.c-files.

* gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
__END_DECLS.

* configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
gunicode.h, : Changed guard-macro names to something more
consistent.

* configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.

87 files changed:
ChangeLog
ChangeLog.pre-2-0
ChangeLog.pre-2-10
ChangeLog.pre-2-12
ChangeLog.pre-2-2
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
configure.in
galloca.h [new file with mode: 0644]
garray.h [new file with mode: 0644]
gasyncqueue.h [new file with mode: 0644]
gbacktrace.h [new file with mode: 0644]
gcache.h [new file with mode: 0644]
gcompletion.h [new file with mode: 0644]
gconvert.h [new file with mode: 0644]
gdataset.h [new file with mode: 0644]
gdate.h [new file with mode: 0644]
gerror.h
gfileutils.h
ghash.h [new file with mode: 0644]
ghook.h [new file with mode: 0644]
giochannel.h [new file with mode: 0644]
glib.h
glib/galloca.h [new file with mode: 0644]
glib/garray.h [new file with mode: 0644]
glib/gasyncqueue.h [new file with mode: 0644]
glib/gbacktrace.h [new file with mode: 0644]
glib/gcache.h [new file with mode: 0644]
glib/gcompletion.h [new file with mode: 0644]
glib/gconvert.h [new file with mode: 0644]
glib/gdataset.h [new file with mode: 0644]
glib/gdate.h [new file with mode: 0644]
glib/gerror.h
glib/gfileutils.h
glib/ghash.h [new file with mode: 0644]
glib/ghook.h [new file with mode: 0644]
glib/giochannel.h [new file with mode: 0644]
glib/glib.h
glib/glist.h [new file with mode: 0644]
glib/gmacros.h [new file with mode: 0644]
glib/gmain.h [new file with mode: 0644]
glib/gmem.h [new file with mode: 0644]
glib/gmessages.h [new file with mode: 0644]
glib/gnode.h [new file with mode: 0644]
glib/gprimes.h [new file with mode: 0644]
glib/gquark.h [new file with mode: 0644]
glib/gqueue.h [new file with mode: 0644]
glib/grand.h [new file with mode: 0644]
glib/grel.h [new file with mode: 0644]
glib/gscanner.h [new file with mode: 0644]
glib/gshell.h
glib/gslist.h [new file with mode: 0644]
glib/gspawn.h
glib/gstrfuncs.h [new file with mode: 0644]
glib/gstring.h [new file with mode: 0644]
glib/gthread.h [new file with mode: 0644]
glib/gthreadpool.h [new file with mode: 0644]
glib/gtimer.h [new file with mode: 0644]
glib/gtree.h [new file with mode: 0644]
glib/gtypes.h [new file with mode: 0644]
glib/gunicode.h
glib/gutils.h [new file with mode: 0644]
glist.h [new file with mode: 0644]
gmacros.h [new file with mode: 0644]
gmain.h [new file with mode: 0644]
gmem.h [new file with mode: 0644]
gmessages.h [new file with mode: 0644]
gnode.h [new file with mode: 0644]
gprimes.h [new file with mode: 0644]
gquark.h [new file with mode: 0644]
gqueue.h [new file with mode: 0644]
grand.h [new file with mode: 0644]
grel.h [new file with mode: 0644]
gscanner.h [new file with mode: 0644]
gshell.h
gslist.h [new file with mode: 0644]
gspawn.h
gstrfuncs.h [new file with mode: 0644]
gstring.h [new file with mode: 0644]
gthread.h [new file with mode: 0644]
gthreadpool.h [new file with mode: 0644]
gtimer.h [new file with mode: 0644]
gtree.h [new file with mode: 0644]
gtypes.h [new file with mode: 0644]
gunicode.h
gutils.h [new file with mode: 0644]

index c70d2ca..eb70be4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index c70d2ca..eb70be4 100644 (file)
@@ -1,5 +1,23 @@
 2000-10-12  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>
 
+       * glib.h, galloca.h, garray.h, gasyncqueue.h, gbacktrace.h,
+       gcache.h, gcompletion.h, gconvert.h, gdataset.h, gdate.h, ghash.h,
+       ghook.h, giochannel.h, glist.h , gmacros.h, gmain.h, gmem.h,
+       gmessages.h, gnode.h, gprimes.h, gquark.h, gqueue.h, grand.h,
+       grel.h, gscanner.h, gslist.h, gstrfuncs.h, gstring.h, gthread.h,
+       gthreadpool.h, gtimer.h, gtree.h, gtypes.h, gutils.h: Split glib.h
+       into many header files mostly according to the resp. *.c-files.
+
+       * gmacros.h: Added G_BEGIN_DECLS and G_END_DECLS to mean: 'in case
+       of C++: extern "C" { ... }' analogous to glibc __BEGIN_DECLS and
+       __END_DECLS.
+       
+       * configure.in, gerror.h, gfileutils.h, gshell.h, gspawn.h,
+       gunicode.h, : Changed guard-macro names to something more
+       consistent.
+       
+       * configure.in, *.h: Use G_BEGIN_DECLS and G_END_DECLS.
+
        * configure.in: Defined GLIB_HAVE_ALLOCA_H instead of including
        alloca.h in glibconfig.h, GLIB_HAVE_ALLOCA_H is used in glib.h.
 
index 43efbe7..79608a2 100644 (file)
@@ -1175,8 +1175,10 @@ case "$CONFIG_OTHER" in
  * This is a generated file.  Please modify 'configure.in'
  */
 
-#ifndef GLIBCONFIG_H
-#define GLIBCONFIG_H
+#ifndef __G_LIBCONFIG_H__
+#define __G_LIBCONFIG_H__
+
+#include <gmacros.h>
 
 _______EOF
 
@@ -1198,9 +1200,7 @@ _______EOF
 
        cat >> $outfile <<_______EOF
 
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
+G_BEGIN_DECLS
 
 #define G_MINFLOAT     $glib_mf
 #define G_MAXFLOAT     $glib_Mf
@@ -1389,9 +1389,7 @@ _______EOF
 
        cat >>$outfile <<_______EOF
 
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
+G_END_DECLS
 
 #endif /* GLIBCONFIG_H */
 _______EOF
diff --git a/galloca.h b/galloca.h
new file mode 100644 (file)
index 0000000..b4194d4
--- /dev/null
+++ b/galloca.h
@@ -0,0 +1,60 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ALLOCA_H__
+#define __G_ALLOCA_H__
+
+#include <gtypes.h>
+
+#ifdef  __GNUC__
+/* GCC does the right thing */
+# undef alloca
+# define alloca(size)   __builtin_alloca (size)
+#elif defined (GLIB_HAVE_ALLOCA_H)
+/* a native and working alloca.h is there */ 
+# include <alloca.h>
+#else /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
+# ifdef _MSC_VER
+#  include <malloc.h>
+#  define alloca _alloca
+# else /* !_MSC_VER */
+#  ifdef _AIX
+ #pragma alloca
+#  else /* !_AIX */
+#   ifndef alloca /* predefined by HP cc +Olibcalls */
+G_BEGIN_DECLS
+char *alloca ();
+G_END_DECLS
+#   endif /* !alloca */
+#  endif /* !_AIX */
+# endif /* !_MSC_VER */
+#endif /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
+
+#define g_alloca(size) alloca (size)
+
+
+#endif /* __G_ALLOCA_H__ */
+
diff --git a/garray.h b/garray.h
new file mode 100644 (file)
index 0000000..5ea9de6
--- /dev/null
+++ b/garray.h
@@ -0,0 +1,139 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ARRAY_H__
+#define __G_ARRAY_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GArray         GArray;
+typedef struct _GByteArray     GByteArray;
+typedef struct _GPtrArray      GPtrArray;
+
+struct _GArray
+{
+  gchar *data;
+  guint len;
+};
+
+struct _GByteArray
+{
+  guint8 *data;
+  guint          len;
+};
+
+struct _GPtrArray
+{
+  gpointer *pdata;
+  guint            len;
+};
+
+/* Resizable arrays, remove fills any cleared spot and shortens the
+ * array, while preserving the order. remove_fast will distort the
+ * order by moving the last element to the position of the removed 
+ */
+
+#define g_array_append_val(a,v)          g_array_append_vals (a, &v, 1)
+#define g_array_prepend_val(a,v)  g_array_prepend_vals (a, &v, 1)
+#define g_array_insert_val(a,i,v) g_array_insert_vals (a, i, &v, 1)
+#define g_array_index(a,t,i)      (((t*) (a)->data) [(i)])
+
+GArray* g_array_new              (gboolean         zero_terminated,
+                                  gboolean         clear,
+                                  guint            element_size);
+GArray* g_array_sized_new         (gboolean        zero_terminated,
+                                  gboolean         clear,
+                                  guint            element_size,
+                                  guint            reserved_size);
+gchar*  g_array_free             (GArray          *array,
+                                  gboolean         free_segment);
+GArray* g_array_append_vals       (GArray         *array,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_prepend_vals      (GArray         *array,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_insert_vals       (GArray          *array,
+                                  guint            index,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_set_size          (GArray         *array,
+                                  guint            length);
+GArray* g_array_remove_index     (GArray          *array,
+                                  guint            index);
+GArray* g_array_remove_index_fast (GArray         *array,
+                                  guint            index);
+
+/* Resizable pointer array.  This interface is much less complicated
+ * than the above.  Add appends appends a pointer.  Remove fills any
+ * cleared spot and shortens the array. remove_fast will again distort
+ * order.  
+ */
+#define            g_ptr_array_index(array,index) (array->pdata)[index]
+GPtrArray*  g_ptr_array_new               (void);
+GPtrArray*  g_ptr_array_sized_new         (guint        reserved_size);
+gpointer*   g_ptr_array_free              (GPtrArray   *array,
+                                           gboolean     free_seg);
+void       g_ptr_array_set_size           (GPtrArray   *array,
+                                           gint         length);
+gpointer    g_ptr_array_remove_index      (GPtrArray   *array,
+                                           guint        index);
+gpointer    g_ptr_array_remove_index_fast  (GPtrArray  *array,
+                                           guint        index);
+gboolean    g_ptr_array_remove            (GPtrArray   *array,
+                                           gpointer     data);
+gboolean    g_ptr_array_remove_fast        (GPtrArray  *array,
+                                           gpointer     data);
+void       g_ptr_array_add                (GPtrArray   *array,
+                                           gpointer     data);
+
+/* Byte arrays, an array of guint8.  Implemented as a GArray,
+ * but type-safe.
+ */
+
+GByteArray* g_byte_array_new              (void);
+GByteArray* g_byte_array_sized_new        (guint        reserved_size);
+guint8*            g_byte_array_free              (GByteArray   *array,
+                                           gboolean      free_segment);
+GByteArray* g_byte_array_append                   (GByteArray   *array,
+                                           const guint8 *data,
+                                           guint         len);
+GByteArray* g_byte_array_prepend           (GByteArray  *array,
+                                           const guint8 *data,
+                                           guint         len);
+GByteArray* g_byte_array_set_size          (GByteArray  *array,
+                                           guint         length);
+GByteArray* g_byte_array_remove_index     (GByteArray   *array,
+                                           guint         index);
+GByteArray* g_byte_array_remove_index_fast (GByteArray  *array,
+                                           guint         index);
+
+G_END_DECLS
+
+#endif /* __G_ARRAY_H__ */
+
diff --git a/gasyncqueue.h b/gasyncqueue.h
new file mode 100644 (file)
index 0000000..6e87425
--- /dev/null
@@ -0,0 +1,95 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ASYNCQUEUE_H__
+#define __G_ASYNCQUEUE_H__
+
+#include <gthread.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GAsyncQueue     GAsyncQueue;
+
+/* Asyncronous Queues, can be used to communicate between threads
+ */
+
+/* Get a new GAsyncQueue with the ref_count 1 */
+GAsyncQueue*  g_async_queue_new                (void);
+
+/* Lock and unlock an GAsyncQueue, all functions lock the queue for
+ * themselves, but in certain cirumstances you want to hold the lock longer,
+ * thus you lock the queue, call the *_unlocked functions and unlock it again
+ */
+void          g_async_queue_lock               (GAsyncQueue *queue);
+void          g_async_queue_unlock             (GAsyncQueue *queue);
+
+/* Ref and unref the GAsyncQueue. g_async_queue_unref_unlocked makes
+ * no sense, as after the unreffing the Queue might be gone and can't
+ * be unlocked. So you have a function to call, if you don't hold the
+ * lock (g_async_queue_unref) and one to call, when you already hold
+ * the lock (g_async_queue_unref_and_unlock). After that however, you
+ * don't hold the lock anymore and the Queue might in fact be
+ * destroyed, if you unrefed to zero */
+void          g_async_queue_ref                (GAsyncQueue *queue);
+void          g_async_queue_ref_unlocked       (GAsyncQueue *queue);
+void          g_async_queue_unref              (GAsyncQueue *queue);
+void          g_async_queue_unref_and_unlock   (GAsyncQueue *queue);
+
+/* Push data into the async queue. Must not be NULL */
+void          g_async_queue_push               (GAsyncQueue *queue,
+                                                gpointer     data);
+void          g_async_queue_push_unlocked      (GAsyncQueue *queue,
+                                                gpointer     data);
+
+/* Pop data from the async queue, when no data is there, the thread is blocked
+ * until data arrives */
+gpointer      g_async_queue_pop                (GAsyncQueue *queue);
+gpointer      g_async_queue_pop_unlocked       (GAsyncQueue *queue);
+
+/* Try to pop data, NULL is returned in case of empty queue */
+gpointer      g_async_queue_try_pop            (GAsyncQueue *queue);
+gpointer      g_async_queue_try_pop_unlocked   (GAsyncQueue *queue);
+
+/* Wait for data until at maximum until end_time is reached, NULL is returned
+ * in case of empty queue*/
+gpointer      g_async_queue_timed_pop          (GAsyncQueue *queue,
+                                                GTimeVal    *end_time);
+gpointer      g_async_queue_timed_pop_unlocked (GAsyncQueue *queue,
+                                                GTimeVal    *end_time);
+
+/* Return the length of the queue, negative values mean, that threads
+ * are waiting, positve values mean, that there are entries in the
+ * queue. Actually this function returns the length of the queue minus
+ * the number of waiting threads, g_async_queue_length == 0 could also
+ * mean 'n' entries in the queue and 'n' thread waiting, such can
+ * happen due to locking of the queue or due to scheduling. */
+gint          g_async_queue_length             (GAsyncQueue *queue);
+gint          g_async_queue_length_unlocked    (GAsyncQueue *queue);
+
+G_END_DECLS
+
+#endif /* __G_ASYNCQUEUE_H__ */
+
diff --git a/gbacktrace.h b/gbacktrace.h
new file mode 100644 (file)
index 0000000..2a3a856
--- /dev/null
@@ -0,0 +1,59 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_BACKTRACE_H__
+#define __G_BACKTRACE_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Fatal error handlers.
+ * g_on_error_query() will prompt the user to either
+ * [E]xit, [H]alt, [P]roceed or show [S]tack trace.
+ * g_on_error_stack_trace() invokes gdb, which attaches to the current
+ * process and shows a stack trace.
+ * These function may cause different actions on non-unix platforms.
+ * The prg_name arg is required by gdb to find the executable, if it is
+ * passed as NULL, g_on_error_query() will try g_get_prgname().
+ */
+void g_on_error_query (const gchar *prg_name);
+void g_on_error_stack_trace (const gchar *prg_name);
+
+/* Hacker macro to place breakpoints for elected machines.
+ * Actual use is strongly deprecated of course ;)
+ */
+#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("int $03"); }G_STMT_END
+#elif defined (__alpha__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("bpt"); }G_STMT_END
+#else  /* !__i386__ && !__alpha__ */
+#  define G_BREAKPOINT()       G_STMT_START{ raise (5 /* SIGTRAP */); }G_STMT_END
+#endif /* __i386__ */
+
+G_END_DECLS
+
+#endif /* __G_BACKTRACE_H__ */
diff --git a/gcache.h b/gcache.h
new file mode 100644 (file)
index 0000000..10b5c91
--- /dev/null
+++ b/gcache.h
@@ -0,0 +1,66 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_CACHE_H__
+#define __G_CACHE_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GCache          GCache;
+
+typedef gpointer        (*GCacheNewFunc)        (gpointer       key);
+typedef gpointer        (*GCacheDupFunc)        (gpointer       value);
+typedef void            (*GCacheDestroyFunc)    (gpointer       value);
+
+/* Caches
+ */
+GCache*  g_cache_new           (GCacheNewFunc      value_new_func,
+                                GCacheDestroyFunc  value_destroy_func,
+                                GCacheDupFunc      key_dup_func,
+                                GCacheDestroyFunc  key_destroy_func,
+                                GHashFunc          hash_key_func,
+                                GHashFunc          hash_value_func,
+                                GCompareFunc       key_compare_func);
+void     g_cache_destroy       (GCache            *cache);
+gpointer g_cache_insert        (GCache            *cache,
+                                gpointer           key);
+void     g_cache_remove        (GCache            *cache,
+                                gconstpointer      value);
+void     g_cache_key_foreach   (GCache            *cache,
+                                GHFunc             func,
+                                gpointer           user_data);
+void     g_cache_value_foreach (GCache            *cache,
+                                GHFunc             func,
+                                gpointer           user_data);
+
+G_END_DECLS
+
+#endif /* __G_CACHE_H__ */
+
+
+
diff --git a/gcompletion.h b/gcompletion.h
new file mode 100644 (file)
index 0000000..5af9475
--- /dev/null
@@ -0,0 +1,64 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_COMPLETION_H__
+#define __G_COMPLETION_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GCompletion     GCompletion;
+
+typedef gchar*          (*GCompletionFunc)      (gpointer);
+
+/* GCompletion
+ */
+
+struct _GCompletion
+{
+  GList* items;
+  GCompletionFunc func;
+  gchar* prefix;
+  GList* cache;
+};
+
+GCompletion* g_completion_new          (GCompletionFunc func);
+void         g_completion_add_items    (GCompletion*    cmp,
+                                        GList*          items);
+void         g_completion_remove_items (GCompletion*    cmp,
+                                        GList*          items);
+void         g_completion_clear_items  (GCompletion*    cmp);
+GList*       g_completion_complete     (GCompletion*    cmp,
+                                        gchar*          prefix,
+                                        gchar**         new_prefix);
+void         g_completion_free         (GCompletion*    cmp);
+
+G_END_DECLS
+
+#endif /* __G_COMPLETION_H__ */
+
diff --git a/gconvert.h b/gconvert.h
new file mode 100644 (file)
index 0000000..0586a19
--- /dev/null
@@ -0,0 +1,62 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_CONVERT_H__
+#define __G_CONVERT_H__
+
+#include <gerror.h>
+
+G_BEGIN_DECLS
+
+typedef enum 
+{
+  G_CONVERT_ERROR_NO_CONVERSION,
+  G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
+  G_CONVERT_ERROR_FAILED
+} GConvertError;
+
+#define G_CONVERT_ERROR g_convert_error_quark()
+GQuark g_convert_error_quark();
+
+gchar* g_convert               (const gchar  *str,
+                               gint          len,
+                               const gchar  *to_codeset,
+                               const gchar  *from_codeset,
+                               gint         *bytes_read,
+                               gint         *bytes_written,
+                               GError      **error);
+gchar* g_convert_with_fallback (const gchar  *str,
+                               gint          len,
+                               const gchar  *to_codeset,
+                               const gchar  *from_codeset,
+                               gchar        *fallback,
+                               gint         *bytes_read,
+                               gint         *bytes_written,
+                               GError      **error);
+
+G_END_DECLS
+
+#endif /* __G_CONVERT_H__ */
diff --git a/gdataset.h b/gdataset.h
new file mode 100644 (file)
index 0000000..f9d15b3
--- /dev/null
@@ -0,0 +1,106 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_DATASET_H__
+#define __G_DATASET_H__
+
+#include <gquark.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GData           GData;
+
+typedef void            (*GDataForeachFunc)     (GQuark         key_id,
+                                                 gpointer       data,
+                                                 gpointer       user_data);
+
+/* Keyed Data List
+ */
+void      g_datalist_init                (GData          **datalist);
+void      g_datalist_clear               (GData          **datalist);
+gpointer  g_datalist_id_get_data         (GData          **datalist,
+                                          GQuark           key_id);
+void      g_datalist_id_set_data_full    (GData          **datalist,
+                                          GQuark           key_id,
+                                          gpointer         data,
+                                          GDestroyNotify   destroy_func);
+gpointer  g_datalist_id_remove_no_notify (GData          **datalist,
+                                          GQuark           key_id);
+void      g_datalist_foreach             (GData          **datalist,
+                                          GDataForeachFunc func,
+                                          gpointer         user_data);
+#define   g_datalist_id_set_data(dl, q, d)      \
+     g_datalist_id_set_data_full ((dl), (q), (d), NULL)
+#define   g_datalist_id_remove_data(dl, q)      \
+     g_datalist_id_set_data ((dl), (q), NULL)
+#define   g_datalist_get_data(dl, k)            \
+     (g_datalist_id_get_data ((dl), g_quark_try_string (k)))
+#define   g_datalist_set_data_full(dl, k, d, f) \
+     g_datalist_id_set_data_full ((dl), g_quark_from_string (k), (d), (f))
+#define   g_datalist_remove_no_notify(dl, k)    \
+     g_datalist_id_remove_no_notify ((dl), g_quark_try_string (k))
+#define   g_datalist_set_data(dl, k, d)         \
+     g_datalist_set_data_full ((dl), (k), (d), NULL)
+#define   g_datalist_remove_data(dl, k)         \
+     g_datalist_id_set_data ((dl), g_quark_try_string (k), NULL)
+
+
+/* Location Associated Keyed Data
+ */
+void      g_dataset_destroy             (gconstpointer    dataset_location);
+gpointer  g_dataset_id_get_data         (gconstpointer    dataset_location,
+                                         GQuark           key_id);
+void      g_dataset_id_set_data_full    (gconstpointer    dataset_location,
+                                         GQuark           key_id,
+                                         gpointer         data,
+                                         GDestroyNotify   destroy_func);
+gpointer  g_dataset_id_remove_no_notify (gconstpointer    dataset_location,
+                                         GQuark           key_id);
+void      g_dataset_foreach             (gconstpointer    dataset_location,
+                                         GDataForeachFunc func,
+                                         gpointer         user_data);
+#define   g_dataset_id_set_data(l, k, d)        \
+     g_dataset_id_set_data_full ((l), (k), (d), NULL)
+#define   g_dataset_id_remove_data(l, k)        \
+     g_dataset_id_set_data ((l), (k), NULL)
+#define   g_dataset_get_data(l, k)              \
+     (g_dataset_id_get_data ((l), g_quark_try_string (k)))
+#define   g_dataset_set_data_full(l, k, d, f)   \
+     g_dataset_id_set_data_full ((l), g_quark_from_string (k), (d), (f))
+#define   g_dataset_remove_no_notify(l, k)      \
+     g_dataset_id_remove_no_notify ((l), g_quark_try_string (k))
+#define   g_dataset_set_data(l, k, d)           \
+     g_dataset_set_data_full ((l), (k), (d), NULL)
+#define   g_dataset_remove_data(l, k)           \
+     g_dataset_id_set_data ((l), g_quark_try_string (k), NULL)
+
+G_END_DECLS
+
+#endif /* __G_DATASET_H__ */
+
+
+
+
diff --git a/gdate.h b/gdate.h
new file mode 100644 (file)
index 0000000..149eace
--- /dev/null
+++ b/gdate.h
@@ -0,0 +1,224 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_DATE_H__
+#define __G_DATE_H__
+
+#include <gquark.h>
+
+G_BEGIN_DECLS
+
+/* GDate
+ *
+ * Date calculations (not time for now, to be resolved). These are a
+ * mutant combination of Steffen Beyer's DateCalc routines
+ * (http://www.perl.com/CPAN/authors/id/STBEY/) and Jon Trowbridge's
+ * date routines (written for in-house software).  Written by Havoc
+ * Pennington <hp@pobox.com>
+ */
+
+typedef gint32  GTime;
+typedef guint16 GDateYear;
+typedef guint8  GDateDay;   /* day of the month */
+typedef struct _GDate GDate;
+/* make struct tm known without having to include time.h */
+struct tm;
+
+/* enum used to specify order of appearance in parsed date strings */
+typedef enum
+{
+  G_DATE_DAY   = 0,
+  G_DATE_MONTH = 1,
+  G_DATE_YEAR  = 2
+} GDateDMY;
+
+/* actual week and month values */
+typedef enum
+{
+  G_DATE_BAD_WEEKDAY  = 0,
+  G_DATE_MONDAY       = 1,
+  G_DATE_TUESDAY      = 2,
+  G_DATE_WEDNESDAY    = 3,
+  G_DATE_THURSDAY     = 4,
+  G_DATE_FRIDAY       = 5,
+  G_DATE_SATURDAY     = 6,
+  G_DATE_SUNDAY       = 7
+} GDateWeekday;
+typedef enum
+{
+  G_DATE_BAD_MONTH = 0,
+  G_DATE_JANUARY   = 1,
+  G_DATE_FEBRUARY  = 2,
+  G_DATE_MARCH     = 3,
+  G_DATE_APRIL     = 4,
+  G_DATE_MAY       = 5,
+  G_DATE_JUNE      = 6,
+  G_DATE_JULY      = 7,
+  G_DATE_AUGUST    = 8,
+  G_DATE_SEPTEMBER = 9,
+  G_DATE_OCTOBER   = 10,
+  G_DATE_NOVEMBER  = 11,
+  G_DATE_DECEMBER  = 12
+} GDateMonth;
+
+#define G_DATE_BAD_JULIAN 0U
+#define G_DATE_BAD_DAY    0U
+#define G_DATE_BAD_YEAR   0U
+
+/* Note: directly manipulating structs is generally a bad idea, but
+ * in this case it's an *incredibly* bad idea, because all or part
+ * of this struct can be invalid at any given time. Use the functions,
+ * or you will get hosed, I promise.
+ */
+struct _GDate
+{
+  guint julian_days : 32; /* julian days representation - we use a
+                           *  bitfield hoping that 64 bit platforms
+                           *  will pack this whole struct in one big
+                           *  int
+                           */
+
+  guint julian : 1;    /* julian is valid */
+  guint dmy    : 1;    /* dmy is valid */
+
+  /* DMY representation */
+  guint day    : 6;
+  guint month  : 4;
+  guint year   : 16;
+};
+
+/* g_date_new() returns an invalid date, you then have to _set() stuff
+ * to get a usable object. You can also allocate a GDate statically,
+ * then call g_date_clear() to initialize.
+ */
+GDate*       g_date_new                   (void);
+GDate*       g_date_new_dmy               (GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    year);
+GDate*       g_date_new_julian            (guint32      julian_day);
+void         g_date_free                  (GDate       *date);
+
+/* check g_date_valid() after doing an operation that might fail, like
+ * _parse.  Almost all g_date operations are undefined on invalid
+ * dates (the exceptions are the mutators, since you need those to
+ * return to validity).
+ */
+gboolean     g_date_valid                 (GDate       *date);
+gboolean     g_date_valid_day             (GDateDay     day) G_GNUC_CONST;
+gboolean     g_date_valid_month           (GDateMonth month) G_GNUC_CONST;
+gboolean     g_date_valid_year            (GDateYear  year) G_GNUC_CONST;
+gboolean     g_date_valid_weekday         (GDateWeekday weekday) G_GNUC_CONST;
+gboolean     g_date_valid_julian          (guint32 julian_date) G_GNUC_CONST;
+gboolean     g_date_valid_dmy             (GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    year) G_GNUC_CONST;
+
+GDateWeekday g_date_weekday               (GDate       *date);
+GDateMonth   g_date_month                 (GDate       *date);
+GDateYear    g_date_year                  (GDate       *date);
+GDateDay     g_date_day                   (GDate       *date);
+guint32      g_date_julian                (GDate       *date);
+guint        g_date_day_of_year           (GDate       *date);
+/* First monday/sunday is the start of week 1; if we haven't reached
+ * that day, return 0. These are not ISO weeks of the year; that
+ * routine needs to be added.
+ * these functions return the number of weeks, starting on the
+ * corrsponding day
+ */
+guint        g_date_monday_week_of_year   (GDate      *date);
+guint        g_date_sunday_week_of_year   (GDate      *date);
+
+/* If you create a static date struct you need to clear it to get it
+ * in a sane state before use. You can clear a whole array at
+ * once with the ndates argument.
+ */
+void         g_date_clear                 (GDate       *date,
+                                           guint        n_dates);
+
+/* The parse routine is meant for dates typed in by a user, so it
+ * permits many formats but tries to catch common typos. If your data
+ * needs to be strictly validated, it is not an appropriate function.
+ */
+void         g_date_set_parse             (GDate       *date,
+                                           const gchar *str);
+void         g_date_set_time              (GDate       *date,
+                                           GTime        time);
+void         g_date_set_month             (GDate       *date,
+                                           GDateMonth   month);
+void         g_date_set_day               (GDate       *date,
+                                           GDateDay     day);
+void         g_date_set_year              (GDate       *date,
+                                           GDateYear    year);
+void         g_date_set_dmy               (GDate       *date,
+                                           GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    y);
+void         g_date_set_julian            (GDate       *date,
+                                           guint32      julian_date);
+gboolean     g_date_is_first_of_month     (GDate       *date);
+gboolean     g_date_is_last_of_month      (GDate       *date);
+
+/* To go forward by some number of weeks just go forward weeks*7 days */
+void         g_date_add_days              (GDate       *date,
+                                           guint        n_days);
+void         g_date_subtract_days         (GDate       *date,
+                                           guint        n_days);
+
+/* If you add/sub months while day > 28, the day might change */
+void         g_date_add_months            (GDate       *date,
+                                           guint        n_months);
+void         g_date_subtract_months       (GDate       *date,
+                                           guint        n_months);
+
+/* If it's feb 29, changing years can move you to the 28th */
+void         g_date_add_years             (GDate       *date,
+                                           guint        n_years);
+void         g_date_subtract_years        (GDate       *date,
+                                           guint        n_years);
+gboolean     g_date_is_leap_year          (GDateYear    year) G_GNUC_CONST;
+guint8       g_date_days_in_month         (GDateMonth   month,
+                                           GDateYear    year) G_GNUC_CONST;
+guint8       g_date_monday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
+guint8       g_date_sunday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
+
+/* qsort-friendly (with a cast...) */
+gint         g_date_compare               (GDate       *lhs,
+                                           GDate       *rhs);
+void         g_date_to_struct_tm          (GDate       *date,
+                                           struct tm   *tm);
+
+/* Just like strftime() except you can only use date-related formats.
+ *   Using a time format is undefined.
+ */
+gsize        g_date_strftime              (gchar       *s,
+                                           gsize        slen,
+                                           const gchar *format,
+                                           GDate       *date);
+
+G_END_DECLS
+
+#endif /* __G_DATE_H__ */
+
index 458c20a..a7eb8fd 100644 (file)
--- a/gerror.h
+++ b/gerror.h
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GERROR_H__
-#define __GERROR_H__
+#ifndef __G_ERROR_H__
+#define __G_ERROR_H__
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+#include <gquark.h>
+
+G_BEGIN_DECLS
 
 typedef struct _GError GError;
 
@@ -69,9 +68,7 @@ void     g_propagate_error     (GError       **dest,
 void     g_clear_error         (GError       **err);
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GERROR_H__ */
+#endif /* __G_ERROR_H__ */
 
index f6edd43..d49c921 100644 (file)
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GFILEUTILS_H__
-#define __GFILEUTILS_H__
+#ifndef __G_FILEUTILS_H__
+#define __G_FILEUTILS_H__
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+#include <gerror.h>
+
+G_BEGIN_DECLS
 
 #define G_FILE_ERROR g_file_error_quark ()
 
@@ -82,10 +81,8 @@ gboolean g_file_get_contents (const gchar  *filename,
 
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GFILEUTILS_H__ */
+#endif /* __G_FILEUTILS_H__ */
 
 
diff --git a/ghash.h b/ghash.h
new file mode 100644 (file)
index 0000000..280ad60
--- /dev/null
+++ b/ghash.h
@@ -0,0 +1,92 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_HASH_H__
+#define __G_HASH_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GHashTable     GHashTable;
+
+typedef gboolean       (*GHRFunc)              (gpointer       key,
+                                                gpointer       value,
+                                                gpointer       user_data);
+
+/* Hash tables
+ */
+GHashTable* g_hash_table_new           (GHashFunc       hash_func,
+                                        GCompareFunc    key_compare_func);
+void       g_hash_table_destroy        (GHashTable     *hash_table);
+void       g_hash_table_insert         (GHashTable     *hash_table,
+                                        gpointer        key,
+                                        gpointer        value);
+void       g_hash_table_remove         (GHashTable     *hash_table,
+                                        gconstpointer   key);
+gpointer    g_hash_table_lookup                (GHashTable     *hash_table,
+                                        gconstpointer   key);
+gboolean    g_hash_table_lookup_extended(GHashTable    *hash_table,
+                                        gconstpointer   lookup_key,
+                                        gpointer       *orig_key,
+                                        gpointer       *value);
+void       g_hash_table_foreach        (GHashTable     *hash_table,
+                                        GHFunc          func,
+                                        gpointer        user_data);
+guint      g_hash_table_foreach_remove (GHashTable     *hash_table,
+                                        GHRFunc         func,
+                                        gpointer        user_data);
+guint      g_hash_table_size           (GHashTable     *hash_table);
+
+/* The following two functions are deprecated and will be removed in
+ * the next major release. They do no good. */
+void       g_hash_table_freeze         (GHashTable     *hash_table);
+void       g_hash_table_thaw           (GHashTable     *hash_table);
+
+/* Hash Functions
+ */
+gboolean g_str_equal (gconstpointer   v,
+                      gconstpointer   v2);
+guint    g_str_hash  (gconstpointer   v);
+
+gint     g_int_equal (gconstpointer   v,
+                      gconstpointer   v2) G_GNUC_CONST;
+guint    g_int_hash  (gconstpointer   v) G_GNUC_CONST;
+
+/* This "hash" function will just return the key's adress as an
+ * unsigned integer. Useful for hashing on plain adresses or
+ * simple integer values.
+ * passing NULL into g_hash_table_new() as GHashFunc has the
+ * same effect as passing g_direct_hash().
+ */
+guint g_direct_hash  (gconstpointer v) G_GNUC_CONST;
+gint  g_direct_equal (gconstpointer v,
+                      gconstpointer v2) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_HASH_H__ */
+
diff --git a/ghook.h b/ghook.h
new file mode 100644 (file)
index 0000000..fe350e1
--- /dev/null
+++ b/ghook.h
@@ -0,0 +1,175 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_HOOK_H__
+#define __G_HOOK_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GHook          GHook;
+typedef struct _GHookList      GHookList;
+
+typedef gint           (*GHookCompareFunc)     (GHook          *new_hook,
+                                                GHook          *sibling);
+typedef gboolean       (*GHookFindFunc)        (GHook          *hook,
+                                                gpointer        data);
+typedef void           (*GHookMarshaller)      (GHook          *hook,
+                                                gpointer        data);
+typedef gboolean       (*GHookCheckMarshaller) (GHook          *hook,
+                                                gpointer        data);
+typedef void           (*GHookFunc)            (gpointer        data);
+typedef gboolean       (*GHookCheckFunc)       (gpointer        data);
+typedef void           (*GHookFreeFunc)        (GHookList      *hook_list,
+                                                GHook          *hook);
+
+/* Callback maintenance functions
+ */
+#define G_HOOK_FLAG_USER_SHIFT (4)
+typedef enum
+{
+  G_HOOK_FLAG_ACTIVE   = 1 << 0,
+  G_HOOK_FLAG_IN_CALL  = 1 << 1,
+  G_HOOK_FLAG_MASK     = 0x0f
+} GHookFlagMask;
+
+#define        G_HOOK_DEFERRED_DESTROY ((GHookFreeFunc) 0x01)
+
+struct _GHookList
+{
+  guint                 seq_id;
+  guint                 hook_size;
+  guint                 is_setup : 1;
+  GHook                *hooks;
+  GMemChunk    *hook_memchunk;
+  GHookFreeFunc         hook_free; /* virtual function */
+  GHookFreeFunc         hook_destroy; /* virtual function */
+};
+
+struct _GHook
+{
+  gpointer      data;
+  GHook                *next;
+  GHook                *prev;
+  guint                 ref_count;
+  guint                 hook_id;
+  guint                 flags;
+  gpointer      func;
+  GDestroyNotify destroy;
+};
+
+#define        G_HOOK_ACTIVE(hook)             ((((GHook*) hook)->flags & \
+                                         G_HOOK_FLAG_ACTIVE) != 0)
+#define        G_HOOK_IN_CALL(hook)            ((((GHook*) hook)->flags & \
+                                         G_HOOK_FLAG_IN_CALL) != 0)
+#define G_HOOK_IS_VALID(hook)          (((GHook*) hook)->hook_id != 0 && \
+                                        G_HOOK_ACTIVE (hook))
+#define G_HOOK_IS_UNLINKED(hook)       (((GHook*) hook)->next == NULL && \
+                                        ((GHook*) hook)->prev == NULL && \
+                                        ((GHook*) hook)->hook_id == 0 && \
+                                        ((GHook*) hook)->ref_count == 0)
+
+void    g_hook_list_init               (GHookList              *hook_list,
+                                        guint                   hook_size);
+void    g_hook_list_clear              (GHookList              *hook_list);
+GHook*  g_hook_alloc                   (GHookList              *hook_list);
+void    g_hook_free                    (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_ref                     (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_unref                   (GHookList              *hook_list,
+                                        GHook                  *hook);
+gboolean g_hook_destroy                        (GHookList              *hook_list,
+                                        guint                   hook_id);
+void    g_hook_destroy_link            (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_prepend                 (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_insert_before           (GHookList              *hook_list,
+                                        GHook                  *sibling,
+                                        GHook                  *hook);
+void    g_hook_insert_sorted           (GHookList              *hook_list,
+                                        GHook                  *hook,
+                                        GHookCompareFunc        func);
+GHook*  g_hook_get                     (GHookList              *hook_list,
+                                        guint                   hook_id);
+GHook*  g_hook_find                    (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        GHookFindFunc           func,
+                                        gpointer                data);
+GHook*  g_hook_find_data               (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                data);
+GHook*  g_hook_find_func               (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                func);
+GHook*  g_hook_find_func_data          (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                func,
+                                        gpointer                data);
+/* return the first valid hook, and increment its reference count */
+GHook*  g_hook_first_valid             (GHookList              *hook_list,
+                                        gboolean                may_be_in_call);
+/* return the next valid hook with incremented reference count, and
+ * decrement the reference count of the original hook
+ */
+GHook*  g_hook_next_valid              (GHookList              *hook_list,
+                                        GHook                  *hook,
+                                        gboolean                may_be_in_call);
+
+/* GHookCompareFunc implementation to insert hooks sorted by their id */
+gint    g_hook_compare_ids             (GHook                  *new_hook,
+                                        GHook                  *sibling);
+
+/* convenience macros */
+#define         g_hook_append( hook_list, hook )  \
+     g_hook_insert_before ((hook_list), NULL, (hook))
+
+/* invoke all valid hooks with the (*GHookFunc) signature.
+ */
+void    g_hook_list_invoke             (GHookList              *hook_list,
+                                        gboolean                may_recurse);
+/* invoke all valid hooks with the (*GHookCheckFunc) signature,
+ * and destroy the hook if FALSE is returned.
+ */
+void    g_hook_list_invoke_check       (GHookList              *hook_list,
+                                        gboolean                may_recurse);
+/* invoke a marshaller on all valid hooks.
+ */
+void    g_hook_list_marshal            (GHookList              *hook_list,
+                                        gboolean                may_recurse,
+                                        GHookMarshaller         marshaller,
+                                        gpointer                data);
+void    g_hook_list_marshal_check      (GHookList              *hook_list,
+                                        gboolean                may_recurse,
+                                        GHookCheckMarshaller    marshaller,
+                                        gpointer                data);
+
+G_END_DECLS
+
+#endif /* __G_HOOK_H__ */
+
diff --git a/giochannel.h b/giochannel.h
new file mode 100644 (file)
index 0000000..b2ae71e
--- /dev/null
@@ -0,0 +1,267 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_IOCHANNEL_H__
+#define __G_IOCHANNEL_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* GIOChannel
+ */
+
+typedef struct _GIOChannel     GIOChannel;
+typedef struct _GIOFuncs        GIOFuncs;
+typedef enum
+{
+  G_IO_ERROR_NONE,
+  G_IO_ERROR_AGAIN,
+  G_IO_ERROR_INVAL,
+  G_IO_ERROR_UNKNOWN
+} GIOError;
+typedef enum
+{
+  G_SEEK_CUR,
+  G_SEEK_SET,
+  G_SEEK_END
+} GSeekType;
+typedef enum
+{
+  G_IO_IN      GLIB_SYSDEF_POLLIN,
+  G_IO_OUT     GLIB_SYSDEF_POLLOUT,
+  G_IO_PRI     GLIB_SYSDEF_POLLPRI,
+  G_IO_ERR     GLIB_SYSDEF_POLLERR,
+  G_IO_HUP     GLIB_SYSDEF_POLLHUP,
+  G_IO_NVAL    GLIB_SYSDEF_POLLNVAL
+} GIOCondition;
+
+struct _GIOChannel
+{
+  guint channel_flags;
+  guint ref_count;
+  GIOFuncs *funcs;
+};
+
+typedef gboolean (*GIOFunc) (GIOChannel   *source,
+                            GIOCondition  condition,
+                            gpointer      data);
+struct _GIOFuncs
+{
+  GIOError (*io_read)   (GIOChannel    *channel, 
+                        gchar          *buf, 
+                        guint           count,
+                        guint          *bytes_read);
+  GIOError (*io_write)  (GIOChannel    *channel, 
+                        gchar          *buf, 
+                        guint           count,
+                        guint          *bytes_written);
+  GIOError (*io_seek)   (GIOChannel    *channel, 
+                        gint            offset, 
+                        GSeekType       type);
+  void (*io_close)      (GIOChannel    *channel);
+  guint (*io_add_watch) (GIOChannel     *channel,
+                        gint            priority,
+                        GIOCondition    condition,
+                        GIOFunc         func,
+                        gpointer        user_data,
+                        GDestroyNotify  notify);
+  void (*io_free)       (GIOChannel    *channel);
+};
+
+void        g_io_channel_init   (GIOChannel    *channel);
+void        g_io_channel_ref    (GIOChannel    *channel);
+void        g_io_channel_unref  (GIOChannel    *channel);
+GIOError    g_io_channel_read   (GIOChannel    *channel, 
+                                gchar         *buf, 
+                                guint          count,
+                                guint         *bytes_read);
+GIOError  g_io_channel_write    (GIOChannel    *channel, 
+                                gchar         *buf, 
+                                guint          count,
+                                guint         *bytes_written);
+GIOError  g_io_channel_seek     (GIOChannel    *channel,
+                                gint           offset, 
+                                GSeekType      type);
+void      g_io_channel_close    (GIOChannel    *channel);
+guint     g_io_add_watch_full   (GIOChannel    *channel,
+                                gint           priority,
+                                GIOCondition   condition,
+                                GIOFunc        func,
+                                gpointer       user_data,
+                                GDestroyNotify notify);
+guint    g_io_add_watch         (GIOChannel    *channel,
+                                GIOCondition   condition,
+                                GIOFunc        func,
+                                gpointer       user_data);
+
+/* On Unix, IO channels created with this function for any file
+ * descriptor or socket.
+ *
+ * On Win32, use this only for files opened with the MSVCRT (the
+ * Microsoft run-time C library) _open() or _pipe, including file
+ * descriptors 0, 1 and 2 (corresponding to stdin, stdout and stderr).
+ *
+ * The term file descriptor as used in the context of Win32 refers to
+ * the emulated Unix-like file descriptors MSVCRT provides. The native
+ * corresponding concept is file HANDLE. There isn't as of yet a way to
+ * get GIOChannels for file HANDLEs.
+ */
+GIOChannel* g_io_channel_unix_new    (int         fd);
+gint        g_io_channel_unix_get_fd (GIOChannel *channel);
+
+#ifdef G_OS_WIN32
+
+#define G_WIN32_MSG_HANDLE 19981206
+
+/* Use this to get a GPollFD from a GIOChannel, so that you can call
+ * g_io_channel_win32_poll(). After calling this you should only use
+ * g_io_channel_read() to read from the GIOChannel, i.e. never read()
+ * or recv() from the underlying file descriptor or SOCKET.
+ */
+void        g_io_channel_win32_make_pollfd (GIOChannel   *channel,
+                                           GIOCondition  condition,
+                                           GPollFD      *fd);
+
+/* This can be used to wait a until at least one of the channels is readable.
+ * On Unix you would do a select() on the file descriptors of the channels.
+ * This should probably be available for all platforms?
+ */
+gint        g_io_channel_win32_poll   (GPollFD    *fds,
+                                      gint        n_fds,
+                                      gint        timeout);
+
+/* This is used to add polling for Windows messages. GDK (GTk+) programs
+ * should *not* use this.
+ */
+void        g_main_poll_win32_msg_add (gint        priority,
+                                      GPollFD    *fd,
+                                      guint       hwnd);
+
+/* An IO channel for Windows messages for window handle hwnd. */
+GIOChannel *g_io_channel_win32_new_messages (guint hwnd);
+
+/* An IO channel for C runtime (emulated Unix-like) file
+ * descriptors. Identical to g_io_channel_unix_new above.
+ * After calling g_io_add_watch() on a IO channel returned
+ * by this function, you shouldn't call read() on the file
+ * descriptor.
+ */
+GIOChannel* g_io_channel_win32_new_fd (int         fd);
+
+/* Get the C runtime file descriptor of a channel. */
+gint        g_io_channel_win32_get_fd (GIOChannel *channel);
+
+/* An IO channel for a SOCK_STREAM winsock socket. The parameter
+ * should be a SOCKET. After calling g_io_add_watch() on a IO channel
+ * returned by this function, you shouldn't call recv() on the SOCKET.
+ */
+GIOChannel *g_io_channel_win32_new_stream_socket (int socket);
+
+#endif
+
+/* Windows emulation stubs for common Unix functions
+ */
+#ifdef G_OS_WIN32
+#  define MAXPATHLEN 1024
+
+#ifdef _MSC_VER
+typedef int pid_t;
+#endif
+
+/*
+ * To get prototypes for the following POSIXish functions, you have to
+ * include the indicated non-POSIX headers. The functions are defined
+ * in OLDNAMES.LIB (MSVC) or -lmoldname-msvc (mingw32).
+ *
+ * getcwd: <direct.h> (MSVC), <io.h> (mingw32)
+ * getpid: <process.h>
+ * access: <io.h>
+ * unlink: <stdio.h> or <io.h>
+ * open, read, write, lseek, close: <io.h>
+ * rmdir: <direct.h>
+ * pipe: <direct.h>
+ */
+
+/* pipe is not in OLDNAMES.LIB or -lmoldname-msvc. */
+#define pipe(phandles) _pipe (phandles, 4096, _O_BINARY)
+
+/* For some POSIX functions that are not provided by the MS runtime,
+ * we provide emulators in glib, which are prefixed with g_win32_.
+ */
+#    define ftruncate(fd, size)        g_win32_ftruncate (fd, size)
+
+/* -lmingw32 also has emulations for these, but we need our own
+ * for MSVC anyhow, so we might aswell use them always.
+ */
+#    define opendir            g_win32_opendir
+#    define readdir            g_win32_readdir
+#    define rewinddir          g_win32_rewinddir
+#    define closedir           g_win32_closedir
+#    define NAME_MAX 255
+
+struct dirent
+{
+  gchar  d_name[NAME_MAX + 1];
+};
+
+struct DIR
+{
+  gchar        *dir_name;
+  gboolean     just_opened;
+  guint        find_file_handle;
+  gpointer     find_file_data;
+  struct dirent readdir_result;
+};
+typedef struct DIR DIR;
+
+/* emulation functions */
+extern int     g_win32_ftruncate       (gint            f,
+                                        guint           size);
+DIR*           g_win32_opendir         (const gchar    *dirname);
+struct dirent* g_win32_readdir         (DIR            *dir);
+void           g_win32_rewinddir       (DIR            *dir);
+gint           g_win32_closedir        (DIR            *dir);
+
+/* The MS setlocale uses locale names of the form "English_United
+ * States.1252" etc. We want the Unixish standard form "en", "zh_TW"
+ * etc. This function gets the current thread locale from Windows and
+ * returns it as a string of the above form for use in forming file
+ * names etc. The returned string should be deallocated with g_free().
+ */
+gchar *                g_win32_getlocale  (void);
+
+/* Translate a Win32 error code (as returned by GetLastError()) into
+ * the corresponding message. The returned string should be deallocated
+ * with g_free().
+ */
+gchar *         g_win32_error_message (gint error);
+
+#endif  /* G_OS_WIN32 */
+
+G_END_DECLS
+
+#endif /* __G_IOCHANNEL_H__ */
diff --git a/glib.h b/glib.h
index d6d53ae..25ea828 100644 (file)
--- a/glib.h
+++ b/glib.h
 #ifndef __G_LIB_H__
 #define __G_LIB_H__
 
-/* Here we provide G_GNUC_EXTENSION as an alias for __extension__,
- * where this is valid. This allows for warningless compilation of
- * "long long" types even in the presence of '-ansi -pedantic'. This
- * of course should be with the other GCC-isms below, but then
- * glibconfig.h wouldn't load cleanly and it is better to have that
- * here, than in glibconfig.h.  
- */
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8)
-#  define G_GNUC_EXTENSION __extension__
-#else
-#  define G_GNUC_EXTENSION
-#endif
-
-/* system specific config file glibconfig.h provides definitions for
- * the extrema of many of the standard types. These are:
- *
- *  G_MINSHORT, G_MAXSHORT
- *  G_MININT, G_MAXINT
- *  G_MINLONG, G_MAXLONG
- *  G_MINFLOAT, G_MAXFLOAT
- *  G_MINDOUBLE, G_MAXDOUBLE
- *
- * It also provides the following typedefs:
- *
- *  gint8, guint8
- *  gint16, guint16
- *  gint32, guint32
- *  gint64, guint64
- *  gssize, gsize
- *
- * It defines the G_BYTE_ORDER symbol to one of G_*_ENDIAN (see later in
- * this file). 
- *
- * And it provides a way to store and retrieve a `gint' in/from a `gpointer'.
- * This is useful to pass an integer instead of a pointer to a callback.
- *
- *  GINT_TO_POINTER (i), GUINT_TO_POINTER (i)
- *  GPOINTER_TO_INT (p), GPOINTER_TO_UINT (p)
- *
- * Finally, it provides the following wrappers to STDC functions:
- *
- *  void g_memmove (gpointer dest, gconstpointer void *src, gulong count);
- *    A wrapper for STDC memmove, or an implementation, if memmove doesn't
- *    exist.  The prototype looks like the above, give or take a const,
- *    or size_t.
- */
-#include <glibconfig.h>
-
-/* Define some mathematical constants that aren't available
- * symbolically in some strict ISO C implementations.
- */
-#define G_E     2.7182818284590452354E0
-#define G_LN2   6.9314718055994530942E-1
-#define G_LN10  2.3025850929940456840E0
-#define G_PI    3.14159265358979323846E0
-#define G_PI_2  1.57079632679489661923E0
-#define G_PI_4  0.78539816339744830962E0
-#define G_SQRT2 1.4142135623730950488E0
-
-/* include varargs functions for assertment macros
- */
-#include <stdarg.h>
-
-/* optionally feature DMALLOC memory allocation debugger
- */
-#ifdef USE_DMALLOC
-#include "dmalloc.h"
-#endif
-
-
-#ifdef G_OS_WIN32
-
-/* On native Win32, directory separator is the backslash, and search path
- * separator is the semicolon.
- */
-#define G_DIR_SEPARATOR '\\'
-#define G_DIR_SEPARATOR_S "\\"
-#define G_SEARCHPATH_SEPARATOR ';'
-#define G_SEARCHPATH_SEPARATOR_S ";"
-
-#else  /* !G_OS_WIN32 */
-
-/* Unix */
-
-#define G_DIR_SEPARATOR '/'
-#define G_DIR_SEPARATOR_S "/"
-#define G_SEARCHPATH_SEPARATOR ':'
-#define G_SEARCHPATH_SEPARATOR_S ":"
-
-#endif /* !G_OS_WIN32 */
-
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
-
-/* Provide definitions for some commonly used macros.
- *  Some of them are only provided if they haven't already
- *  been defined. It is assumed that if they are already
- *  defined then the current definition is correct.
- */
-#ifndef NULL
-#  ifdef __cplusplus
-#    define NULL        (0L)
-#  else /* !__cplusplus */
-#    define NULL        ((void*) 0)
-#  endif /* !__cplusplus */
-#endif
-
-#ifndef        FALSE
-#define        FALSE   (0)
-#endif
-
-#ifndef        TRUE
-#define        TRUE    (!FALSE)
-#endif
-
-#undef MAX
-#define MAX(a, b)  (((a) > (b)) ? (a) : (b))
-
-#undef MIN
-#define MIN(a, b)  (((a) < (b)) ? (a) : (b))
-
-#undef ABS
-#define ABS(a)    (((a) < 0) ? -(a) : (a))
-
-#undef CLAMP
-#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
-
-#define G_STRINGIFY(macro_or_string)   G_STRINGIFY_ARG (macro_or_string)
-#define        G_STRINGIFY_ARG(contents)       #contents
-
-/* provide a string identifying the current code position */
-#ifdef  __GNUC__
-#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()"
-#else
-#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__)
-#endif
-
-
-/* Count the number of elements in an array. The array must be defined
- * as such; using this with a dynamically allocated array will give
- * incorrect results.
- */
-#define G_N_ELEMENTS(arr)              (sizeof (arr) / sizeof ((arr)[0]))
-
-/* Define G_VA_COPY() to do the right thing for copying va_list variables.
- * glibconfig.h may have already defined G_VA_COPY as va_copy or __va_copy.
- */
-#if !defined (G_VA_COPY)
-#  if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
-#    define G_VA_COPY(ap1, ap2)          (*(ap1) = *(ap2))
-#  elif defined (G_VA_COPY_AS_ARRAY)
-#    define G_VA_COPY(ap1, ap2)          g_memmove ((ap1), (ap2), sizeof (va_list))
-#  else /* va_list is a pointer */
-#    define G_VA_COPY(ap1, ap2)          ((ap1) = (ap2))
-#  endif /* va_list is a pointer */
-#endif /* !G_VA_COPY */
-
-
-/* Provide convenience macros for handling structure
- * fields through their offsets.
- */
-#define G_STRUCT_OFFSET(struct_type, member)   \
-    ((glong) ((guint8*) &((struct_type*) 0)->member))
-#define G_STRUCT_MEMBER_P(struct_p, struct_offset)   \
-    ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset)))
-#define G_STRUCT_MEMBER(member_type, struct_p, struct_offset)   \
-    (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset)))
-
-
-/* inlining hassle. for compilers that don't allow the `inline' keyword,
- * mostly because of strict ANSI C compliance or dumbness, we try to fall
- * back to either `__inline__' or `__inline'.
- * we define G_CAN_INLINE, if the compiler seems to be actually
- * *capable* to do function inlining, in which case inline function bodys
- * do make sense. we also define G_INLINE_FUNC to properly export the
- * function prototypes if no inlining can be performed.
- * inline function bodies have to be special cased with G_CAN_INLINE and a
- * .c file specific macro to allow one compiled instance with extern linkage
- * of the functions by defining G_IMPLEMENT_INLINES and the .c file macro.
- */
-#ifdef G_IMPLEMENT_INLINES
-#  define G_INLINE_FUNC extern
-#  undef  G_CAN_INLINE
-#endif
-#ifndef G_INLINE_FUNC
-#  define G_CAN_INLINE 1
-#endif
-#if defined (G_HAVE_INLINE) && defined (__GNUC__) && defined (__STRICT_ANSI__)
-#  undef inline
-#  define inline __inline__
-#elif !defined (G_HAVE_INLINE)
-#  undef inline
-#  if defined (G_HAVE___INLINE__)
-#    define inline __inline__
-#  elif defined (G_HAVE___INLINE)
-#    define inline __inline
-#  else /* !inline && !__inline__ && !__inline */
-#    define inline  /* don't inline, then */
-#    ifndef G_INLINE_FUNC
-#      undef G_CAN_INLINE
-#    endif
-#  endif
-#endif
-#ifndef G_INLINE_FUNC
-#  if defined (__GNUC__) && (__OPTIMIZE__)
-#    define G_INLINE_FUNC extern inline
-#  elif defined (G_CAN_INLINE) && !defined (__GNUC__)
-#    define G_INLINE_FUNC static inline
-#  else /* can't inline */
-#    define G_INLINE_FUNC extern
-#    undef G_CAN_INLINE
-#  endif
-#endif /* !G_INLINE_FUNC */
-
-
-/* Provide simple macro statement wrappers (adapted from Perl):
- *  G_STMT_START { statements; } G_STMT_END;
- *  can be used as a single statement, as in
- *  if (x) G_STMT_START { ... } G_STMT_END; else ...
- *
- *  For gcc we will wrap the statements within `({' and `})' braces.
- *  For SunOS they will be wrapped within `if (1)' and `else (void) 0',
- *  and otherwise within `do' and `while (0)'.
- */
-#if !(defined (G_STMT_START) && defined (G_STMT_END))
-#  if defined (__GNUC__) && !defined (__STRICT_ANSI__) && !defined (__cplusplus)
-#    define G_STMT_START       (void)(
-#    define G_STMT_END         )
-#  else
-#    if (defined (sun) || defined (__sun__))
-#      define G_STMT_START     if (1)
-#      define G_STMT_END       else (void)0
-#    else
-#      define G_STMT_START     do
-#      define G_STMT_END       while (0)
-#    endif
-#  endif
-#endif
-
-
-/* Provide macros to feature the GCC function attribute.
- */
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-#define G_GNUC_PURE                            \
-  __attribute__((pure))
-#else
-#define G_GNUC_PURE
-#endif
-
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
-#define G_GNUC_PRINTF( format_idx, arg_idx )   \
-  __attribute__((format (printf, format_idx, arg_idx)))
-#define G_GNUC_SCANF( format_idx, arg_idx )    \
-  __attribute__((format (scanf, format_idx, arg_idx)))
-#define G_GNUC_FORMAT( arg_idx )               \
-  __attribute__((format_arg (arg_idx)))
-#define G_GNUC_NORETURN                                \
-  __attribute__((noreturn))
-#define G_GNUC_CONST                           \
-  __attribute__((const))
-#define G_GNUC_UNUSED                          \
-  __attribute__((unused))
-#else  /* !__GNUC__ */
-#define G_GNUC_PRINTF( format_idx, arg_idx )
-#define G_GNUC_SCANF( format_idx, arg_idx )
-#define G_GNUC_FORMAT( arg_idx )
-#define G_GNUC_NORETURN
-#define G_GNUC_CONST
-#define        G_GNUC_UNUSED
-#endif /* !__GNUC__ */
-
-/* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with
- * macros, so we can refer to them as strings unconditionally.
- */
-#ifdef __GNUC__
-#define        G_GNUC_FUNCTION         __FUNCTION__
-#define        G_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__
-#else  /* !__GNUC__ */
-#define        G_GNUC_FUNCTION         ""
-#define        G_GNUC_PRETTY_FUNCTION  ""
-#endif /* !__GNUC__ */
-
-/* we try to provide a usefull equivalent for ATEXIT if it is
- * not defined, but use is actually abandoned. people should
- * use g_atexit() instead.
- */
-#ifndef ATEXIT
-# define ATEXIT(proc)  g_ATEXIT(proc)
-#else
-# define G_NATIVE_ATEXIT
-#endif /* ATEXIT */
-
-/* Hacker macro to place breakpoints for elected machines.
- * Actual use is strongly deprecated of course ;)
- */
-#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("int $03"); }G_STMT_END
-#elif defined (__alpha__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("bpt"); }G_STMT_END
-#else  /* !__i386__ && !__alpha__ */
-#  define G_BREAKPOINT()       G_STMT_START{ raise (5 /* SIGTRAP */); }G_STMT_END
-#endif /* __i386__ */
-
-/* g_alloca handling */
-#ifdef  __GNUC__
-/* GCC does the right thing */
-# undef alloca
-# define alloca(size)   __builtin_alloca (size)
-#elif defined (GLIB_HAVE_ALLOCA_H)
-/* a native and working alloca.h is there */ 
-# include <alloca.h>
-#else /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
-# ifdef _MSC_VER
-#  include <malloc.h>
-#  define alloca _alloca
-# else /* !_MSC_VER */
-#  ifdef _AIX
- #pragma alloca
-#  else /* !_AIX */
-#   ifndef alloca /* predefined by HP cc +Olibcalls */
-char *alloca ();
-#   endif /* !alloca */
-#  endif /* !_AIX */
-# endif /* !_MSC_VER */
-#endif /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
-
-#define g_alloca(size) alloca (size)
-/* End g_alloca handling */
-
-/* Provide macros for easily allocating memory. The macros
- *  will cast the allocated memory to the specified type
- *  in order to avoid compiler warnings. (Makes the code neater).
- */
-
-#ifdef __DMALLOC_H__
-#  define g_new(type, count)           (ALLOC (type, count))
-#  define g_new0(type, count)          (CALLOC (type, count))
-#  define g_renew(type, mem, count)    (REALLOC (mem, type, count))
-#else /* __DMALLOC_H__ */
-#  define g_new(type, count)     \
-      ((type *) g_malloc ((unsigned) sizeof (type) * (count)))
-#  define g_new0(type, count)    \
-      ((type *) g_malloc0 ((unsigned) sizeof (type) * (count)))
-#  define g_renew(type, mem, count)      \
-      ((type *) g_realloc (mem, (unsigned) sizeof (type) * (count)))
-#endif /* __DMALLOC_H__ */
-
-#define g_mem_chunk_create(type, pre_alloc, alloc_type)        ( \
-  g_mem_chunk_new (#type " mem chunks (" #pre_alloc ")", \
-                  sizeof (type), \
-                  sizeof (type) * (pre_alloc), \
-                  (alloc_type)) \
-)
-#define g_chunk_new(type, chunk)       ( \
-  (type *) g_mem_chunk_alloc (chunk) \
-)
-#define g_chunk_new0(type, chunk)      ( \
-  (type *) g_mem_chunk_alloc0 (chunk) \
-)
-#define g_chunk_free(mem, mem_chunk)   G_STMT_START { \
-  g_mem_chunk_free ((mem_chunk), (mem)); \
-} G_STMT_END
-
-
-/* Provide macros for error handling. The "assert" macros will
- *  exit on failure. The "return" macros will exit the current
- *  function. Two different definitions are given for the macros
- *  if G_DISABLE_ASSERT is not defined, in order to support gcc's
- *  __PRETTY_FUNCTION__ capability.
- */
-
-#ifdef G_DISABLE_ASSERT
-
-#define g_assert(expr)
-#define g_assert_not_reached()
-
-#else /* !G_DISABLE_ASSERT */
-
-#ifdef __GNUC__
-
-#define g_assert(expr)                 G_STMT_START{           \
-     if (!(expr))                                              \
-       g_log (G_LOG_DOMAIN,                                    \
-             G_LOG_LEVEL_ERROR,                                \
-             "file %s: line %d (%s): assertion failed: (%s)",  \
-             __FILE__,                                         \
-             __LINE__,                                         \
-             __PRETTY_FUNCTION__,                              \
-             #expr);                   }G_STMT_END
-
-#define g_assert_not_reached()         G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_ERROR,                                  \
-           "file %s: line %d (%s): should not be reached",     \
-           __FILE__,                                           \
-           __LINE__,                                           \
-           __PRETTY_FUNCTION__);       }G_STMT_END
-
-#else /* !__GNUC__ */
-
-#define g_assert(expr)                 G_STMT_START{           \
-     if (!(expr))                                              \
-       g_log (G_LOG_DOMAIN,                                    \
-             G_LOG_LEVEL_ERROR,                                \
-             "file %s: line %d: assertion failed: (%s)",       \
-             __FILE__,                                         \
-             __LINE__,                                         \
-             #expr);                   }G_STMT_END
-
-#define g_assert_not_reached()         G_STMT_START{   \
-     g_log (G_LOG_DOMAIN,                              \
-           G_LOG_LEVEL_ERROR,                          \
-           "file %s: line %d: should not be reached",  \
-           __FILE__,                                   \
-           __LINE__);          }G_STMT_END
-
-#endif /* __GNUC__ */
-
-#endif /* !G_DISABLE_ASSERT */
-
-
-#ifdef G_DISABLE_CHECKS
-
-#define g_return_if_fail(expr)
-#define g_return_val_if_fail(expr,val)
-#define g_return_if_reached() return
-#define g_return_val_if_reached(val) return (val)
-
-#else /* !G_DISABLE_CHECKS */
-
-#ifdef __GNUC__
-
-#define g_return_if_fail(expr)         G_STMT_START{                   \
-     if (!(expr))                                                      \
-       {                                                               \
-        g_log (G_LOG_DOMAIN,                                           \
-               G_LOG_LEVEL_CRITICAL,                                   \
-               "file %s: line %d (%s): assertion `%s' failed",         \
-               __FILE__,                                               \
-               __LINE__,                                               \
-               __PRETTY_FUNCTION__,                                    \
-               #expr);                                                 \
-        return;                                                        \
-       };                              }G_STMT_END
-
-#define g_return_val_if_fail(expr,val) G_STMT_START{                   \
-     if (!(expr))                                                      \
-       {                                                               \
-        g_log (G_LOG_DOMAIN,                                           \
-               G_LOG_LEVEL_CRITICAL,                                   \
-               "file %s: line %d (%s): assertion `%s' failed",         \
-               __FILE__,                                               \
-               __LINE__,                                               \
-               __PRETTY_FUNCTION__,                                    \
-               #expr);                                                 \
-        return (val);                                                  \
-       };                              }G_STMT_END
-
-#define g_return_if_reached()          G_STMT_START{                   \
-     g_log (G_LOG_DOMAIN,                                              \
-           G_LOG_LEVEL_CRITICAL,                                       \
-           "file %s: line %d (%s): should not be reached",             \
-           __FILE__,                                                   \
-           __LINE__,                                                   \
-           __PRETTY_FUNCTION__);                                       \
-     return;                           }G_STMT_END
-
-#define g_return_val_if_reached(val)   G_STMT_START{                   \
-     g_log (G_LOG_DOMAIN,                                              \
-           G_LOG_LEVEL_CRITICAL,                                       \
-           "file %s: line %d (%s): should not be reached",             \
-           __FILE__,                                                   \
-           __LINE__,                                                   \
-           __PRETTY_FUNCTION__);                                       \
-     return (val);                     }G_STMT_END
-
-#else /* !__GNUC__ */
-
-#define g_return_if_fail(expr)         G_STMT_START{           \
-     if (!(expr))                                              \
-       {                                                       \
-        g_log (G_LOG_DOMAIN,                                   \
-               G_LOG_LEVEL_CRITICAL,                           \
-               "file %s: line %d: assertion `%s' failed",      \
-               __FILE__,                                       \
-               __LINE__,                                       \
-               #expr);                                         \
-        return;                                                \
-       };                              }G_STMT_END
-
-#define g_return_val_if_fail(expr, val)        G_STMT_START{           \
-     if (!(expr))                                              \
-       {                                                       \
-        g_log (G_LOG_DOMAIN,                                   \
-               G_LOG_LEVEL_CRITICAL,                           \
-               "file %s: line %d: assertion `%s' failed",      \
-               __FILE__,                                       \
-               __LINE__,                                       \
-               #expr);                                         \
-        return (val);                                          \
-       };                              }G_STMT_END
-
-#define g_return_if_reached()          G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_CRITICAL,                               \
-           "file %s: line %d: should not be reached",          \
-           __FILE__,                                           \
-           __LINE__);                                          \
-     return;                           }G_STMT_END
-
-#define g_return_val_if_reached(val)   G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_CRITICAL,                               \
-           "file %s: line %d: should not be reached",          \
-           __FILE__,                                           \
-           __LINE__);                                          \
-     return (val);                     }G_STMT_END
-
-#endif /* !__GNUC__ */
-
-#endif /* !G_DISABLE_CHECKS */
-
-
-/* Provide type definitions for commonly used types.
- *  These are useful because a "gint8" can be adjusted
- *  to be 1 byte (8 bits) on all platforms. Similarly and
- *  more importantly, "gint32" can be adjusted to be
- *  4 bytes (32 bits) on all platforms.
- */
-
-typedef char   gchar;
-typedef short  gshort;
-typedef long   glong;
-typedef int    gint;
-typedef gint   gboolean;
-typedef gchar* gstring;
-
-typedef unsigned char  guchar;
-typedef unsigned short gushort;
-typedef unsigned long  gulong;
-typedef unsigned int   guint;
-
-typedef float  gfloat;
-typedef double gdouble;
-
-/* HAVE_LONG_DOUBLE doesn't work correctly on all platforms.
- * Since gldouble isn't used anywhere, just disable it for now */
-
-#if 0
-#ifdef HAVE_LONG_DOUBLE
-typedef long double gldouble;
-#else /* HAVE_LONG_DOUBLE */
-typedef double gldouble;
-#endif /* HAVE_LONG_DOUBLE */
-#endif /* 0 */
-
-typedef void* gpointer;
-typedef const void *gconstpointer;
-
-
-typedef guint32 GQuark;
-typedef gint32 GTime;
-
-
-/* Portable endian checks and conversions
- *
- * glibconfig.h defines G_BYTE_ORDER which expands to one of
- * the below macros.
- */
-#define G_LITTLE_ENDIAN 1234
-#define G_BIG_ENDIAN    4321
-#define G_PDP_ENDIAN    3412           /* unused, need specific PDP check */   
-
-
-/* Basic bit swapping functions
- */
-#define GUINT16_SWAP_LE_BE_CONSTANT(val)       ((guint16) ( \
-    (((guint16) (val) & (guint16) 0x00ffU) << 8) | \
-    (((guint16) (val) & (guint16) 0xff00U) >> 8)))
-#define GUINT32_SWAP_LE_BE_CONSTANT(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x000000ffU) << 24) | \
-    (((guint32) (val) & (guint32) 0x0000ff00U) <<  8) | \
-    (((guint32) (val) & (guint32) 0x00ff0000U) >>  8) | \
-    (((guint32) (val) & (guint32) 0xff000000U) >> 24)))
-
-/* Intel specific stuff for speed
- */
-#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define GUINT16_SWAP_LE_BE_X86(val) \
-     (__extension__                                    \
-      ({ register guint16 __v;                         \
-        if (__builtin_constant_p (val))                \
-          __v = GUINT16_SWAP_LE_BE_CONSTANT (val);     \
-        else                                           \
-          __asm__ __const__ ("rorw $8, %w0"            \
-                             : "=r" (__v)              \
-                             : "0" ((guint16) (val))); \
-       __v; }))
-#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_X86 (val))
-#  if !defined(__i486__) && !defined(__i586__) \
-      && !defined(__pentium__) && !defined(__i686__) && !defined(__pentiumpro__)
-#     define GUINT32_SWAP_LE_BE_X86(val) \
-        (__extension__                                         \
-         ({ register guint32 __v;                              \
-           if (__builtin_constant_p (val))                     \
-             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
-         else                                                  \
-           __asm__ __const__ ("rorw $8, %w0\n\t"               \
-                              "rorl $16, %0\n\t"               \
-                              "rorw $8, %w0"                   \
-                              : "=r" (__v)                     \
-                              : "0" ((guint32) (val)));        \
-       __v; }))
-#  else /* 486 and higher has bswap */
-#     define GUINT32_SWAP_LE_BE_X86(val) \
-        (__extension__                                         \
-         ({ register guint32 __v;                              \
-           if (__builtin_constant_p (val))                     \
-             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
-         else                                                  \
-           __asm__ __const__ ("bswap %0"                       \
-                              : "=r" (__v)                     \
-                              : "0" ((guint32) (val)));        \
-       __v; }))
-#  endif /* processor specific 32-bit stuff */
-#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_X86 (val))
-#else /* !__i386__ */
-#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val))
-#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val))
-#endif /* __i386__ */
-
-#ifdef G_HAVE_GINT64
-#  define GUINT64_SWAP_LE_BE_CONSTANT(val)     ((guint64) ( \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00000000000000ffU)) << 56) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x000000000000ff00U)) << 40) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x0000000000ff0000U)) << 24) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00000000ff000000U)) <<  8) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x000000ff00000000U)) >>  8) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x0000ff0000000000U)) >> 24) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00ff000000000000U)) >> 40) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0xff00000000000000U)) >> 56)))
-#  if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#    define GUINT64_SWAP_LE_BE_X86(val) \
-       (__extension__                                          \
-        ({ union { guint64 __ll;                               \
-                   guint32 __l[2]; } __r;                      \
-           if (__builtin_constant_p (val))                     \
-             __r.__ll = GUINT64_SWAP_LE_BE_CONSTANT (val);     \
-           else                                                \
-             {                                                 \
-               union { guint64 __ll;                           \
-                       guint32 __l[2]; } __w;                  \
-               __w.__ll = ((guint64) val);                     \
-               __r.__l[0] = GUINT32_SWAP_LE_BE (__w.__l[1]);   \
-               __r.__l[1] = GUINT32_SWAP_LE_BE (__w.__l[0]);   \
-             }                                                 \
-         __r.__ll; }))
-#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_X86 (val))
-#  else /* !__i386__ */
-#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT(val))
-#  endif
-#endif
-
-#define GUINT16_SWAP_LE_PDP(val)       ((guint16) (val))
-#define GUINT16_SWAP_BE_PDP(val)       (GUINT16_SWAP_LE_BE (val))
-#define GUINT32_SWAP_LE_PDP(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x0000ffffU) << 16) | \
-    (((guint32) (val) & (guint32) 0xffff0000U) >> 16)))
-#define GUINT32_SWAP_BE_PDP(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x00ff00ffU) << 8) | \
-    (((guint32) (val) & (guint32) 0xff00ff00U) >> 8)))
-
-/* The G*_TO_?E() macros are defined in glibconfig.h.
- * The transformation is symmetric, so the FROM just maps to the TO.
- */
-#define GINT16_FROM_LE(val)    (GINT16_TO_LE (val))
-#define GUINT16_FROM_LE(val)   (GUINT16_TO_LE (val))
-#define GINT16_FROM_BE(val)    (GINT16_TO_BE (val))
-#define GUINT16_FROM_BE(val)   (GUINT16_TO_BE (val))
-#define GINT32_FROM_LE(val)    (GINT32_TO_LE (val))
-#define GUINT32_FROM_LE(val)   (GUINT32_TO_LE (val))
-#define GINT32_FROM_BE(val)    (GINT32_TO_BE (val))
-#define GUINT32_FROM_BE(val)   (GUINT32_TO_BE (val))
-
-#ifdef G_HAVE_GINT64
-#define GINT64_FROM_LE(val)    (GINT64_TO_LE (val))
-#define GUINT64_FROM_LE(val)   (GUINT64_TO_LE (val))
-#define GINT64_FROM_BE(val)    (GINT64_TO_BE (val))
-#define GUINT64_FROM_BE(val)   (GUINT64_TO_BE (val))
-#endif
-
-#define GLONG_FROM_LE(val)     (GLONG_TO_LE (val))
-#define GULONG_FROM_LE(val)    (GULONG_TO_LE (val))
-#define GLONG_FROM_BE(val)     (GLONG_TO_BE (val))
-#define GULONG_FROM_BE(val)    (GULONG_TO_BE (val))
-
-#define GINT_FROM_LE(val)      (GINT_TO_LE (val))
-#define GUINT_FROM_LE(val)     (GUINT_TO_LE (val))
-#define GINT_FROM_BE(val)      (GINT_TO_BE (val))
-#define GUINT_FROM_BE(val)     (GUINT_TO_BE (val))
-
-
-/* Portable versions of host-network order stuff
- */
-#define g_ntohl(val) (GUINT32_FROM_BE (val))
-#define g_ntohs(val) (GUINT16_FROM_BE (val))
-#define g_htonl(val) (GUINT32_TO_BE (val))
-#define g_htons(val) (GUINT16_TO_BE (val))
-
-
-/* Glib version.
- * we prefix variable declarations so they can
- * properly get exported in windows dlls.
- */
-#ifdef G_OS_WIN32
-#  ifdef GLIB_COMPILATION
-#    define GLIB_VAR __declspec(dllexport)
-#  else /* !GLIB_COMPILATION */
-#    define GLIB_VAR extern __declspec(dllimport)
-#  endif /* !GLIB_COMPILATION */
-#else /* !G_OS_WIN32 */
-#  define GLIB_VAR extern
-#endif /* !G_OS_WIN32 */
-
-GLIB_VAR const guint glib_major_version;
-GLIB_VAR const guint glib_minor_version;
-GLIB_VAR const guint glib_micro_version;
-GLIB_VAR const guint glib_interface_age;
-GLIB_VAR const guint glib_binary_age;
-
-#define GLIB_CHECK_VERSION(major,minor,micro)    \
-    (GLIB_MAJOR_VERSION > (major) || \
-     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \
-     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION == (minor) && \
-      GLIB_MICRO_VERSION >= (micro)))
-
-/* Forward declarations of glib types.
- */
-typedef struct _GAllocator     GAllocator;
-typedef struct _GArray         GArray;
-typedef struct _GByteArray     GByteArray;
-typedef struct _GCache         GCache;
-typedef struct _GCompletion    GCompletion;
-typedef        struct _GData           GData;
-typedef struct _GDebugKey      GDebugKey;
-typedef union  _GDoubleIEEE754 GDoubleIEEE754;
-typedef union  _GFloatIEEE754  GFloatIEEE754;
-typedef struct _GHashTable     GHashTable;
-typedef struct _GHook          GHook;
-typedef struct _GHookList      GHookList;
-typedef struct _GList          GList;
-typedef struct _GMemChunk      GMemChunk;
-typedef struct _GNode          GNode;
-typedef struct _GPtrArray      GPtrArray;
-typedef struct _GQueue         GQueue;
-typedef struct _GRand          GRand;
-typedef struct _GRelation      GRelation;
-typedef struct _GScanner       GScanner;
-typedef struct _GScannerConfig GScannerConfig;
-typedef struct _GSList         GSList;
-typedef struct _GString                GString;
-typedef struct _GStringChunk   GStringChunk;
-typedef struct _GTimer         GTimer;
-typedef struct _GTrashStack     GTrashStack;
-typedef struct _GTree          GTree;
-typedef struct _GTuples                GTuples;
-typedef union  _GTokenValue    GTokenValue;
-typedef struct _GIOChannel     GIOChannel;
-
-/* Tree traverse flags */
-typedef enum
-{
-  G_TRAVERSE_LEAFS     = 1 << 0,
-  G_TRAVERSE_NON_LEAFS = 1 << 1,
-  G_TRAVERSE_ALL       = G_TRAVERSE_LEAFS | G_TRAVERSE_NON_LEAFS,
-  G_TRAVERSE_MASK      = 0x03
-} GTraverseFlags;
-
-/* Tree traverse orders */
-typedef enum
-{
-  G_IN_ORDER,
-  G_PRE_ORDER,
-  G_POST_ORDER,
-  G_LEVEL_ORDER
-} GTraverseType;
-
-/* Log level shift offset for user defined
- * log levels (0-7 are used by GLib).
- */
-#define        G_LOG_LEVEL_USER_SHIFT  (8)
-
-/* Glib log levels and flags.
- */
-typedef enum
-{
-  /* log flags */
-  G_LOG_FLAG_RECURSION         = 1 << 0,
-  G_LOG_FLAG_FATAL             = 1 << 1,
-  
-  /* GLib log levels */
-  G_LOG_LEVEL_ERROR            = 1 << 2,       /* always fatal */
-  G_LOG_LEVEL_CRITICAL         = 1 << 3,
-  G_LOG_LEVEL_WARNING          = 1 << 4,
-  G_LOG_LEVEL_MESSAGE          = 1 << 5,
-  G_LOG_LEVEL_INFO             = 1 << 6,
-  G_LOG_LEVEL_DEBUG            = 1 << 7,
-  
-  G_LOG_LEVEL_MASK             = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
-} GLogLevelFlags;
-
-/* GLib log levels that are considered fatal by default */
-#define        G_LOG_FATAL_MASK        (G_LOG_FLAG_RECURSION | G_LOG_LEVEL_ERROR)
-
-
-typedef gpointer       (*GCacheNewFunc)        (gpointer       key);
-typedef gpointer       (*GCacheDupFunc)        (gpointer       value);
-typedef void           (*GCacheDestroyFunc)    (gpointer       value);
-typedef gint           (*GCompareFunc)         (gconstpointer  a,
-                                                gconstpointer  b);
-typedef gchar*         (*GCompletionFunc)      (gpointer);
-typedef void           (*GDestroyNotify)       (gpointer       data);
-typedef void           (*GDataForeachFunc)     (GQuark         key_id,
-                                                gpointer       data,
-                                                gpointer       user_data);
-typedef void           (*GFunc)                (gpointer       data,
-                                                gpointer       user_data);
-typedef guint          (*GHashFunc)            (gconstpointer  key);
-typedef void           (*GFreeFunc)            (gpointer       data);
-typedef void           (*GHFunc)               (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       user_data);
-typedef gboolean       (*GHRFunc)              (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       user_data);
-typedef gint           (*GHookCompareFunc)     (GHook          *new_hook,
-                                                GHook          *sibling);
-typedef gboolean       (*GHookFindFunc)        (GHook          *hook,
-                                                gpointer        data);
-typedef void           (*GHookMarshaller)      (GHook          *hook,
-                                                gpointer        data);
-typedef gboolean       (*GHookCheckMarshaller) (GHook          *hook,
-                                                gpointer        data);
-typedef void           (*GHookFunc)            (gpointer        data);
-typedef gboolean       (*GHookCheckFunc)       (gpointer        data);
-typedef void           (*GHookFreeFunc)        (GHookList      *hook_list,
-                                                GHook          *hook);
-typedef void           (*GLogFunc)             (const gchar   *log_domain,
-                                                GLogLevelFlags log_level,
-                                                const gchar   *message,
-                                                gpointer       user_data);
-typedef gboolean       (*GNodeTraverseFunc)    (GNode         *node,
-                                                gpointer       data);
-typedef void           (*GNodeForeachFunc)     (GNode         *node,
-                                                gpointer       data);
-typedef void           (*GScannerMsgFunc)      (GScanner      *scanner,
-                                                gchar         *message,
-                                                gint           error);
-typedef gint           (*GTraverseFunc)        (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       data);
-typedef        void            (*GVoidFunc)            (void);
-
-
-struct _GArray
-{
-  gchar *data;
-  guint len;
-};
-
-struct _GByteArray
-{
-  guint8 *data;
-  guint          len;
-};
-
-struct _GDebugKey
-{
-  gchar *key;
-  guint         value;
-};
-
-struct _GList
-{
-  gpointer data;
-  GList *next;
-  GList *prev;
-};
-
-struct _GPtrArray
-{
-  gpointer *pdata;
-  guint            len;
-};
-
-struct _GQueue
-{
-  GList *head;
-  GList *tail;
-  guint  length;
-};
-
-struct _GSList
-{
-  gpointer data;
-  GSList *next;
-};
-
-struct _GString
-{
-  gchar *str;
-  gint len;
-};
-
-struct _GTrashStack
-{
-  GTrashStack *next;
-};
-
-struct _GTuples
-{
-  guint len;
-};
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
-
-#include <gerror.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
-/* IEEE Standard 754 Single Precision Storage Format (gfloat):
- *
- *        31 30           23 22            0
- * +--------+---------------+---------------+
- * | s 1bit | e[30:23] 8bit | f[22:0] 23bit |
- * +--------+---------------+---------------+
- * B0------------------->B1------->B2-->B3-->
- *
- * IEEE Standard 754 Double Precision Storage Format (gdouble):
- *
- *        63 62            52 51            32   31            0
- * +--------+----------------+----------------+ +---------------+
- * | s 1bit | e[62:52] 11bit | f[51:32] 20bit | | f[31:0] 32bit |
- * +--------+----------------+----------------+ +---------------+
- * B0--------------->B1---------->B2--->B3---->  B4->B5->B6->B7->
- */
-/* subtract from biased_exponent to form base2 exponent (normal numbers) */
-#define G_IEEE754_FLOAT_BIAS   (127)
-#define G_IEEE754_DOUBLE_BIAS  (1023)
-/* multiply with base2 exponent to get base10 exponent (nomal numbers) */
-#define G_LOG_2_BASE_10                (0.30102999566398119521)
-#if G_BYTE_ORDER == G_LITTLE_ENDIAN
-union _GFloatIEEE754
-{
-  gfloat v_float;
-  struct {
-    guint mantissa : 23;
-    guint biased_exponent : 8;
-    guint sign : 1;
-  } mpn;
-};
-union _GDoubleIEEE754
-{
-  gdouble v_double;
-  struct {
-    guint mantissa_low : 32;
-    guint mantissa_high : 20;
-    guint biased_exponent : 11;
-    guint sign : 1;
-  } mpn;
-};
-#elif G_BYTE_ORDER == G_BIG_ENDIAN
-union _GFloatIEEE754
-{
-  gfloat v_float;
-  struct {
-    guint sign : 1;
-    guint biased_exponent : 8;
-    guint mantissa : 23;
-  } mpn;
-};
-union _GDoubleIEEE754
-{
-  gdouble v_double;
-  struct {
-    guint sign : 1;
-    guint biased_exponent : 11;
-    guint mantissa_high : 20;
-    guint mantissa_low : 32;
-  } mpn;
-};
-#else /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
-#error unknown ENDIAN type
-#endif /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
-
-
-/* Doubly linked lists
- */
-void   g_list_push_allocator    (GAllocator     *allocator);
-void   g_list_pop_allocator     (void);
-GList* g_list_alloc            (void);
-void   g_list_free             (GList          *list);
-void   g_list_free_1           (GList          *list);
-GList* g_list_append           (GList          *list,
-                                gpointer        data);
-GList* g_list_prepend          (GList          *list,
-                                gpointer        data);
-GList* g_list_insert           (GList          *list,
-                                gpointer        data,
-                                gint            position);
-GList* g_list_insert_sorted    (GList          *list,
-                                gpointer        data,
-                                GCompareFunc    func);
-GList* g_list_concat           (GList          *list1,
-                                GList          *list2);
-GList* g_list_remove           (GList          *list,
-                                gconstpointer   data);
-GList* g_list_remove_link      (GList          *list,
-                                GList          *llink);
-GList* g_list_delete_link      (GList          *list,
-                                GList          *link);
-GList* g_list_reverse          (GList          *list);
-GList* g_list_copy             (GList          *list);
-GList* g_list_nth              (GList          *list,
-                                guint           n);
-GList* g_list_find             (GList          *list,
-                                gconstpointer   data);
-GList* g_list_find_custom      (GList          *list,
-                                gconstpointer   data,
-                                GCompareFunc    func);
-gint   g_list_position         (GList          *list,
-                                GList          *llink);
-gint   g_list_index            (GList          *list,
-                                gconstpointer   data);
-GList* g_list_last             (GList          *list);
-GList* g_list_first            (GList          *list);
-guint  g_list_length           (GList          *list);
-void   g_list_foreach          (GList          *list,
-                                GFunc           func,
-                                gpointer        user_data);
-GList* g_list_sort              (GList          *list,
-                                GCompareFunc    compare_func);
-gpointer g_list_nth_data       (GList          *list,
-                                guint           n);
-#define g_list_previous(list)  ((list) ? (((GList *)(list))->prev) : NULL)
-#define g_list_next(list)      ((list) ? (((GList *)(list))->next) : NULL)
-
-
-/* Singly linked lists
- */
-void    g_slist_push_allocator  (GAllocator     *allocator);
-void    g_slist_pop_allocator   (void);
-GSList* g_slist_alloc          (void);
-void   g_slist_free            (GSList         *list);
-void   g_slist_free_1          (GSList         *list);
-GSList* g_slist_append         (GSList         *list,
-                                gpointer        data);
-GSList* g_slist_prepend                (GSList         *list,
-                                gpointer        data);
-GSList* g_slist_insert         (GSList         *list,
-                                gpointer        data,
-                                gint            position);
-GSList* g_slist_insert_sorted  (GSList         *list,
-                                gpointer        data,
-                                GCompareFunc    func);
-GSList* g_slist_insert_before   (GSList         *slist,
-                                GSList         *sibling,
-                                gpointer        data);
-GSList* g_slist_concat         (GSList         *list1,
-                                GSList         *list2);
-GSList* g_slist_remove         (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_remove_link    (GSList         *list,
-                                GSList         *link);
-GSList* g_slist_delete_link     (GSList         *list,
-                                GSList         *link);
-GSList* g_slist_reverse                (GSList         *list);
-GSList*        g_slist_copy            (GSList         *list);
-GSList* g_slist_nth            (GSList         *list,
-                                guint           n);
-GSList* g_slist_find           (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_find_custom    (GSList         *list,
-                                gconstpointer   data,
-                                GCompareFunc    func);
-gint   g_slist_position        (GSList         *list,
-                                GSList         *llink);
-gint   g_slist_index           (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_last           (GSList         *list);
-guint  g_slist_length          (GSList         *list);
-void   g_slist_foreach         (GSList         *list,
-                                GFunc           func,
-                                gpointer        user_data);
-GSList*  g_slist_sort           (GSList          *list,
-                                GCompareFunc    compare_func);
-gpointer g_slist_nth_data      (GSList         *list,
-                                guint           n);
-#define  g_slist_next(slist)   ((slist) ? (((GSList *)(slist))->next) : NULL)
-
-
-/* Queues
- */
-GQueue*  g_queue_new            (void);
-void     g_queue_free           (GQueue  *queue);
-void     g_queue_push_head      (GQueue  *queue,
-                                gpointer data);
-void     g_queue_push_tail      (GQueue  *queue,
-                                gpointer data);
-gpointer g_queue_pop_head       (GQueue  *queue);
-gpointer g_queue_pop_tail       (GQueue  *queue);
-gboolean g_queue_is_empty       (GQueue  *queue);
-gpointer g_queue_peek_head      (GQueue  *queue);
-gpointer g_queue_peek_tail      (GQueue  *queue);
-void     g_queue_push_head_link (GQueue  *queue,
-                                GList   *link);
-void     g_queue_push_tail_link (GQueue  *queue,
-                                GList   *link);
-GList*   g_queue_pop_head_link  (GQueue  *queue);
-GList*   g_queue_pop_tail_link  (GQueue  *queue);
-
-/* Hash tables
- */
-GHashTable* g_hash_table_new           (GHashFunc       hash_func,
-                                        GCompareFunc    key_compare_func);
-void       g_hash_table_destroy        (GHashTable     *hash_table);
-void       g_hash_table_insert         (GHashTable     *hash_table,
-                                        gpointer        key,
-                                        gpointer        value);
-void       g_hash_table_remove         (GHashTable     *hash_table,
-                                        gconstpointer   key);
-gpointer    g_hash_table_lookup                (GHashTable     *hash_table,
-                                        gconstpointer   key);
-gboolean    g_hash_table_lookup_extended(GHashTable    *hash_table,
-                                        gconstpointer   lookup_key,
-                                        gpointer       *orig_key,
-                                        gpointer       *value);
-void       g_hash_table_foreach        (GHashTable     *hash_table,
-                                        GHFunc          func,
-                                        gpointer        user_data);
-guint      g_hash_table_foreach_remove (GHashTable     *hash_table,
-                                        GHRFunc         func,
-                                        gpointer        user_data);
-guint      g_hash_table_size           (GHashTable     *hash_table);
-
-/* The following two functions are deprecated and will be removed in
- * the next major release. They do no good. */
-void       g_hash_table_freeze         (GHashTable     *hash_table);
-void       g_hash_table_thaw           (GHashTable     *hash_table);
-
-/* Caches
- */
-GCache*         g_cache_new           (GCacheNewFunc      value_new_func,
-                               GCacheDestroyFunc  value_destroy_func,
-                               GCacheDupFunc      key_dup_func,
-                               GCacheDestroyFunc  key_destroy_func,
-                               GHashFunc          hash_key_func,
-                               GHashFunc          hash_value_func,
-                               GCompareFunc       key_compare_func);
-void    g_cache_destroy       (GCache            *cache);
-gpointer g_cache_insert               (GCache            *cache,
-                               gpointer           key);
-void    g_cache_remove        (GCache            *cache,
-                               gconstpointer      value);
-void    g_cache_key_foreach   (GCache            *cache,
-                               GHFunc             func,
-                               gpointer           user_data);
-void    g_cache_value_foreach (GCache            *cache,
-                               GHFunc             func,
-                               gpointer           user_data);
-
-
-/* Balanced binary trees
- */
-GTree*  g_tree_new      (GCompareFunc   key_compare_func);
-void    g_tree_destroy  (GTree         *tree);
-void    g_tree_insert   (GTree         *tree,
-                         gpointer       key,
-                         gpointer       value);
-void    g_tree_remove   (GTree         *tree,
-                         gconstpointer  key);
-gpointer g_tree_lookup  (GTree         *tree,
-                         gconstpointer  key);
-void    g_tree_traverse (GTree         *tree,
-                         GTraverseFunc  traverse_func,
-                         GTraverseType  traverse_type,
-                         gpointer       data);
-gpointer g_tree_search  (GTree         *tree,
-                         GCompareFunc   search_func,
-                         gconstpointer  data);
-gint    g_tree_height   (GTree         *tree);
-gint    g_tree_nnodes   (GTree         *tree);
-
-
-
-/* N-way tree implementation
- */
-struct _GNode
-{
-  gpointer data;
-  GNode          *next;
-  GNode          *prev;
-  GNode          *parent;
-  GNode          *children;
-};
-
-#define         G_NODE_IS_ROOT(node)   (((GNode*) (node))->parent == NULL && \
-                                ((GNode*) (node))->prev == NULL && \
-                                ((GNode*) (node))->next == NULL)
-#define         G_NODE_IS_LEAF(node)   (((GNode*) (node))->children == NULL)
-
-void     g_node_push_allocator  (GAllocator       *allocator);
-void     g_node_pop_allocator   (void);
-GNode*  g_node_new             (gpointer          data);
-void    g_node_destroy         (GNode            *root);
-void    g_node_unlink          (GNode            *node);
-GNode*   g_node_copy            (GNode            *node);
-GNode*  g_node_insert          (GNode            *parent,
-                                gint              position,
-                                GNode            *node);
-GNode*  g_node_insert_before   (GNode            *parent,
-                                GNode            *sibling,
-                                GNode            *node);
-GNode*  g_node_insert_after    (GNode            *parent,
-                                GNode            *sibling,
-                                GNode            *node);
-GNode*  g_node_prepend         (GNode            *parent,
-                                GNode            *node);
-guint   g_node_n_nodes         (GNode            *root,
-                                GTraverseFlags    flags);
-GNode*  g_node_get_root        (GNode            *node);
-gboolean g_node_is_ancestor    (GNode            *node,
-                                GNode            *descendant);
-guint   g_node_depth           (GNode            *node);
-GNode*  g_node_find            (GNode            *root,
-                                GTraverseType     order,
-                                GTraverseFlags    flags,
-                                gpointer          data);
-
-/* convenience macros */
-#define g_node_append(parent, node)                            \
-     g_node_insert_before ((parent), NULL, (node))
-#define        g_node_insert_data(parent, position, data)              \
-     g_node_insert ((parent), (position), g_node_new (data))
-#define        g_node_insert_data_before(parent, sibling, data)        \
-     g_node_insert_before ((parent), (sibling), g_node_new (data))
-#define        g_node_prepend_data(parent, data)                       \
-     g_node_prepend ((parent), g_node_new (data))
-#define        g_node_append_data(parent, data)                        \
-     g_node_insert_before ((parent), NULL, g_node_new (data))
-
-/* traversal function, assumes that `node' is root
- * (only traverses `node' and its subtree).
- * this function is just a high level interface to
- * low level traversal functions, optimized for speed.
- */
-void    g_node_traverse        (GNode            *root,
-                                GTraverseType     order,
-                                GTraverseFlags    flags,
-                                gint              max_depth,
-                                GNodeTraverseFunc func,
-                                gpointer          data);
-
-/* return the maximum tree height starting with `node', this is an expensive
- * operation, since we need to visit all nodes. this could be shortened by
- * adding `guint height' to struct _GNode, but then again, this is not very
- * often needed, and would make g_node_insert() more time consuming.
- */
-guint   g_node_max_height       (GNode *root);
-
-void    g_node_children_foreach (GNode           *node,
-                                 GTraverseFlags   flags,
-                                 GNodeForeachFunc func,
-                                 gpointer         data);
-void    g_node_reverse_children (GNode           *node);
-guint   g_node_n_children       (GNode           *node);
-GNode*  g_node_nth_child        (GNode           *node,
-                                 guint            n);
-GNode*  g_node_last_child       (GNode           *node);
-GNode*  g_node_find_child       (GNode           *node,
-                                 GTraverseFlags   flags,
-                                 gpointer         data);
-gint    g_node_child_position   (GNode           *node,
-                                 GNode           *child);
-gint    g_node_child_index      (GNode           *node,
-                                 gpointer         data);
-
-GNode*  g_node_first_sibling    (GNode           *node);
-GNode*  g_node_last_sibling     (GNode           *node);
-
-#define         g_node_prev_sibling(node)      ((node) ? \
-                                        ((GNode*) (node))->prev : NULL)
-#define         g_node_next_sibling(node)      ((node) ? \
-                                        ((GNode*) (node))->next : NULL)
-#define         g_node_first_child(node)       ((node) ? \
-                                        ((GNode*) (node))->children : NULL)
-
-
-/* Callback maintenance functions
- */
-#define G_HOOK_FLAG_USER_SHIFT (4)
-typedef enum
-{
-  G_HOOK_FLAG_ACTIVE   = 1 << 0,
-  G_HOOK_FLAG_IN_CALL  = 1 << 1,
-  G_HOOK_FLAG_MASK     = 0x0f
-} GHookFlagMask;
-
-#define        G_HOOK_DEFERRED_DESTROY ((GHookFreeFunc) 0x01)
-
-struct _GHookList
-{
-  guint                 seq_id;
-  guint                 hook_size;
-  guint                 is_setup : 1;
-  GHook                *hooks;
-  GMemChunk    *hook_memchunk;
-  GHookFreeFunc         hook_free; /* virtual function */
-  GHookFreeFunc         hook_destroy; /* virtual function */
-};
-
-struct _GHook
-{
-  gpointer      data;
-  GHook                *next;
-  GHook                *prev;
-  guint                 ref_count;
-  guint                 hook_id;
-  guint                 flags;
-  gpointer      func;
-  GDestroyNotify destroy;
-};
-
-#define        G_HOOK_ACTIVE(hook)             ((((GHook*) hook)->flags & \
-                                         G_HOOK_FLAG_ACTIVE) != 0)
-#define        G_HOOK_IN_CALL(hook)            ((((GHook*) hook)->flags & \
-                                         G_HOOK_FLAG_IN_CALL) != 0)
-#define G_HOOK_IS_VALID(hook)          (((GHook*) hook)->hook_id != 0 && \
-                                        G_HOOK_ACTIVE (hook))
-#define G_HOOK_IS_UNLINKED(hook)       (((GHook*) hook)->next == NULL && \
-                                        ((GHook*) hook)->prev == NULL && \
-                                        ((GHook*) hook)->hook_id == 0 && \
-                                        ((GHook*) hook)->ref_count == 0)
-
-void    g_hook_list_init               (GHookList              *hook_list,
-                                        guint                   hook_size);
-void    g_hook_list_clear              (GHookList              *hook_list);
-GHook*  g_hook_alloc                   (GHookList              *hook_list);
-void    g_hook_free                    (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_ref                     (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_unref                   (GHookList              *hook_list,
-                                        GHook                  *hook);
-gboolean g_hook_destroy                        (GHookList              *hook_list,
-                                        guint                   hook_id);
-void    g_hook_destroy_link            (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_prepend                 (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_insert_before           (GHookList              *hook_list,
-                                        GHook                  *sibling,
-                                        GHook                  *hook);
-void    g_hook_insert_sorted           (GHookList              *hook_list,
-                                        GHook                  *hook,
-                                        GHookCompareFunc        func);
-GHook*  g_hook_get                     (GHookList              *hook_list,
-                                        guint                   hook_id);
-GHook*  g_hook_find                    (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        GHookFindFunc           func,
-                                        gpointer                data);
-GHook*  g_hook_find_data               (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                data);
-GHook*  g_hook_find_func               (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                func);
-GHook*  g_hook_find_func_data          (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                func,
-                                        gpointer                data);
-/* return the first valid hook, and increment its reference count */
-GHook*  g_hook_first_valid             (GHookList              *hook_list,
-                                        gboolean                may_be_in_call);
-/* return the next valid hook with incremented reference count, and
- * decrement the reference count of the original hook
- */
-GHook*  g_hook_next_valid              (GHookList              *hook_list,
-                                        GHook                  *hook,
-                                        gboolean                may_be_in_call);
-
-/* GHookCompareFunc implementation to insert hooks sorted by their id */
-gint    g_hook_compare_ids             (GHook                  *new_hook,
-                                        GHook                  *sibling);
-
-/* convenience macros */
-#define         g_hook_append( hook_list, hook )  \
-     g_hook_insert_before ((hook_list), NULL, (hook))
-
-/* invoke all valid hooks with the (*GHookFunc) signature.
- */
-void    g_hook_list_invoke             (GHookList              *hook_list,
-                                        gboolean                may_recurse);
-/* invoke all valid hooks with the (*GHookCheckFunc) signature,
- * and destroy the hook if FALSE is returned.
- */
-void    g_hook_list_invoke_check       (GHookList              *hook_list,
-                                        gboolean                may_recurse);
-/* invoke a marshaller on all valid hooks.
- */
-void    g_hook_list_marshal            (GHookList              *hook_list,
-                                        gboolean                may_recurse,
-                                        GHookMarshaller         marshaller,
-                                        gpointer                data);
-void    g_hook_list_marshal_check      (GHookList              *hook_list,
-                                        gboolean                may_recurse,
-                                        GHookCheckMarshaller    marshaller,
-                                        gpointer                data);
-
-
-/* Fatal error handlers.
- * g_on_error_query() will prompt the user to either
- * [E]xit, [H]alt, [P]roceed or show [S]tack trace.
- * g_on_error_stack_trace() invokes gdb, which attaches to the current
- * process and shows a stack trace.
- * These function may cause different actions on non-unix platforms.
- * The prg_name arg is required by gdb to find the executable, if it is
- * passed as NULL, g_on_error_query() will try g_get_prgname().
- */
-void g_on_error_query (const gchar *prg_name);
-void g_on_error_stack_trace (const gchar *prg_name);
-
-
-/* Logging mechanism
- */
-extern         const gchar             *g_log_domain_glib;
-guint          g_log_set_handler       (const gchar    *log_domain,
-                                        GLogLevelFlags  log_levels,
-                                        GLogFunc        log_func,
-                                        gpointer        user_data);
-void           g_log_remove_handler    (const gchar    *log_domain,
-                                        guint           handler_id);
-void           g_log_default_handler   (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *message,
-                                        gpointer        unused_data);
-void           g_log                   (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *format,
-                                        ...) G_GNUC_PRINTF (3, 4);
-void           g_logv                  (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *format,
-                                        va_list         args);
-GLogLevelFlags g_log_set_fatal_mask    (const gchar    *log_domain,
-                                        GLogLevelFlags  fatal_mask);
-GLogLevelFlags g_log_set_always_fatal  (GLogLevelFlags  fatal_mask);
-#ifndef        G_LOG_DOMAIN
-#define        G_LOG_DOMAIN    ((gchar*) 0)
-#endif /* G_LOG_DOMAIN */
-#if defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
-#define        g_error(...)    g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_ERROR,    \
-                              __VA_ARGS__)
-#define        g_message(...)  g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_MESSAGE,  \
-                              __VA_ARGS__)
-#define        g_critical(...) g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_CRITICAL, \
-                              __VA_ARGS__)
-#define        g_warning(...)  g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_WARNING,  \
-                              __VA_ARGS__)
-#elif __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4)
-#define        g_error(format...)      g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_ERROR,    \
-                                      format)
-#define        g_message(format...)    g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_MESSAGE,  \
-                                      format)
-#define        g_critical(format...)   g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_CRITICAL, \
-                                      format)
-#define        g_warning(format...)    g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_WARNING,  \
-                                      format)
-#else  /* !__GNUC__ */
-static void
-g_error (const gchar *format,
-        ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, args);
-  va_end (args);
-}
-static void
-g_message (const gchar *format,
-          ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, args);
-  va_end (args);
-}
-static void
-g_critical (const gchar *format,
-           ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, args);
-  va_end (args);
-}
-static void
-g_warning (const gchar *format,
-          ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, args);
-  va_end (args);
-}
-#endif /* !__GNUC__ */
-
-typedef void   (*GPrintFunc)           (const gchar    *string);
-void           g_print                 (const gchar    *format,
-                                        ...) G_GNUC_PRINTF (1, 2);
-GPrintFunc     g_set_print_handler     (GPrintFunc      func);
-void           g_printerr              (const gchar    *format,
-                                        ...) G_GNUC_PRINTF (1, 2);
-GPrintFunc     g_set_printerr_handler  (GPrintFunc      func);
-
-/* deprecated compatibility functions, use g_log_set_handler() instead */
-typedef void           (*GErrorFunc)           (const gchar *str);
-typedef void           (*GWarningFunc)         (const gchar *str);
-GErrorFunc   g_set_error_handler   (GErrorFunc  func);
-GWarningFunc g_set_warning_handler (GWarningFunc func);
-GPrintFunc   g_set_message_handler (GPrintFunc func);
-
-
-/* Memory allocation and debugging
- */
-#ifdef USE_DMALLOC
-
-#define g_malloc(size)      ((gpointer) MALLOC (size))
-#define g_malloc0(size)             ((gpointer) CALLOC (char, size))
-#define g_realloc(mem,size)  ((gpointer) REALLOC (mem, char, size))
-#define g_free(mem)         FREE (mem)
-
-#else /* !USE_DMALLOC */
-
-gpointer g_malloc      (gulong   size);
-gpointer g_malloc0     (gulong   size);
-gpointer g_realloc     (gpointer  mem,
-                       gulong    size);
-void    g_free        (gpointer  mem);
-
-#endif /* !USE_DMALLOC */
-
-void    g_mem_profile (void);
-void    g_mem_check   (gpointer  mem);
-
-/* Generic allocators
- */
-GAllocator* g_allocator_new   (const gchar  *name,
-                              guint         n_preallocs);
-void        g_allocator_free  (GAllocator   *allocator);
-
-#define        G_ALLOCATOR_LIST        (1)
-#define        G_ALLOCATOR_SLIST       (2)
-#define        G_ALLOCATOR_NODE        (3)
-
-
-/* "g_mem_chunk_new" creates a new memory chunk.
- * Memory chunks are used to allocate pieces of memory which are
- *  always the same size. Lists are a good example of such a data type.
- * The memory chunk allocates and frees blocks of memory as needed.
- *  Just be sure to call "g_mem_chunk_free" and not "g_free" on data
- *  allocated in a mem chunk. ("g_free" will most likely cause a seg
- *  fault...somewhere).
- *
- * Oh yeah, GMemChunk is an opaque data type. (You don't really
- *  want to know what's going on inside do you?)
- */
-
-/* ALLOC_ONLY MemChunk's can only allocate memory. The free operation
- *  is interpreted as a no op. ALLOC_ONLY MemChunk's save 4 bytes per
- *  atom. (They are also useful for lists which use MemChunk to allocate
- *  memory but are also part of the MemChunk implementation).
- * ALLOC_AND_FREE MemChunk's can allocate and free memory.
- */
-
-#define G_ALLOC_ONLY     1
-#define G_ALLOC_AND_FREE  2
-
-GMemChunk* g_mem_chunk_new     (gchar    *name,
-                               gint       atom_size,
-                               gulong     area_size,
-                               gint       type);
-void      g_mem_chunk_destroy (GMemChunk *mem_chunk);
-gpointer   g_mem_chunk_alloc   (GMemChunk *mem_chunk);
-gpointer   g_mem_chunk_alloc0  (GMemChunk *mem_chunk);
-void      g_mem_chunk_free    (GMemChunk *mem_chunk,
-                               gpointer   mem);
-void      g_mem_chunk_clean   (GMemChunk *mem_chunk);
-void      g_mem_chunk_reset   (GMemChunk *mem_chunk);
-void      g_mem_chunk_print   (GMemChunk *mem_chunk);
-void      g_mem_chunk_info    (void);
-
-/* Ah yes...we have a "g_blow_chunks" function.
- * "g_blow_chunks" simply compresses all the chunks. This operation
- *  consists of freeing every memory area that should be freed (but
- *  which we haven't gotten around to doing yet). And, no,
- *  "g_blow_chunks" doesn't follow the naming scheme, but it is a
- *  much better name than "g_mem_chunk_clean_all" or something
- *  similar.
- */
-void g_blow_chunks (void);
-
-
-/* Timer
- */
-
-/* microseconds per second */
-#define G_USEC_PER_SEC 1000000
-
-GTimer* g_timer_new    (void);
-void   g_timer_destroy (GTimer  *timer);
-void   g_timer_start   (GTimer  *timer);
-void   g_timer_stop    (GTimer  *timer);
-void   g_timer_reset   (GTimer  *timer);
-gdouble g_timer_elapsed (GTimer         *timer,
-                        gulong  *microseconds);
-void    g_usleep        (gulong microseconds);
-
-/* String utility functions that modify a string argument or
- * return a constant string that must not be freed.
- */
-#define         G_STR_DELIMITERS       "_-|> <."
-gchar*  g_strdelimit           (gchar       *string,
-                                const gchar *delimiters,
-                                gchar        new_delimiter);
-gchar*  g_strcanon             (gchar       *string,
-                                const gchar *valid_chars,
-                                gchar        subsitutor);
-gdouble         g_strtod               (const gchar *nptr,
-                                gchar      **endptr);
-gchar*  g_strerror             (gint         errnum) G_GNUC_CONST;
-gchar*  g_strsignal            (gint         signum) G_GNUC_CONST;
-gint    g_strcasecmp           (const gchar *s1,
-                                const gchar *s2);
-gint    g_strncasecmp          (const gchar *s1,
-                                const gchar *s2,
-                                guint        n);
-gchar*  g_strdown              (gchar       *string);
-gchar*  g_strup                (gchar       *string);
-gchar*  g_strreverse           (gchar       *string);
-gsize   g_strlcpy              (gchar       *dest,
-                                const gchar *src,
-                                gsize        dest_size);
-gsize   g_strlcat              (gchar       *dest,
-                                const gchar *src,
-                                gsize        dest_size);
-/* removes leading spaces */
-gchar*   g_strchug              (gchar        *string);
-/* removes trailing spaces */
-gchar*  g_strchomp              (gchar        *string);
-/* removes leading & trailing spaces */
-#define g_strstrip( string )   g_strchomp (g_strchug (string))
-
-/* String utility functions that return a newly allocated string which
- * ought to be freed with g_free from the caller at some point.
- */
-gchar*  g_strdup               (const gchar *str);
-gchar*  g_strdup_printf        (const gchar *format,
-                                ...) G_GNUC_PRINTF (1, 2);
-gchar*  g_strdup_vprintf       (const gchar *format,
-                                va_list      args);
-gchar*  g_strndup              (const gchar *str,
-                                guint        n);
-gchar*  g_strnfill             (guint        length,
-                                gchar        fill_char);
-gchar*  g_strconcat            (const gchar *string1,
-                                ...); /* NULL terminated */
-gchar*   g_strjoin             (const gchar  *separator,
-                                ...); /* NULL terminated */
-/* Make a copy of a string interpreting C string -style escape
- * sequences. Inverse of g_strescape. The recognized sequences are \b
- * \f \n \r \t \\ \" and the octal format.
- */
-gchar*   g_strcompress         (const gchar *source);
-
-/* Convert between the operating system (or C runtime)
- * representation of file names and UTF-8.
- */
-gchar*   g_filename_to_utf8 (const gchar *opsysstring);
-gchar*   g_filename_from_utf8 (const gchar *utf8string);
-
-/* Copy a string escaping nonprintable characters like in C strings.
- * Inverse of g_strcompress. The exceptions parameter, if non-NULL, points
- * to a string containing characters that are not to be escaped.
- *
- * Deprecated API: gchar* g_strescape (const gchar *source);
- * Luckily this function wasn't used much, using NULL as second parameter
- * provides mostly identical semantics.
- */
-gchar*   g_strescape           (const gchar *source,
-                                const gchar *exceptions);
-
-gpointer g_memdup              (gconstpointer mem,
-                                guint         byte_size);
-
-/* NULL terminated string arrays.
- * g_strsplit() splits up string into max_tokens tokens at delim and
- * returns a newly allocated string array.
- * g_strjoinv() concatenates all of str_array's strings, sliding in an
- * optional separator, the returned string is newly allocated.
- * g_strfreev() frees the array itself and all of its strings.
- */
-gchar**         g_strsplit             (const gchar  *string,
-                                const gchar  *delimiter,
-                                gint          max_tokens);
-gchar*   g_strjoinv            (const gchar  *separator,
-                                gchar       **str_array);
-void     g_strfreev            (gchar       **str_array);
-
-
-
-/* calculate a string size, guarranteed to fit format + args.
- */
-guint  g_printf_string_upper_bound (const gchar* format,
-                                    va_list      args);
-
-
-/* Retrive static string info
- */
-gchar* g_get_user_name         (void);
-gchar* g_get_real_name         (void);
-gchar* g_get_home_dir          (void);
-gchar* g_get_tmp_dir           (void);
-gchar* g_get_prgname           (void);
-void   g_set_prgname           (const gchar *prgname);
-
-
-/* Miscellaneous utility functions
- */
-guint  g_parse_debug_string    (const gchar *string,
-                                GDebugKey   *keys,
-                                guint        nkeys);
-gint   g_snprintf              (gchar       *string,
-                                gulong       n,
-                                gchar const *format,
-                                ...) G_GNUC_PRINTF (3, 4);
-gint   g_vsnprintf             (gchar       *string,
-                                gulong       n,
-                                gchar const *format,
-                                va_list      args);
-/* Check if a file name is an absolute path */
-gboolean g_path_is_absolute    (const gchar *file_name);
-/* In case of absolute paths, skip the root part */
-gchar*  g_path_skip_root       (gchar       *file_name);
-
-/* These two functions are deprecated and will be removed in the next
- * major release of GLib. Use g_path_get_dirname/g_path_get_basename
- * instead. Whatch out! The string returned by g_path_get_basename
- * must be g_freed, while the string returned by g_basename must not.*/
-gchar* g_basename              (const gchar *file_name);
-gchar* g_dirname               (const gchar *file_name);
-
-/* The returned strings are newly allocated with g_malloc() */
-gchar* g_get_current_dir       (void);
-gchar* g_path_get_basename     (const gchar *file_name);
-gchar* g_path_get_dirname      (const gchar *file_name);
-
-/* Get the codeset for the current locale */
-/* gchar * g_get_codeset    (void); */
-
-/* return the environment string for the variable. The returned memory
- * must not be freed. */
-gchar*  g_getenv               (const gchar *variable);
-
-/* we use a GLib function as a replacement for ATEXIT, so
- * the programmer is not required to check the return value
- * (if there is any in the implementation) and doesn't encounter
- * missing include files.
- */
-void   g_atexit                (GVoidFunc    func);
-
-/* Look for an executable in PATH, following execvp() rules */
-gchar*  g_find_program_in_path  (const gchar *program);
-
-/* Bit tests
- */
-G_INLINE_FUNC gint     g_bit_nth_lsf (guint32 mask,
-                                      gint    nth_bit);
-G_INLINE_FUNC gint     g_bit_nth_msf (guint32 mask,
-                                      gint    nth_bit);
-G_INLINE_FUNC guint    g_bit_storage (guint number);
-
-
-/* Trash Stacks
- * elements need to be >= sizeof (gpointer)
- */
-G_INLINE_FUNC void     g_trash_stack_push      (GTrashStack **stack_p,
-                                                gpointer      data_p);
-G_INLINE_FUNC gpointer g_trash_stack_pop       (GTrashStack **stack_p);
-G_INLINE_FUNC gpointer g_trash_stack_peek      (GTrashStack **stack_p);
-G_INLINE_FUNC guint    g_trash_stack_height    (GTrashStack **stack_p);
-
-
-/* inline function implementations
- */
-#if defined (G_CAN_INLINE) || defined (__G_UTILS_C__)
-G_INLINE_FUNC gint
-g_bit_nth_lsf (guint32 mask,
-              gint    nth_bit)
-{
-  do
-    {
-      nth_bit++;
-      if (mask & (1 << (guint) nth_bit))
-       return nth_bit;
-    }
-  while (nth_bit < 32);
-  return -1;
-}
-G_INLINE_FUNC gint
-g_bit_nth_msf (guint32 mask,
-              gint    nth_bit)
-{
-  if (nth_bit < 0)
-    nth_bit = 32;
-  do
-    {
-      nth_bit--;
-      if (mask & (1 << (guint) nth_bit))
-       return nth_bit;
-    }
-  while (nth_bit > 0);
-  return -1;
-}
-G_INLINE_FUNC guint
-g_bit_storage (guint number)
-{
-  register guint n_bits = 0;
-  
-  do
-    {
-      n_bits++;
-      number >>= 1;
-    }
-  while (number);
-  return n_bits;
-}
-G_INLINE_FUNC void
-g_trash_stack_push (GTrashStack **stack_p,
-                   gpointer      data_p)
-{
-  GTrashStack *data = (GTrashStack *) data_p;
-
-  data->next = *stack_p;
-  *stack_p = data;
-}
-G_INLINE_FUNC gpointer
-g_trash_stack_pop (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-
-  data = *stack_p;
-  if (data)
-    {
-      *stack_p = data->next;
-      /* NULLify private pointer here, most platforms store NULL as
-       * subsequent 0 bytes
-       */
-      data->next = NULL;
-    }
-
-  return data;
-}
-G_INLINE_FUNC gpointer
-g_trash_stack_peek (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-
-  data = *stack_p;
-
-  return data;
-}
-G_INLINE_FUNC guint
-g_trash_stack_height (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-  guint i = 0;
-
-  for (data = *stack_p; data; data = data->next)
-    i++;
-
-  return i;
-}
-#endif  /* G_CAN_INLINE || __G_UTILS_C__ */
-
-
-/* String Chunks
- */
-GStringChunk* g_string_chunk_new          (gint size);
-void         g_string_chunk_free          (GStringChunk *chunk);
-gchar*       g_string_chunk_insert        (GStringChunk *chunk,
-                                           const gchar  *string);
-gchar*       g_string_chunk_insert_const  (GStringChunk *chunk,
-                                           const gchar  *string);
-
-
-/* Strings
- */
-GString*     g_string_new              (const gchar     *init);
-GString*     g_string_sized_new         (guint           dfl_size);
-gchar*      g_string_free              (GString         *string,
-                                        gboolean         free_segment);
-gboolean     g_string_equal             (const GString  *v,
-                                        const GString   *v2);
-guint        g_string_hash              (const GString   *str);
-GString*     g_string_assign            (GString        *string,
-                                        const gchar     *rval);
-GString*     g_string_truncate          (GString        *string,
-                                        guint            len);
-GString*     g_string_insert_len        (GString         *string,
-                                         gint             pos,
-                                         const gchar     *val,
-                                         gint             len);
-GString*     g_string_append            (GString        *string,
-                                        const gchar     *val);
-GString*     g_string_append_len        (GString        *string,
-                                        const gchar     *val,
-                                         gint             len);
-GString*     g_string_append_c          (GString        *string,
-                                        gchar            c);
-GString*     g_string_prepend           (GString        *string,
-                                        const gchar     *val);
-GString*     g_string_prepend_c         (GString        *string,
-                                        gchar            c);
-GString*     g_string_prepend_len       (GString        *string,
-                                        const gchar     *val,
-                                         gint             len);
-GString*     g_string_insert            (GString        *string,
-                                        gint             pos,
-                                        const gchar     *val);
-GString*     g_string_insert_c          (GString        *string,
-                                        gint             pos,
-                                        gchar            c);
-GString*     g_string_erase            (GString         *string,
-                                        gint             pos,
-                                        gint             len);
-GString*     g_string_down              (GString        *string);
-GString*     g_string_up                (GString        *string);
-void         g_string_sprintf           (GString        *string,
-                                        const gchar     *format,
-                                        ...) G_GNUC_PRINTF (2, 3);
-void         g_string_sprintfa          (GString        *string,
-                                        const gchar     *format,
-                                        ...) G_GNUC_PRINTF (2, 3);
-
-
-/* Resizable arrays, remove fills any cleared spot and shortens the
- * array, while preserving the order. remove_fast will distort the
- * order by moving the last element to the position of the removed 
- */
-
-#define g_array_append_val(a,v)          g_array_append_vals (a, &v, 1)
-#define g_array_prepend_val(a,v)  g_array_prepend_vals (a, &v, 1)
-#define g_array_insert_val(a,i,v) g_array_insert_vals (a, i, &v, 1)
-#define g_array_index(a,t,i)      (((t*) (a)->data) [(i)])
-
-GArray* g_array_new              (gboolean         zero_terminated,
-                                  gboolean         clear,
-                                  guint            element_size);
-GArray* g_array_sized_new         (gboolean        zero_terminated,
-                                  gboolean         clear,
-                                  guint            element_size,
-                                  guint            reserved_size);
-gchar*  g_array_free             (GArray          *array,
-                                  gboolean         free_segment);
-GArray* g_array_append_vals       (GArray         *array,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_prepend_vals      (GArray         *array,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_insert_vals       (GArray          *array,
-                                  guint            index,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_set_size          (GArray         *array,
-                                  guint            length);
-GArray* g_array_remove_index     (GArray          *array,
-                                  guint            index);
-GArray* g_array_remove_index_fast (GArray         *array,
-                                  guint            index);
-
-/* Resizable pointer array.  This interface is much less complicated
- * than the above.  Add appends appends a pointer.  Remove fills any
- * cleared spot and shortens the array. remove_fast will again distort
- * order.  
- */
-#define            g_ptr_array_index(array,index) (array->pdata)[index]
-GPtrArray*  g_ptr_array_new               (void);
-GPtrArray*  g_ptr_array_sized_new         (guint        reserved_size);
-gpointer*   g_ptr_array_free              (GPtrArray   *array,
-                                           gboolean     free_seg);
-void       g_ptr_array_set_size           (GPtrArray   *array,
-                                           gint         length);
-gpointer    g_ptr_array_remove_index      (GPtrArray   *array,
-                                           guint        index);
-gpointer    g_ptr_array_remove_index_fast  (GPtrArray  *array,
-                                           guint        index);
-gboolean    g_ptr_array_remove            (GPtrArray   *array,
-                                           gpointer     data);
-gboolean    g_ptr_array_remove_fast        (GPtrArray  *array,
-                                           gpointer     data);
-void       g_ptr_array_add                (GPtrArray   *array,
-                                           gpointer     data);
-
-/* Byte arrays, an array of guint8.  Implemented as a GArray,
- * but type-safe.
- */
-
-GByteArray* g_byte_array_new              (void);
-GByteArray* g_byte_array_sized_new        (guint        reserved_size);
-guint8*            g_byte_array_free              (GByteArray   *array,
-                                           gboolean      free_segment);
-GByteArray* g_byte_array_append                   (GByteArray   *array,
-                                           const guint8 *data,
-                                           guint         len);
-GByteArray* g_byte_array_prepend           (GByteArray  *array,
-                                           const guint8 *data,
-                                           guint         len);
-GByteArray* g_byte_array_set_size          (GByteArray  *array,
-                                           guint         length);
-GByteArray* g_byte_array_remove_index     (GByteArray   *array,
-                                           guint         index);
-GByteArray* g_byte_array_remove_index_fast (GByteArray  *array,
-                                           guint         index);
-
-
-/* Hash Functions
- */
-gboolean g_str_equal (gconstpointer   v,
-                     gconstpointer   v2);
-guint   g_str_hash  (gconstpointer   v);
-
-gint    g_int_equal (gconstpointer   v,
-                     gconstpointer   v2) G_GNUC_CONST;
-guint   g_int_hash  (gconstpointer   v) G_GNUC_CONST;
-
-/* This "hash" function will just return the key's adress as an
- * unsigned integer. Useful for hashing on plain adresses or
- * simple integer values.
- * passing NULL into g_hash_table_new() as GHashFunc has the
- * same effect as passing g_direct_hash().
- */
-guint g_direct_hash  (gconstpointer v) G_GNUC_CONST;
-gint  g_direct_equal (gconstpointer v,
-                     gconstpointer v2) G_GNUC_CONST;
-
-
-/* Quarks (string<->id association)
- */
-GQuark   g_quark_try_string            (const gchar    *string);
-GQuark   g_quark_from_static_string    (const gchar    *string);
-GQuark   g_quark_from_string           (const gchar    *string);
-gchar*   g_quark_to_string             (GQuark          quark) G_GNUC_CONST;
-
-
-/* Keyed Data List
- */
-void     g_datalist_init                (GData          **datalist);
-void     g_datalist_clear               (GData          **datalist);
-gpointer  g_datalist_id_get_data        (GData          **datalist,
-                                         GQuark           key_id);
-void     g_datalist_id_set_data_full    (GData          **datalist,
-                                         GQuark           key_id,
-                                         gpointer         data,
-                                         GDestroyNotify   destroy_func);
-gpointer  g_datalist_id_remove_no_notify (GData                 **datalist,
-                                         GQuark           key_id);
-void     g_datalist_foreach             (GData          **datalist,
-                                         GDataForeachFunc func,
-                                         gpointer         user_data);
-#define          g_datalist_id_set_data(dl, q, d)      \
-     g_datalist_id_set_data_full ((dl), (q), (d), NULL)
-#define          g_datalist_id_remove_data(dl, q)      \
-     g_datalist_id_set_data ((dl), (q), NULL)
-#define          g_datalist_get_data(dl, k)            \
-     (g_datalist_id_get_data ((dl), g_quark_try_string (k)))
-#define          g_datalist_set_data_full(dl, k, d, f) \
-     g_datalist_id_set_data_full ((dl), g_quark_from_string (k), (d), (f))
-#define          g_datalist_remove_no_notify(dl, k)    \
-     g_datalist_id_remove_no_notify ((dl), g_quark_try_string (k))
-#define          g_datalist_set_data(dl, k, d)         \
-     g_datalist_set_data_full ((dl), (k), (d), NULL)
-#define          g_datalist_remove_data(dl, k)         \
-     g_datalist_id_set_data ((dl), g_quark_try_string (k), NULL)
-
-
-/* Location Associated Keyed Data
- */
-void     g_dataset_destroy             (gconstpointer    dataset_location);
-gpointer  g_dataset_id_get_data                (gconstpointer    dataset_location,
-                                        GQuark           key_id);
-void     g_dataset_id_set_data_full    (gconstpointer    dataset_location,
-                                        GQuark           key_id,
-                                        gpointer         data,
-                                        GDestroyNotify   destroy_func);
-gpointer  g_dataset_id_remove_no_notify        (gconstpointer    dataset_location,
-                                        GQuark           key_id);
-void     g_dataset_foreach             (gconstpointer    dataset_location,
-                                        GDataForeachFunc func,
-                                        gpointer         user_data);
-#define          g_dataset_id_set_data(l, k, d)        \
-     g_dataset_id_set_data_full ((l), (k), (d), NULL)
-#define          g_dataset_id_remove_data(l, k)        \
-     g_dataset_id_set_data ((l), (k), NULL)
-#define          g_dataset_get_data(l, k)              \
-     (g_dataset_id_get_data ((l), g_quark_try_string (k)))
-#define          g_dataset_set_data_full(l, k, d, f)   \
-     g_dataset_id_set_data_full ((l), g_quark_from_string (k), (d), (f))
-#define          g_dataset_remove_no_notify(l, k)      \
-     g_dataset_id_remove_no_notify ((l), g_quark_try_string (k))
-#define          g_dataset_set_data(l, k, d)           \
-     g_dataset_set_data_full ((l), (k), (d), NULL)
-#define          g_dataset_remove_data(l, k)           \
-     g_dataset_id_set_data ((l), g_quark_try_string (k), NULL)
-
-
-/* GScanner: Flexible lexical scanner for general purpose.
- */
-
-/* Character sets */
-#define G_CSET_A_2_Z   "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
-#define G_CSET_a_2_z   "abcdefghijklmnopqrstuvwxyz"
-#define G_CSET_DIGITS  "0123456789"
-#define G_CSET_LATINC  "\300\301\302\303\304\305\306"\
-                       "\307\310\311\312\313\314\315\316\317\320"\
-                       "\321\322\323\324\325\326"\
-                       "\330\331\332\333\334\335\336"
-#define G_CSET_LATINS  "\337\340\341\342\343\344\345\346"\
-                       "\347\350\351\352\353\354\355\356\357\360"\
-                       "\361\362\363\364\365\366"\
-                       "\370\371\372\373\374\375\376\377"
-
-/* Error types */
-typedef enum
-{
-  G_ERR_UNKNOWN,
-  G_ERR_UNEXP_EOF,
-  G_ERR_UNEXP_EOF_IN_STRING,
-  G_ERR_UNEXP_EOF_IN_COMMENT,
-  G_ERR_NON_DIGIT_IN_CONST,
-  G_ERR_DIGIT_RADIX,
-  G_ERR_FLOAT_RADIX,
-  G_ERR_FLOAT_MALFORMED
-} GErrorType;
-
-/* Token types */
-typedef enum
-{
-  G_TOKEN_EOF                  =   0,
-  
-  G_TOKEN_LEFT_PAREN           = '(',
-  G_TOKEN_RIGHT_PAREN          = ')',
-  G_TOKEN_LEFT_CURLY           = '{',
-  G_TOKEN_RIGHT_CURLY          = '}',
-  G_TOKEN_LEFT_BRACE           = '[',
-  G_TOKEN_RIGHT_BRACE          = ']',
-  G_TOKEN_EQUAL_SIGN           = '=',
-  G_TOKEN_COMMA                        = ',',
-  
-  G_TOKEN_NONE                 = 256,
-  
-  G_TOKEN_ERROR,
-  
-  G_TOKEN_CHAR,
-  G_TOKEN_BINARY,
-  G_TOKEN_OCTAL,
-  G_TOKEN_INT,
-  G_TOKEN_HEX,
-  G_TOKEN_FLOAT,
-  G_TOKEN_STRING,
-  
-  G_TOKEN_SYMBOL,
-  G_TOKEN_IDENTIFIER,
-  G_TOKEN_IDENTIFIER_NULL,
-  
-  G_TOKEN_COMMENT_SINGLE,
-  G_TOKEN_COMMENT_MULTI,
-  G_TOKEN_LAST
-} GTokenType;
-
-union  _GTokenValue
-{
-  gpointer     v_symbol;
-  gchar                *v_identifier;
-  gulong       v_binary;
-  gulong       v_octal;
-  gulong       v_int;
-  gdouble      v_float;
-  gulong       v_hex;
-  gchar                *v_string;
-  gchar                *v_comment;
-  guchar       v_char;
-  guint                v_error;
-};
-
-struct _GScannerConfig
-{
-  /* Character sets
-   */
-  gchar                *cset_skip_characters;          /* default: " \t\n" */
-  gchar                *cset_identifier_first;
-  gchar                *cset_identifier_nth;
-  gchar                *cpair_comment_single;          /* default: "#\n" */
-  
-  /* Should symbol lookup work case sensitive?
-   */
-  guint                case_sensitive : 1;
-  
-  /* Boolean values to be adjusted "on the fly"
-   * to configure scanning behaviour.
-   */
-  guint                skip_comment_multi : 1;         /* C like comment */
-  guint                skip_comment_single : 1;        /* single line comment */
-  guint                scan_comment_multi : 1;         /* scan multi line comments? */
-  guint                scan_identifier : 1;
-  guint                scan_identifier_1char : 1;
-  guint                scan_identifier_NULL : 1;
-  guint                scan_symbols : 1;
-  guint                scan_binary : 1;
-  guint                scan_octal : 1;
-  guint                scan_float : 1;
-  guint                scan_hex : 1;                   /* `0x0ff0' */
-  guint                scan_hex_dollar : 1;            /* `$0ff0' */
-  guint                scan_string_sq : 1;             /* string: 'anything' */
-  guint                scan_string_dq : 1;             /* string: "\\-escapes!\n" */
-  guint                numbers_2_int : 1;              /* bin, octal, hex => int */
-  guint                int_2_float : 1;                /* int => G_TOKEN_FLOAT? */
-  guint                identifier_2_string : 1;
-  guint                char_2_token : 1;               /* return G_TOKEN_CHAR? */
-  guint                symbol_2_token : 1;
-  guint                scope_0_fallback : 1;           /* try scope 0 on lookups? */
-};
-
-struct _GScanner
-{
-  /* unused fields */
-  gpointer             user_data;
-  guint                        max_parse_errors;
-  
-  /* g_scanner_error() increments this field */
-  guint                        parse_errors;
-  
-  /* name of input stream, featured by the default message handler */
-  const gchar          *input_name;
-  
-  /* data pointer for derived structures */
-  gpointer             derived_data;
-  
-  /* link into the scanner configuration */
-  GScannerConfig       *config;
-  
-  /* fields filled in after g_scanner_get_next_token() */
-  GTokenType           token;
-  GTokenValue          value;
-  guint                        line;
-  guint                        position;
-  
-  /* fields filled in after g_scanner_peek_next_token() */
-  GTokenType           next_token;
-  GTokenValue          next_value;
-  guint                        next_line;
-  guint                        next_position;
-  
-  /* to be considered private */
-  GHashTable           *symbol_table;
-  gint                 input_fd;
-  const gchar          *text;
-  const gchar          *text_end;
-  gchar                        *buffer;
-  guint                        scope_id;
-  
-  /* handler function for _warn and _error */
-  GScannerMsgFunc      msg_handler;
-};
-
-GScanner*      g_scanner_new                   (GScannerConfig *config_templ);
-void           g_scanner_destroy               (GScanner       *scanner);
-void           g_scanner_input_file            (GScanner       *scanner,
-                                                gint           input_fd);
-void           g_scanner_sync_file_offset      (GScanner       *scanner);
-void           g_scanner_input_text            (GScanner       *scanner,
-                                                const  gchar   *text,
-                                                guint          text_len);
-GTokenType     g_scanner_get_next_token        (GScanner       *scanner);
-GTokenType     g_scanner_peek_next_token       (GScanner       *scanner);
-GTokenType     g_scanner_cur_token             (GScanner       *scanner);
-GTokenValue    g_scanner_cur_value             (GScanner       *scanner);
-guint          g_scanner_cur_line              (GScanner       *scanner);
-guint          g_scanner_cur_position          (GScanner       *scanner);
-gboolean       g_scanner_eof                   (GScanner       *scanner);
-guint          g_scanner_set_scope             (GScanner       *scanner,
-                                                guint           scope_id);
-void           g_scanner_scope_add_symbol      (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol,
-                                                gpointer       value);
-void           g_scanner_scope_remove_symbol   (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol);
-gpointer       g_scanner_scope_lookup_symbol   (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol);
-void           g_scanner_scope_foreach_symbol  (GScanner       *scanner,
-                                                guint           scope_id,
-                                                GHFunc          func,
-                                                gpointer        user_data);
-gpointer       g_scanner_lookup_symbol         (GScanner       *scanner,
-                                                const gchar    *symbol);
-void           g_scanner_unexp_token           (GScanner       *scanner,
-                                                GTokenType     expected_token,
-                                                const gchar    *identifier_spec,
-                                                const gchar    *symbol_spec,
-                                                const gchar    *symbol_name,
-                                                const gchar    *message,
-                                                gint            is_error);
-void           g_scanner_error                 (GScanner       *scanner,
-                                                const gchar    *format,
-                                                ...) G_GNUC_PRINTF (2,3);
-void           g_scanner_warn                  (GScanner       *scanner,
-                                                const gchar    *format,
-                                                ...) G_GNUC_PRINTF (2,3);
-gint           g_scanner_stat_mode             (const gchar    *filename);
-/* keep downward source compatibility */
-#define                g_scanner_add_symbol( scanner, symbol, value )  G_STMT_START { \
-  g_scanner_scope_add_symbol ((scanner), 0, (symbol), (value)); \
-} G_STMT_END
-#define                g_scanner_remove_symbol( scanner, symbol )      G_STMT_START { \
-  g_scanner_scope_remove_symbol ((scanner), 0, (symbol)); \
-} G_STMT_END
-#define                g_scanner_foreach_symbol( scanner, func, data ) G_STMT_START { \
-  g_scanner_scope_foreach_symbol ((scanner), 0, (func), (data)); \
-} G_STMT_END
-
-/* The following two functions are deprecated and will be removed in
- * the next major release. They do no good. */
-void           g_scanner_freeze_symbol_table   (GScanner       *scanner);
-void           g_scanner_thaw_symbol_table     (GScanner       *scanner);
-
-/* GCompletion
- */
-
-struct _GCompletion
-{
-  GList* items;
-  GCompletionFunc func;
-  
-  gchar* prefix;
-  GList* cache;
-};
-
-GCompletion* g_completion_new         (GCompletionFunc func);
-void        g_completion_add_items    (GCompletion*    cmp,
-                                       GList*          items);
-void        g_completion_remove_items (GCompletion*    cmp,
-                                       GList*          items);
-void        g_completion_clear_items  (GCompletion*    cmp);
-GList*      g_completion_complete     (GCompletion*    cmp,
-                                       gchar*          prefix,
-                                       gchar**         new_prefix);
-void        g_completion_free         (GCompletion*    cmp);
-
-
-/* GDate
- *
- * Date calculations (not time for now, to be resolved). These are a
- * mutant combination of Steffen Beyer's DateCalc routines
- * (http://www.perl.com/CPAN/authors/id/STBEY/) and Jon Trowbridge's
- * date routines (written for in-house software).  Written by Havoc
- * Pennington <hp@pobox.com> 
- */
-
-typedef guint16 GDateYear;
-typedef guint8  GDateDay;   /* day of the month */
-typedef struct _GDate GDate;
-/* make struct tm known without having to include time.h */
-struct tm;
-
-/* enum used to specify order of appearance in parsed date strings */
-typedef enum
-{
-  G_DATE_DAY   = 0,
-  G_DATE_MONTH = 1,
-  G_DATE_YEAR  = 2
-} GDateDMY;
-
-/* actual week and month values */
-typedef enum
-{
-  G_DATE_BAD_WEEKDAY  = 0,
-  G_DATE_MONDAY       = 1,
-  G_DATE_TUESDAY      = 2,
-  G_DATE_WEDNESDAY    = 3,
-  G_DATE_THURSDAY     = 4,
-  G_DATE_FRIDAY       = 5,
-  G_DATE_SATURDAY     = 6,
-  G_DATE_SUNDAY       = 7
-} GDateWeekday;
-typedef enum
-{
-  G_DATE_BAD_MONTH = 0,
-  G_DATE_JANUARY   = 1,
-  G_DATE_FEBRUARY  = 2,
-  G_DATE_MARCH     = 3,
-  G_DATE_APRIL     = 4,
-  G_DATE_MAY       = 5,
-  G_DATE_JUNE      = 6,
-  G_DATE_JULY      = 7,
-  G_DATE_AUGUST    = 8,
-  G_DATE_SEPTEMBER = 9,
-  G_DATE_OCTOBER   = 10,
-  G_DATE_NOVEMBER  = 11,
-  G_DATE_DECEMBER  = 12
-} GDateMonth;
-
-#define G_DATE_BAD_JULIAN 0U
-#define G_DATE_BAD_DAY    0U
-#define G_DATE_BAD_YEAR   0U
-
-/* Note: directly manipulating structs is generally a bad idea, but
- * in this case it's an *incredibly* bad idea, because all or part
- * of this struct can be invalid at any given time. Use the functions,
- * or you will get hosed, I promise.
- */
-struct _GDate
-{ 
-  guint julian_days : 32; /* julian days representation - we use a
-                           *  bitfield hoping that 64 bit platforms
-                           *  will pack this whole struct in one big
-                           *  int 
-                           */
-
-  guint julian : 1;    /* julian is valid */
-  guint dmy    : 1;    /* dmy is valid */
-
-  /* DMY representation */
-  guint day    : 6;  
-  guint month  : 4; 
-  guint year   : 16; 
-};
-
-/* g_date_new() returns an invalid date, you then have to _set() stuff 
- * to get a usable object. You can also allocate a GDate statically,
- * then call g_date_clear() to initialize.
- */
-GDate*       g_date_new                   (void);
-GDate*       g_date_new_dmy               (GDateDay     day, 
-                                           GDateMonth   month, 
-                                           GDateYear    year);
-GDate*       g_date_new_julian            (guint32      julian_day);
-void         g_date_free                  (GDate       *date);
-
-/* check g_date_valid() after doing an operation that might fail, like
- * _parse.  Almost all g_date operations are undefined on invalid
- * dates (the exceptions are the mutators, since you need those to
- * return to validity).  
- */
-gboolean     g_date_valid                 (GDate       *date);
-gboolean     g_date_valid_day             (GDateDay     day) G_GNUC_CONST;
-gboolean     g_date_valid_month           (GDateMonth month) G_GNUC_CONST;
-gboolean     g_date_valid_year            (GDateYear  year) G_GNUC_CONST;
-gboolean     g_date_valid_weekday         (GDateWeekday weekday) G_GNUC_CONST;
-gboolean     g_date_valid_julian          (guint32 julian_date) G_GNUC_CONST;
-gboolean     g_date_valid_dmy             (GDateDay     day,
-                                           GDateMonth   month,
-                                           GDateYear    year) G_GNUC_CONST;
-
-GDateWeekday g_date_weekday               (GDate       *date);
-GDateMonth   g_date_month                 (GDate       *date);
-GDateYear    g_date_year                  (GDate       *date);
-GDateDay     g_date_day                   (GDate       *date);
-guint32      g_date_julian                (GDate       *date);
-guint        g_date_day_of_year           (GDate       *date);
-
-/* First monday/sunday is the start of week 1; if we haven't reached
- * that day, return 0. These are not ISO weeks of the year; that
- * routine needs to be added.
- * these functions return the number of weeks, starting on the
- * corrsponding day
- */
-guint        g_date_monday_week_of_year   (GDate      *date);
-guint        g_date_sunday_week_of_year   (GDate      *date);
-
-/* If you create a static date struct you need to clear it to get it
- * in a sane state before use. You can clear a whole array at
- * once with the ndates argument.
- */
-void         g_date_clear                 (GDate       *date, 
-                                           guint        n_dates);
-
-/* The parse routine is meant for dates typed in by a user, so it
- * permits many formats but tries to catch common typos. If your data
- * needs to be strictly validated, it is not an appropriate function.
- */
-void         g_date_set_parse             (GDate       *date,
-                                           const gchar *str);
-void         g_date_set_time              (GDate       *date, 
-                                           GTime        time);
-void         g_date_set_month             (GDate       *date, 
-                                           GDateMonth   month);
-void         g_date_set_day               (GDate       *date, 
-                                           GDateDay     day);
-void         g_date_set_year              (GDate       *date,
-                                           GDateYear    year);
-void         g_date_set_dmy               (GDate       *date,
-                                           GDateDay     day,
-                                           GDateMonth   month,
-                                           GDateYear    y);
-void         g_date_set_julian            (GDate       *date,
-                                           guint32      julian_date);
-gboolean     g_date_is_first_of_month     (GDate       *date);
-gboolean     g_date_is_last_of_month      (GDate       *date);
-
-/* To go forward by some number of weeks just go forward weeks*7 days */
-void         g_date_add_days              (GDate       *date, 
-                                           guint        n_days);
-void         g_date_subtract_days         (GDate       *date, 
-                                           guint        n_days);
-
-/* If you add/sub months while day > 28, the day might change */
-void         g_date_add_months            (GDate       *date,
-                                           guint        n_months);
-void         g_date_subtract_months       (GDate       *date,
-                                           guint        n_months);
-
-/* If it's feb 29, changing years can move you to the 28th */
-void         g_date_add_years             (GDate       *date,
-                                           guint        n_years);
-void         g_date_subtract_years        (GDate       *date,
-                                           guint        n_years);
-gboolean     g_date_is_leap_year          (GDateYear    year) G_GNUC_CONST;
-guint8       g_date_days_in_month         (GDateMonth   month, 
-                                           GDateYear    year) G_GNUC_CONST;
-guint8       g_date_monday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
-guint8       g_date_sunday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
-
-/* qsort-friendly (with a cast...) */
-gint         g_date_compare               (GDate       *lhs,
-                                           GDate       *rhs);
-void         g_date_to_struct_tm          (GDate       *date,
-                                           struct tm   *tm);
-
-/* Just like strftime() except you can only use date-related formats.
- *   Using a time format is undefined.
- */
-gsize        g_date_strftime              (gchar       *s,
-                                           gsize        slen,
-                                           const gchar *format,
-                                           GDate       *date);
-
-
-/* GRelation
- *
- * Indexed Relations.  Imagine a really simple table in a
- * database.  Relations are not ordered.  This data type is meant for
- * maintaining a N-way mapping.
- *
- * g_relation_new() creates a relation with FIELDS fields
- *
- * g_relation_destroy() frees all resources
- * g_tuples_destroy() frees the result of g_relation_select()
- *
- * g_relation_index() indexes relation FIELD with the provided
- *   equality and hash functions.  this must be done before any
- *   calls to insert are made.
- *
- * g_relation_insert() inserts a new tuple.  you are expected to
- *   provide the right number of fields.
- *
- * g_relation_delete() deletes all relations with KEY in FIELD
- * g_relation_select() returns ...
- * g_relation_count() counts ...
- */
-
-GRelation* g_relation_new     (gint        fields);
-void      g_relation_destroy (GRelation   *relation);
-void      g_relation_index   (GRelation   *relation,
-                              gint         field,
-                              GHashFunc    hash_func,
-                              GCompareFunc key_compare_func);
-void      g_relation_insert  (GRelation   *relation,
-                              ...);
-gint      g_relation_delete  (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-GTuples*   g_relation_select  (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-gint      g_relation_count   (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-gboolean   g_relation_exists  (GRelation   *relation,
-                              ...);
-void      g_relation_print   (GRelation   *relation);
-
-void      g_tuples_destroy   (GTuples     *tuples);
-gpointer   g_tuples_index     (GTuples    *tuples,
-                              gint         index,
-                              gint         field);
-
-
-/* GRand - a good and fast random number generator: Mersenne Twister 
- * see http://www.math.keio.ac.jp/~matumoto/emt.html for more info.
- * The range functions return a value in the intervall [min,max).
- * int          -> [0..2^32-1]
- * int_range    -> [min..max-1]
- * double       -> [0..1)
- * double_range -> [min..max)
- */
-
-GRand*  g_rand_new_with_seed   (guint32     seed);
-GRand*  g_rand_new             (void);
-void    g_rand_free            (GRand      *rand);
-
-void    g_rand_set_seed        (GRand      *rand, 
-                               guint32     seed);
-guint32 g_rand_int             (GRand      *rand);
-gint32  g_rand_int_range       (GRand      *rand, 
-                               gint32      min, 
-                               gint32      max);
-gdouble g_rand_double          (GRand      *rand);
-gdouble g_rand_double_range    (GRand      *rand, 
-                               gdouble     min, 
-                               gdouble     max);
-
-void    g_random_set_seed      (guint32     seed);
-guint32 g_random_int           (void);
-gint32  g_random_int_range     (gint32      min, 
-                               gint32      max);
-gdouble g_random_double        (void);
-gdouble g_random_double_range  (gdouble     min, 
-                               gdouble     max);
-
-/* Prime numbers.
- */
-
-/* This function returns prime numbers spaced by approximately 1.5-2.0
- * and is for use in resizing data structures which prefer
- * prime-valued sizes. The closest spaced prime function returns the
- * next largest prime, or the highest it knows about which is about
- * MAXINT/4.
- */
-guint     g_spaced_primes_closest (guint num) G_GNUC_CONST;
-
-
-/* GIOChannel
- */
-
-typedef struct _GIOFuncs GIOFuncs;
-typedef enum
-{
-  G_IO_ERROR_NONE,
-  G_IO_ERROR_AGAIN,
-  G_IO_ERROR_INVAL,
-  G_IO_ERROR_UNKNOWN
-} GIOError;
-typedef enum
-{
-  G_SEEK_CUR,
-  G_SEEK_SET,
-  G_SEEK_END
-} GSeekType;
-typedef enum
-{
-  G_IO_IN      GLIB_SYSDEF_POLLIN,
-  G_IO_OUT     GLIB_SYSDEF_POLLOUT,
-  G_IO_PRI     GLIB_SYSDEF_POLLPRI,
-  G_IO_ERR     GLIB_SYSDEF_POLLERR,
-  G_IO_HUP     GLIB_SYSDEF_POLLHUP,
-  G_IO_NVAL    GLIB_SYSDEF_POLLNVAL
-} GIOCondition;
-
-struct _GIOChannel
-{
-  guint channel_flags;
-  guint ref_count;
-  GIOFuncs *funcs;
-};
-
-typedef gboolean (*GIOFunc) (GIOChannel   *source,
-                            GIOCondition  condition,
-                            gpointer      data);
-struct _GIOFuncs
-{
-  GIOError (*io_read)   (GIOChannel    *channel, 
-                        gchar          *buf, 
-                        guint           count,
-                        guint          *bytes_read);
-  GIOError (*io_write)  (GIOChannel    *channel, 
-                        gchar          *buf, 
-                        guint           count,
-                        guint          *bytes_written);
-  GIOError (*io_seek)   (GIOChannel    *channel, 
-                        gint            offset, 
-                        GSeekType       type);
-  void (*io_close)      (GIOChannel    *channel);
-  guint (*io_add_watch) (GIOChannel     *channel,
-                        gint            priority,
-                        GIOCondition    condition,
-                        GIOFunc         func,
-                        gpointer        user_data,
-                        GDestroyNotify  notify);
-  void (*io_free)       (GIOChannel    *channel);
-};
-
-void        g_io_channel_init   (GIOChannel    *channel);
-void        g_io_channel_ref    (GIOChannel    *channel);
-void        g_io_channel_unref  (GIOChannel    *channel);
-GIOError    g_io_channel_read   (GIOChannel    *channel, 
-                                gchar         *buf, 
-                                guint          count,
-                                guint         *bytes_read);
-GIOError  g_io_channel_write    (GIOChannel    *channel, 
-                                gchar         *buf, 
-                                guint          count,
-                                guint         *bytes_written);
-GIOError  g_io_channel_seek     (GIOChannel    *channel,
-                                gint           offset, 
-                                GSeekType      type);
-void      g_io_channel_close    (GIOChannel    *channel);
-guint     g_io_add_watch_full   (GIOChannel    *channel,
-                                gint           priority,
-                                GIOCondition   condition,
-                                GIOFunc        func,
-                                gpointer       user_data,
-                                GDestroyNotify notify);
-guint    g_io_add_watch         (GIOChannel    *channel,
-                                GIOCondition   condition,
-                                GIOFunc        func,
-                                gpointer       user_data);
-
-
-/* Main loop
- */
-typedef struct _GTimeVal       GTimeVal;
-typedef struct _GSourceFuncs   GSourceFuncs;
-typedef struct _GMainLoop      GMainLoop;      /* Opaque */
-
-struct _GTimeVal
-{
-  glong tv_sec;
-  glong tv_usec;
-};
-struct _GSourceFuncs
-{
-  gboolean (*prepare)  (gpointer  source_data, 
-                       GTimeVal *current_time,
-                       gint     *timeout,
-                       gpointer  user_data);
-  gboolean (*check)    (gpointer  source_data,
-                       GTimeVal *current_time,
-                       gpointer  user_data);
-  gboolean (*dispatch) (gpointer  source_data, 
-                       GTimeVal *dispatch_time,
-                       gpointer  user_data);
-  GDestroyNotify destroy;
-};
-
-/* Standard priorities */
-
-#define G_PRIORITY_HIGH            -100
-#define G_PRIORITY_DEFAULT          0
-#define G_PRIORITY_HIGH_IDLE        100
-#define G_PRIORITY_DEFAULT_IDLE     200
-#define G_PRIORITY_LOW             300
-
-typedef gboolean (*GSourceFunc) (gpointer data);
-
-/* Hooks for adding to the main loop */
-guint    g_source_add                        (gint           priority, 
-                                             gboolean       can_recurse,
-                                             GSourceFuncs  *funcs,
-                                             gpointer       source_data, 
-                                             gpointer       user_data,
-                                             GDestroyNotify notify);
-gboolean g_source_remove                     (guint          tag);
-gboolean g_source_remove_by_user_data        (gpointer       user_data);
-gboolean g_source_remove_by_source_data      (gpointer       source_data);
-gboolean g_source_remove_by_funcs_user_data  (GSourceFuncs  *funcs,
-                                             gpointer       user_data);
-
-void g_get_current_time                        (GTimeVal       *result);
-
-/* Running the main loop */
-GMainLoop*     g_main_new              (gboolean        is_running);
-void           g_main_run              (GMainLoop      *loop);
-void           g_main_quit             (GMainLoop      *loop);
-void           g_main_destroy          (GMainLoop      *loop);
-gboolean       g_main_is_running       (GMainLoop      *loop);
-
-/* Run a single iteration of the mainloop. If block is FALSE,
- * will never block
- */
-gboolean       g_main_iteration        (gboolean       may_block);
-
-/* See if any events are pending */
-gboolean       g_main_pending          (void);
-
-/* Idles and timeouts */
-guint          g_timeout_add_full      (gint           priority,
-                                        guint          interval, 
-                                        GSourceFunc    function,
-                                        gpointer       data,
-                                        GDestroyNotify notify);
-guint          g_timeout_add           (guint          interval,
-                                        GSourceFunc    function,
-                                        gpointer       data);
-guint          g_idle_add              (GSourceFunc    function,
-                                        gpointer       data);
-guint          g_idle_add_full         (gint           priority,
-                                        GSourceFunc    function,
-                                        gpointer       data,
-                                        GDestroyNotify destroy);
-gboolean       g_idle_remove_by_data   (gpointer       data);
-
-/* GPollFD
- *
- * System-specific IO and main loop calls
- *
- * On Win32, the fd in a GPollFD should be Win32 HANDLE (*not* a file
- * descriptor as provided by the C runtime) that can be used by
- * MsgWaitForMultipleObjects. This does *not* include file handles
- * from CreateFile, SOCKETs, nor pipe handles. (But you can use
- * WSAEventSelect to signal events when a SOCKET is readable).
- *
- * On Win32, fd can also be the special value G_WIN32_MSG_HANDLE to
- * indicate polling for messages. These message queue GPollFDs should
- * be added with the g_main_poll_win32_msg_add function.
- *
- * But note that G_WIN32_MSG_HANDLE GPollFDs should not be used by GDK
- * (GTK) programs, as GDK itself wants to read messages and convert them
- * to GDK events.
- *
- * So, unless you really know what you are doing, it's best not to try
- * to use the main loop polling stuff for your own needs on
- * Win32. It's really only written for the GIMP's needs so
- * far.
- */
-
-typedef struct _GPollFD GPollFD;
-typedef gint   (*GPollFunc)    (GPollFD *ufds,
-                                guint    nfsd,
-                                gint     timeout);
-struct _GPollFD
-{
-  gint         fd;
-  gushort      events;
-  gushort      revents;
-};
-
-void        g_main_add_poll          (GPollFD    *fd,
-                                     gint        priority);
-void        g_main_remove_poll       (GPollFD    *fd);
-void        g_main_set_poll_func     (GPollFunc   func);
-
-#ifdef G_OS_WIN32
-
-/* Useful on other platforms, too? */
-
-GPollFunc   g_main_win32_get_poll_func (void);
-
-#endif
-
-/* On Unix, IO channels created with this function for any file
- * descriptor or socket.
- *
- * On Win32, use this only for files opened with the MSVCRT (the
- * Microsoft run-time C library) _open() or _pipe, including file
- * descriptors 0, 1 and 2 (corresponding to stdin, stdout and stderr).
- *
- * The term file descriptor as used in the context of Win32 refers to
- * the emulated Unix-like file descriptors MSVCRT provides. The native
- * corresponding concept is file HANDLE. There isn't as of yet a way to
- * get GIOChannels for file HANDLEs.
- */
-GIOChannel* g_io_channel_unix_new    (int         fd);
-gint        g_io_channel_unix_get_fd (GIOChannel *channel);
-
-#ifdef G_OS_WIN32
-
-#define G_WIN32_MSG_HANDLE 19981206
-
-/* Use this to get a GPollFD from a GIOChannel, so that you can call
- * g_io_channel_win32_poll(). After calling this you should only use
- * g_io_channel_read() to read from the GIOChannel, i.e. never read()
- * or recv() from the underlying file descriptor or SOCKET.
- */
-void        g_io_channel_win32_make_pollfd (GIOChannel   *channel,
-                                           GIOCondition  condition,
-                                           GPollFD      *fd);
-
-/* This can be used to wait a until at least one of the channels is readable.
- * On Unix you would do a select() on the file descriptors of the channels.
- * This should probably be available for all platforms?
- */
-gint        g_io_channel_win32_poll   (GPollFD    *fds,
-                                      gint        n_fds,
-                                      gint        timeout);
-
-/* This is used to add polling for Windows messages. GDK (GTk+) programs
- * should *not* use this.
- */
-void        g_main_poll_win32_msg_add (gint        priority,
-                                      GPollFD    *fd,
-                                      guint       hwnd);
-
-/* An IO channel for Windows messages for window handle hwnd. */
-GIOChannel *g_io_channel_win32_new_messages (guint hwnd);
-
-/* An IO channel for C runtime (emulated Unix-like) file
- * descriptors. Identical to g_io_channel_unix_new above.
- * After calling g_io_add_watch() on a IO channel returned
- * by this function, you shouldn't call read() on the file
- * descriptor.
- */
-GIOChannel* g_io_channel_win32_new_fd (int         fd);
-
-/* Get the C runtime file descriptor of a channel. */
-gint        g_io_channel_win32_get_fd (GIOChannel *channel);
-
-/* An IO channel for a SOCK_STREAM winsock socket. The parameter
- * should be a SOCKET. After calling g_io_add_watch() on a IO channel
- * returned by this function, you shouldn't call recv() on the SOCKET.
- */
-GIOChannel *g_io_channel_win32_new_stream_socket (int socket);
-
-#endif
-
-/* Windows emulation stubs for common Unix functions
- */
-#ifdef G_OS_WIN32
-#  define MAXPATHLEN 1024
-
-#ifdef _MSC_VER
-typedef int pid_t;
-#endif
-
-/*
- * To get prototypes for the following POSIXish functions, you have to
- * include the indicated non-POSIX headers. The functions are defined
- * in OLDNAMES.LIB (MSVC) or -lmoldname-msvc (mingw32).
- *
- * getcwd: <direct.h> (MSVC), <io.h> (mingw32)
- * getpid: <process.h>
- * access: <io.h>
- * unlink: <stdio.h> or <io.h>
- * open, read, write, lseek, close: <io.h>
- * rmdir: <direct.h>
- * pipe: <direct.h>
- */
-
-/* pipe is not in OLDNAMES.LIB or -lmoldname-msvc. */
-#define pipe(phandles) _pipe (phandles, 4096, _O_BINARY)
-
-/* For some POSIX functions that are not provided by the MS runtime,
- * we provide emulators in glib, which are prefixed with g_win32_.
- */
-#    define ftruncate(fd, size)        g_win32_ftruncate (fd, size)
-
-/* -lmingw32 also has emulations for these, but we need our own
- * for MSVC anyhow, so we might aswell use them always.
- */
-#    define opendir            g_win32_opendir
-#    define readdir            g_win32_readdir
-#    define rewinddir          g_win32_rewinddir
-#    define closedir           g_win32_closedir
-#    define NAME_MAX 255
-
-struct dirent
-{
-  gchar  d_name[NAME_MAX + 1];
-};
-
-struct DIR
-{
-  gchar        *dir_name;
-  gboolean     just_opened;
-  guint        find_file_handle;
-  gpointer     find_file_data;
-  struct dirent readdir_result;
-};
-typedef struct DIR DIR;
-
-/* emulation functions */
-extern int     g_win32_ftruncate       (gint            f,
-                                        guint           size);
-DIR*           g_win32_opendir         (const gchar    *dirname);
-struct dirent* g_win32_readdir         (DIR            *dir);
-void           g_win32_rewinddir       (DIR            *dir);
-gint           g_win32_closedir        (DIR            *dir);
-
-/* The MS setlocale uses locale names of the form "English_United
- * States.1252" etc. We want the Unixish standard form "en", "zh_TW"
- * etc. This function gets the current thread locale from Windows and
- * returns it as a string of the above form for use in forming file
- * names etc. The returned string should be deallocated with g_free().
- */
-gchar *                g_win32_getlocale  (void);
-
-/* Translate a Win32 error code (as returned by GetLastError()) into
- * the corresponding message. The returned string should be deallocated
- * with g_free().
- */
-gchar *         g_win32_error_message (gint error);
-
-#endif  /* G_OS_WIN32 */
-
-
-/* GLib Thread support
- */
-
-extern GQuark g_thread_error_quark();
-#define G_THREAD_ERROR g_thread_error_quark()
-
-typedef enum
-{
-  G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */
-} GThreadError;
-
-typedef void           (*GThreadFunc)          (gpointer       value);
-
-typedef enum
-{
-  G_THREAD_PRIORITY_LOW,
-  G_THREAD_PRIORITY_NORMAL,
-  G_THREAD_PRIORITY_HIGH,
-  G_THREAD_PRIORITY_URGENT
-} GThreadPriority;
-
-typedef struct _GThread         GThread;
-struct  _GThread
-{
-  GThreadPriority priority;
-  gboolean bound;
-  gboolean joinable;
-};
-
-typedef struct _GMutex         GMutex;
-typedef struct _GCond          GCond;
-typedef struct _GPrivate       GPrivate;
-typedef struct _GStaticPrivate GStaticPrivate;
-typedef struct _GAsyncQueue    GAsyncQueue;
-typedef struct _GThreadPool     GThreadPool;
-
-typedef struct _GThreadFunctions GThreadFunctions;
-struct _GThreadFunctions
-{
-  GMutex*  (*mutex_new)           (void);
-  void     (*mutex_lock)          (GMutex              *mutex);
-  gboolean (*mutex_trylock)       (GMutex              *mutex);
-  void     (*mutex_unlock)        (GMutex              *mutex);
-  void     (*mutex_free)          (GMutex              *mutex);
-  GCond*   (*cond_new)            (void);
-  void     (*cond_signal)         (GCond               *cond);
-  void     (*cond_broadcast)      (GCond               *cond);
-  void     (*cond_wait)           (GCond               *cond,
-                                  GMutex               *mutex);
-  gboolean (*cond_timed_wait)     (GCond               *cond,
-                                  GMutex               *mutex, 
-                                  GTimeVal             *end_time);
-  void      (*cond_free)          (GCond               *cond);
-  GPrivate* (*private_new)        (GDestroyNotify       destructor);
-  gpointer  (*private_get)        (GPrivate            *private_key);
-  void      (*private_set)        (GPrivate            *private_key,
-                                  gpointer              data);
-  void      (*thread_create)      (GThreadFunc                  thread_func,
-                                  gpointer              arg,
-                                  gulong                stack_size,
-                                  gboolean              joinable,
-                                  gboolean              bound,
-                                  GThreadPriority       priority,
-                                  gpointer              thread,
-                                  GError              **error);
-  void      (*thread_yield)       (void);
-  void      (*thread_join)        (gpointer             thread);
-  void      (*thread_exit)        (void);
-  void      (*thread_set_priority)(gpointer             thread, 
-                                  GThreadPriority       priority);
-  void      (*thread_self)        (gpointer              thread);
-};
-
-GLIB_VAR GThreadFunctions      g_thread_functions_for_glib_use;
-GLIB_VAR gboolean              g_thread_use_default_impl;
-GLIB_VAR gboolean              g_threads_got_initialized;
-
-/* initializes the mutex/cond/private implementation for glib, might
- * only be called once, and must not be called directly or indirectly
- * from another glib-function, e.g. as a callback.
- */
-void   g_thread_init   (GThreadFunctions       *vtable);
-
-/* Errorcheck mutexes. If you define G_ERRORCHECK_MUTEXES, then all
- * mutexes will check for re-locking and re-unlocking */
-
-/* Initialize thread system with errorcheck mutexes. vtable must be
- * NULL.Do not call directly. Use #define G_ERRORCHECK_MUTEXES
- * instead.  
- */
-void    g_thread_init_with_errorcheck_mutexes (GThreadFunctions* vtable);
-
-/* A random number to recognize debug calls to g_mutex_... */
-#define G_MUTEX_DEBUG_MAGIC 0xf8e18ad7
-
-#ifdef G_ERRORCHECK_MUTEXES
-#define g_thread_init(vtable) g_thread_init_with_errorcheck_mutexes (vtable) 
-#endif
-
-/* internal function for fallback static mutex implementation */
-GMutex*        g_static_mutex_get_mutex_impl   (GMutex **mutex);
-
-/* shorthands for conditional and unconditional function calls */
-#define G_THREAD_UF(op, arglist) \
-    (*g_thread_functions_for_glib_use . op) arglist
-#define G_THREAD_CF(op, fail, arg) \
-    (g_thread_supported () ? G_THREAD_UF (op, arg) : (fail))
-#define G_THREAD_ECF(op, fail, mutex, name, type)                      \
-    (g_thread_supported () ?                                           \
-     ((type(*)(GMutex*, gulong, gchar*, gchar*))                       \
-      (*g_thread_functions_for_glib_use . op))                                 \
-     (mutex, G_MUTEX_DEBUG_MAGIC, G_STRINGIFY (name),  G_STRLOC) : (fail))
-#ifndef G_ERRORCHECK_MUTEXES
-#define g_mutex_lock_with_debug_name(mutex, name)                      \
-  G_THREAD_CF (mutex_lock,     (void)0, (mutex))
-#define g_mutex_trylock_with_debug_name(mutex, name)                   \
-   G_THREAD_CF (mutex_trylock,  TRUE,    (mutex))
-#define g_mutex_unlock_with_debug_name(mutex, name)                    \
-   G_THREAD_CF (mutex_unlock,   (void)0, (mutex))
-#else /* G_ERRORCHECK_MUTEXES */
-#define g_mutex_lock_with_debug_name(mutex, name)                      \
-  G_THREAD_ECF (mutex_lock,    (void)0, mutex, name, void)
-#define g_mutex_trylock_with_debug_name(mutex, name)                   \
-  G_THREAD_ECF (mutex_trylock, TRUE,    mutex, name, gboolean)
-#define g_mutex_unlock_with_debug_name(mutex, name)                    \
-  G_THREAD_ECF (mutex_unlock,  (void)0, mutex, name, void)
-#endif /* G_ERRORCHECK_MUTEXES */
-
-#define        g_thread_supported()    (g_threads_got_initialized)
-#define g_mutex_new()            G_THREAD_UF (mutex_new,      ())
-#define g_mutex_lock(mutex)     g_mutex_lock_with_debug_name(mutex, mutex)
-#define g_mutex_trylock(mutex)   g_mutex_trylock_with_debug_name(mutex, mutex)
-#define g_mutex_unlock(mutex)    g_mutex_unlock_with_debug_name(mutex, mutex)
-#define g_mutex_free(mutex)      G_THREAD_CF (mutex_free,     (void)0, (mutex))
-#define g_cond_new()             G_THREAD_UF (cond_new,       ())
-#define g_cond_signal(cond)      G_THREAD_CF (cond_signal,    (void)0, (cond))
-#define g_cond_broadcast(cond)   G_THREAD_CF (cond_broadcast, (void)0, (cond))
-#define g_cond_wait(cond, mutex) G_THREAD_CF (cond_wait,      (void)0, (cond, \
-                                                                        mutex))
-#define g_cond_free(cond)        G_THREAD_CF (cond_free,      (void)0, (cond))
-#define g_cond_timed_wait(cond, mutex, abs_time) G_THREAD_CF (cond_timed_wait, \
-                                                              TRUE, \
-                                                              (cond, mutex, \
-                                                              abs_time))
-#define g_private_new(destructor)        G_THREAD_UF (private_new, (destructor))
-#define g_private_get(private_key)       G_THREAD_CF (private_get, \
-                                                       ((gpointer)private_key), \
-                                                       (private_key))
-#define g_private_set(private_key, value) G_THREAD_CF (private_set, \
-                                                       (void) (private_key = \
-                                                        (GPrivate*) (value)), \
-                                                       (private_key, value))
-#define g_thread_yield()              G_THREAD_CF (thread_yield, (void)0, ())
-#define g_thread_exit()               G_THREAD_CF (thread_exit, (void)0, ())
-
-GThread* g_thread_create (GThreadFunc           thread_func,
-                         gpointer               arg,
-                         gulong                 stack_size,
-                         gboolean               joinable,
-                         gboolean               bound,
-                         GThreadPriority        priority,
-                         GError               **error);
-GThread* g_thread_self ();
-void g_thread_join (GThread *thread);
-void g_thread_set_priority (GThread         *thread, 
-                           GThreadPriority  priority);
-
-/* GStaticMutexes can be statically initialized with the value
- * G_STATIC_MUTEX_INIT, and then they can directly be used, that is
- * much easier, than having to explicitly allocate the mutex before
- * use
- */
-#define g_static_mutex_lock(mutex) \
-    g_mutex_lock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
-#define g_static_mutex_trylock(mutex) \
-    g_mutex_trylock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
-#define g_static_mutex_unlock(mutex) \
-    g_mutex_unlock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex) 
-
-struct _GStaticPrivate
-{
-  guint index;
-};
-#define G_STATIC_PRIVATE_INIT { 0 }
-gpointer g_static_private_get (GStaticPrivate  *private_key);
-void     g_static_private_set (GStaticPrivate  *private_key, 
-                              gpointer          data,
-                              GDestroyNotify    notify);
-gpointer g_static_private_get_for_thread (GStaticPrivate *private_key,
-                                         GThread        *thread);
-void g_static_private_set_for_thread (GStaticPrivate *private_key, 
-                                     GThread        *thread,
-                                     gpointer        data,
-                                     GDestroyNotify  notify);
-
-typedef struct _GStaticRecMutex GStaticRecMutex;
-struct _GStaticRecMutex
-{
-  GStaticMutex mutex;
-  unsigned int depth;
-  GSystemThread owner;
-};
-
-#define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
-void     g_static_rec_mutex_lock        (GStaticRecMutex *mutex);
-gboolean g_static_rec_mutex_trylock     (GStaticRecMutex *mutex);
-void     g_static_rec_mutex_unlock      (GStaticRecMutex *mutex);
-void     g_static_rec_mutex_lock_full   (GStaticRecMutex *mutex,
-                                        guint            depth);
-guint    g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex);
-
-typedef struct _GStaticRWLock GStaticRWLock;
-struct _GStaticRWLock
-{
-  GStaticMutex mutex; 
-  GCond *read_cond;
-  GCond *write_cond;
-  guint read_counter;
-  gboolean write;
-  guint want_to_write;
-};
-
-#define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, FALSE }
-
-void      g_static_rw_lock_reader_lock    (GStaticRWLock* lock);
-gboolean  g_static_rw_lock_reader_trylock (GStaticRWLock* lock);
-void      g_static_rw_lock_reader_unlock  (GStaticRWLock* lock);
-void      g_static_rw_lock_writer_lock    (GStaticRWLock* lock);
-gboolean  g_static_rw_lock_writer_trylock (GStaticRWLock* lock);
-void      g_static_rw_lock_writer_unlock  (GStaticRWLock* lock);
-void      g_static_rw_lock_free (GStaticRWLock* lock);
-
-/* these are some convenience macros that expand to nothing if GLib
- * was configured with --disable-threads. for using StaticMutexes,
- * you define them with G_LOCK_DEFINE_STATIC (name) or G_LOCK_DEFINE (name)
- * if you need to export the mutex. With G_LOCK_EXTERN (name) you can
- * declare such an globally defined lock. name is a unique identifier
- * for the protected varibale or code portion. locking, testing and
- * unlocking of such mutexes can be done with G_LOCK(), G_UNLOCK() and
- * G_TRYLOCK() respectively.  
- */
-extern void glib_dummy_decl (void);
-#define G_LOCK_NAME(name)              g__ ## name ## _lock
-#ifdef G_THREADS_ENABLED
-#  define G_LOCK_DEFINE_STATIC(name)   static G_LOCK_DEFINE (name)
-#  define G_LOCK_DEFINE(name)          \
-    GStaticMutex G_LOCK_NAME (name) = G_STATIC_MUTEX_INIT 
-#  define G_LOCK_EXTERN(name)          extern GStaticMutex G_LOCK_NAME (name)
-
-#  ifdef G_DEBUG_LOCKS
-#    define G_LOCK(name)               G_STMT_START{             \
-        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                          \
-              "file %s: line %d (%s): locking: %s ",             \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name);                                            \
-        g_static_mutex_lock (&G_LOCK_NAME (name));                \
-     }G_STMT_END
-#    define G_UNLOCK(name)             G_STMT_START{             \
-        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                          \
-              "file %s: line %d (%s): unlocking: %s ",           \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name);                                            \
-       g_static_mutex_unlock (&G_LOCK_NAME (name));               \
-     }G_STMT_END
-#    define G_TRYLOCK(name)                                      \
-        (g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                 \
-              "file %s: line %d (%s): try locking: %s ",         \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name), g_static_mutex_trylock (&G_LOCK_NAME (name)))
-#  else         /* !G_DEBUG_LOCKS */
-#    define G_LOCK(name) g_static_mutex_lock      (&G_LOCK_NAME (name)) 
-#    define G_UNLOCK(name) g_static_mutex_unlock   (&G_LOCK_NAME (name))
-#    define G_TRYLOCK(name) g_static_mutex_trylock (&G_LOCK_NAME (name))
-#  endif /* !G_DEBUG_LOCKS */
-#else  /* !G_THREADS_ENABLED */
-#  define G_LOCK_DEFINE_STATIC(name)   extern void glib_dummy_decl (void)
-#  define G_LOCK_DEFINE(name)          extern void glib_dummy_decl (void)
-#  define G_LOCK_EXTERN(name)          extern void glib_dummy_decl (void)
-#  define G_LOCK(name)
-#  define G_UNLOCK(name)
-#  define G_TRYLOCK(name)              (TRUE)
-#endif /* !G_THREADS_ENABLED */
-
-/* Asyncronous Queues, can be used to communicate between threads
- */
-
-/* Get a new GAsyncQueue with the ref_count 1 */
-GAsyncQueue*  g_async_queue_new                (void);
-
-/* Lock and unlock an GAsyncQueue, all functions lock the queue for
- * themselves, but in certain cirumstances you want to hold the lock longer,
- * thus you lock the queue, call the *_unlocked functions and unlock it again
- */
-void          g_async_queue_lock               (GAsyncQueue *queue);
-void          g_async_queue_unlock             (GAsyncQueue *queue);
-
-/* Ref and unref the GAsyncQueue. g_async_queue_unref_unlocked makes
- * no sense, as after the unreffing the Queue might be gone and can't
- * be unlocked. So you have a function to call, if you don't hold the
- * lock (g_async_queue_unref) and one to call, when you already hold
- * the lock (g_async_queue_unref_and_unlock). After that however, you
- * don't hold the lock anymore and the Queue might in fact be
- * destroyed, if you unrefed to zero */
-void          g_async_queue_ref                (GAsyncQueue *queue);
-void          g_async_queue_ref_unlocked       (GAsyncQueue *queue);
-void          g_async_queue_unref              (GAsyncQueue *queue);
-void          g_async_queue_unref_and_unlock   (GAsyncQueue *queue);
-
-/* Push data into the async queue. Must not be NULL */
-void          g_async_queue_push               (GAsyncQueue *queue,
-                                               gpointer     data);
-void          g_async_queue_push_unlocked      (GAsyncQueue *queue,
-                                               gpointer     data);
-
-/* Pop data from the async queue, when no data is there, the thread is blocked
- * until data arrives */
-gpointer      g_async_queue_pop                (GAsyncQueue *queue);
-gpointer      g_async_queue_pop_unlocked       (GAsyncQueue *queue);
-
-/* Try to pop data, NULL is returned in case of empty queue */
-gpointer      g_async_queue_try_pop            (GAsyncQueue *queue);
-gpointer      g_async_queue_try_pop_unlocked   (GAsyncQueue *queue);
-
-/* Wait for data until at maximum until end_time is reached, NULL is returned
- * in case of empty queue*/
-gpointer      g_async_queue_timed_pop          (GAsyncQueue *queue, 
-                                               GTimeVal    *end_time);
-gpointer      g_async_queue_timed_pop_unlocked (GAsyncQueue *queue, 
-                                               GTimeVal    *end_time);
-
-/* Return the length of the queue, negative values mean, that threads
- * are waiting, positve values mean, that there are entries in the
- * queue. Actually this function returns the length of the queue minus
- * the number of waiting threads, g_async_queue_length == 0 could also
- * mean 'n' entries in the queue and 'n' thread waiting, such can
- * happen due to locking of the queue or due to scheduling. */
-gint          g_async_queue_length             (GAsyncQueue *queue);
-gint          g_async_queue_length_unlocked    (GAsyncQueue *queue);
-
-/* Thread Pools
- */
-
-/* The real GThreadPool is bigger, so you may only create a thread
- * pool with the constructor function */
-struct _GThreadPool
-{
-  GFunc thread_func;
-  gulong stack_size;
-  gboolean bound; 
-  GThreadPriority priority;
-  gboolean exclusive;
-  gpointer user_data;
-};
-
-/* Get a thread pool with the function thread_func, at most max_threads may
- * run at a time (max_threads == -1 means no limit), stack_size, bound,
- * priority like in g_thread_create, exclusive == TRUE means, that the threads
- * shouldn't be shared and that they will be prestarted (otherwise they are
- * started, as needed) user_data is the 2nd argument to the thread_func */
-GThreadPool*    g_thread_pool_new             (GFunc            thread_func,
-                                              gint             max_threads,
-                                              gulong           stack_size,
-                                              gboolean         bound,
-                                              GThreadPriority  priority,
-                                              gboolean         exclusive,
-                                              gpointer         user_data,
-                                              GError         **error);
-
-/* Push new data into the thread pool. This task is assigned to a thread later
- * (when the maximal number of threads is reached for that pool) or now
- * (otherwise). If necessary a new thread will be started. The function
- * returns immediatly */
-void            g_thread_pool_push            (GThreadPool     *pool,
-                                              gpointer         data,
-                                              GError         **error);
-
-/* Set the number of threads, which can run concurrently for that pool, -1
- * means no limit. 0 means has the effect, that the pool won't process
- * requests until the limit is set higher again */
-void            g_thread_pool_set_max_threads (GThreadPool     *pool,
-                                              gint             max_threads,
-                                              GError         **error);
-gint            g_thread_pool_get_max_threads (GThreadPool     *pool);
-
-/* Get the number of threads assigned to that pool. This number doesn't
- * necessarily represent the number of working threads in that pool */
-guint           g_thread_pool_get_num_threads (GThreadPool     *pool);
-
-/* Get the number of unprocessed items in the pool */
-guint           g_thread_pool_unprocessed     (GThreadPool     *pool);
-
-/* Free the pool, immediate means, that all unprocessed items in the queue
- * wont be processed, wait means, that the function doesn't return immediatly,
- * but after all threads in the pool are ready processing items. immediate
- * does however not mean, that threads are killed. */
-void            g_thread_pool_free            (GThreadPool     *pool,
-                                               gboolean         immediate,
-                                              gboolean         wait);
-
-/* Set the maximal number of unused threads before threads will be stopped by
- * GLib, -1 means no limit */
-void            g_thread_pool_set_max_unused_threads (gint      max_threads);
-gint            g_thread_pool_get_max_unused_threads (void);
-guint           g_thread_pool_get_num_unused_threads (void);
-
-/* Stop all currently unused threads, but leave the limit untouched */
-void            g_thread_pool_stop_unused_threads    (void);
-
-typedef enum 
-{
-  G_CONVERT_ERROR_NO_CONVERSION,
-  G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
-  G_CONVERT_ERROR_FAILED
-} GConvertError;
-
-#define G_CONVERT_ERROR g_convert_error_quark()
-GQuark g_convert_error_quark();
-
-gchar* g_convert               (const gchar  *str,
-                               gint          len,
-                               const gchar  *to_codeset,
-                               const gchar  *from_codeset,
-                               gint         *bytes_read,
-                               gint         *bytes_written,
-                               GError      **error);
-gchar* g_convert_with_fallback (const gchar  *str,
-                               gint          len,
-                               const gchar  *to_codeset,
-                               const gchar  *from_codeset,
-                               gchar        *fallback,
-                               gint         *bytes_read,
-                               gint         *bytes_written,
-                               GError      **error);
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
-
-#include <gunicode.h>
-#include <gerror.h>
+#include <galloca.h>
+#include <garray.h>
+#include <gasyncqueue.h>
+#include <gbacktrace.h>
+#include <gcache.h>
+#include <gcompletion.h>
+#include <gconvert.h>
+#include <gdataset.h>
+#include <gdate.h>
+#include <gfileutils.h>
+#include <ghash.h>
+#include <ghook.h>
+#include <giochannel.h>
+#include <glist.h>
+#include <gmacros.h>
+#include <gmain.h>
+#include <gmem.h>
+#include <gmessages.h>
+#include <gnode.h>
+#include <gprimes.h>
+#include <gquark.h>
+#include <gqueue.h>
+#include <grand.h>
+#include <grel.h>
+#include <gscanner.h>
 #include <gshell.h>
+#include <gslist.h>
 #include <gspawn.h>
-#include <gfileutils.h>
+#include <gstrfuncs.h>
+#include <gstring.h>
+#include <gthread.h>
+#include <gthreadpool.h>
+#include <gtimer.h>
+#include <gtree.h>
+#include <gtypes.h>
+#include <gunicode.h>
+#include <gutils.h>
 
 #endif /* __G_LIB_H__ */
diff --git a/glib/galloca.h b/glib/galloca.h
new file mode 100644 (file)
index 0000000..b4194d4
--- /dev/null
@@ -0,0 +1,60 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ALLOCA_H__
+#define __G_ALLOCA_H__
+
+#include <gtypes.h>
+
+#ifdef  __GNUC__
+/* GCC does the right thing */
+# undef alloca
+# define alloca(size)   __builtin_alloca (size)
+#elif defined (GLIB_HAVE_ALLOCA_H)
+/* a native and working alloca.h is there */ 
+# include <alloca.h>
+#else /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
+# ifdef _MSC_VER
+#  include <malloc.h>
+#  define alloca _alloca
+# else /* !_MSC_VER */
+#  ifdef _AIX
+ #pragma alloca
+#  else /* !_AIX */
+#   ifndef alloca /* predefined by HP cc +Olibcalls */
+G_BEGIN_DECLS
+char *alloca ();
+G_END_DECLS
+#   endif /* !alloca */
+#  endif /* !_AIX */
+# endif /* !_MSC_VER */
+#endif /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
+
+#define g_alloca(size) alloca (size)
+
+
+#endif /* __G_ALLOCA_H__ */
+
diff --git a/glib/garray.h b/glib/garray.h
new file mode 100644 (file)
index 0000000..5ea9de6
--- /dev/null
@@ -0,0 +1,139 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ARRAY_H__
+#define __G_ARRAY_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GArray         GArray;
+typedef struct _GByteArray     GByteArray;
+typedef struct _GPtrArray      GPtrArray;
+
+struct _GArray
+{
+  gchar *data;
+  guint len;
+};
+
+struct _GByteArray
+{
+  guint8 *data;
+  guint          len;
+};
+
+struct _GPtrArray
+{
+  gpointer *pdata;
+  guint            len;
+};
+
+/* Resizable arrays, remove fills any cleared spot and shortens the
+ * array, while preserving the order. remove_fast will distort the
+ * order by moving the last element to the position of the removed 
+ */
+
+#define g_array_append_val(a,v)          g_array_append_vals (a, &v, 1)
+#define g_array_prepend_val(a,v)  g_array_prepend_vals (a, &v, 1)
+#define g_array_insert_val(a,i,v) g_array_insert_vals (a, i, &v, 1)
+#define g_array_index(a,t,i)      (((t*) (a)->data) [(i)])
+
+GArray* g_array_new              (gboolean         zero_terminated,
+                                  gboolean         clear,
+                                  guint            element_size);
+GArray* g_array_sized_new         (gboolean        zero_terminated,
+                                  gboolean         clear,
+                                  guint            element_size,
+                                  guint            reserved_size);
+gchar*  g_array_free             (GArray          *array,
+                                  gboolean         free_segment);
+GArray* g_array_append_vals       (GArray         *array,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_prepend_vals      (GArray         *array,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_insert_vals       (GArray          *array,
+                                  guint            index,
+                                  gconstpointer    data,
+                                  guint            len);
+GArray* g_array_set_size          (GArray         *array,
+                                  guint            length);
+GArray* g_array_remove_index     (GArray          *array,
+                                  guint            index);
+GArray* g_array_remove_index_fast (GArray         *array,
+                                  guint            index);
+
+/* Resizable pointer array.  This interface is much less complicated
+ * than the above.  Add appends appends a pointer.  Remove fills any
+ * cleared spot and shortens the array. remove_fast will again distort
+ * order.  
+ */
+#define            g_ptr_array_index(array,index) (array->pdata)[index]
+GPtrArray*  g_ptr_array_new               (void);
+GPtrArray*  g_ptr_array_sized_new         (guint        reserved_size);
+gpointer*   g_ptr_array_free              (GPtrArray   *array,
+                                           gboolean     free_seg);
+void       g_ptr_array_set_size           (GPtrArray   *array,
+                                           gint         length);
+gpointer    g_ptr_array_remove_index      (GPtrArray   *array,
+                                           guint        index);
+gpointer    g_ptr_array_remove_index_fast  (GPtrArray  *array,
+                                           guint        index);
+gboolean    g_ptr_array_remove            (GPtrArray   *array,
+                                           gpointer     data);
+gboolean    g_ptr_array_remove_fast        (GPtrArray  *array,
+                                           gpointer     data);
+void       g_ptr_array_add                (GPtrArray   *array,
+                                           gpointer     data);
+
+/* Byte arrays, an array of guint8.  Implemented as a GArray,
+ * but type-safe.
+ */
+
+GByteArray* g_byte_array_new              (void);
+GByteArray* g_byte_array_sized_new        (guint        reserved_size);
+guint8*            g_byte_array_free              (GByteArray   *array,
+                                           gboolean      free_segment);
+GByteArray* g_byte_array_append                   (GByteArray   *array,
+                                           const guint8 *data,
+                                           guint         len);
+GByteArray* g_byte_array_prepend           (GByteArray  *array,
+                                           const guint8 *data,
+                                           guint         len);
+GByteArray* g_byte_array_set_size          (GByteArray  *array,
+                                           guint         length);
+GByteArray* g_byte_array_remove_index     (GByteArray   *array,
+                                           guint         index);
+GByteArray* g_byte_array_remove_index_fast (GByteArray  *array,
+                                           guint         index);
+
+G_END_DECLS
+
+#endif /* __G_ARRAY_H__ */
+
diff --git a/glib/gasyncqueue.h b/glib/gasyncqueue.h
new file mode 100644 (file)
index 0000000..6e87425
--- /dev/null
@@ -0,0 +1,95 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_ASYNCQUEUE_H__
+#define __G_ASYNCQUEUE_H__
+
+#include <gthread.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GAsyncQueue     GAsyncQueue;
+
+/* Asyncronous Queues, can be used to communicate between threads
+ */
+
+/* Get a new GAsyncQueue with the ref_count 1 */
+GAsyncQueue*  g_async_queue_new                (void);
+
+/* Lock and unlock an GAsyncQueue, all functions lock the queue for
+ * themselves, but in certain cirumstances you want to hold the lock longer,
+ * thus you lock the queue, call the *_unlocked functions and unlock it again
+ */
+void          g_async_queue_lock               (GAsyncQueue *queue);
+void          g_async_queue_unlock             (GAsyncQueue *queue);
+
+/* Ref and unref the GAsyncQueue. g_async_queue_unref_unlocked makes
+ * no sense, as after the unreffing the Queue might be gone and can't
+ * be unlocked. So you have a function to call, if you don't hold the
+ * lock (g_async_queue_unref) and one to call, when you already hold
+ * the lock (g_async_queue_unref_and_unlock). After that however, you
+ * don't hold the lock anymore and the Queue might in fact be
+ * destroyed, if you unrefed to zero */
+void          g_async_queue_ref                (GAsyncQueue *queue);
+void          g_async_queue_ref_unlocked       (GAsyncQueue *queue);
+void          g_async_queue_unref              (GAsyncQueue *queue);
+void          g_async_queue_unref_and_unlock   (GAsyncQueue *queue);
+
+/* Push data into the async queue. Must not be NULL */
+void          g_async_queue_push               (GAsyncQueue *queue,
+                                                gpointer     data);
+void          g_async_queue_push_unlocked      (GAsyncQueue *queue,
+                                                gpointer     data);
+
+/* Pop data from the async queue, when no data is there, the thread is blocked
+ * until data arrives */
+gpointer      g_async_queue_pop                (GAsyncQueue *queue);
+gpointer      g_async_queue_pop_unlocked       (GAsyncQueue *queue);
+
+/* Try to pop data, NULL is returned in case of empty queue */
+gpointer      g_async_queue_try_pop            (GAsyncQueue *queue);
+gpointer      g_async_queue_try_pop_unlocked   (GAsyncQueue *queue);
+
+/* Wait for data until at maximum until end_time is reached, NULL is returned
+ * in case of empty queue*/
+gpointer      g_async_queue_timed_pop          (GAsyncQueue *queue,
+                                                GTimeVal    *end_time);
+gpointer      g_async_queue_timed_pop_unlocked (GAsyncQueue *queue,
+                                                GTimeVal    *end_time);
+
+/* Return the length of the queue, negative values mean, that threads
+ * are waiting, positve values mean, that there are entries in the
+ * queue. Actually this function returns the length of the queue minus
+ * the number of waiting threads, g_async_queue_length == 0 could also
+ * mean 'n' entries in the queue and 'n' thread waiting, such can
+ * happen due to locking of the queue or due to scheduling. */
+gint          g_async_queue_length             (GAsyncQueue *queue);
+gint          g_async_queue_length_unlocked    (GAsyncQueue *queue);
+
+G_END_DECLS
+
+#endif /* __G_ASYNCQUEUE_H__ */
+
diff --git a/glib/gbacktrace.h b/glib/gbacktrace.h
new file mode 100644 (file)
index 0000000..2a3a856
--- /dev/null
@@ -0,0 +1,59 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_BACKTRACE_H__
+#define __G_BACKTRACE_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Fatal error handlers.
+ * g_on_error_query() will prompt the user to either
+ * [E]xit, [H]alt, [P]roceed or show [S]tack trace.
+ * g_on_error_stack_trace() invokes gdb, which attaches to the current
+ * process and shows a stack trace.
+ * These function may cause different actions on non-unix platforms.
+ * The prg_name arg is required by gdb to find the executable, if it is
+ * passed as NULL, g_on_error_query() will try g_get_prgname().
+ */
+void g_on_error_query (const gchar *prg_name);
+void g_on_error_stack_trace (const gchar *prg_name);
+
+/* Hacker macro to place breakpoints for elected machines.
+ * Actual use is strongly deprecated of course ;)
+ */
+#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("int $03"); }G_STMT_END
+#elif defined (__alpha__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("bpt"); }G_STMT_END
+#else  /* !__i386__ && !__alpha__ */
+#  define G_BREAKPOINT()       G_STMT_START{ raise (5 /* SIGTRAP */); }G_STMT_END
+#endif /* __i386__ */
+
+G_END_DECLS
+
+#endif /* __G_BACKTRACE_H__ */
diff --git a/glib/gcache.h b/glib/gcache.h
new file mode 100644 (file)
index 0000000..10b5c91
--- /dev/null
@@ -0,0 +1,66 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_CACHE_H__
+#define __G_CACHE_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GCache          GCache;
+
+typedef gpointer        (*GCacheNewFunc)        (gpointer       key);
+typedef gpointer        (*GCacheDupFunc)        (gpointer       value);
+typedef void            (*GCacheDestroyFunc)    (gpointer       value);
+
+/* Caches
+ */
+GCache*  g_cache_new           (GCacheNewFunc      value_new_func,
+                                GCacheDestroyFunc  value_destroy_func,
+                                GCacheDupFunc      key_dup_func,
+                                GCacheDestroyFunc  key_destroy_func,
+                                GHashFunc          hash_key_func,
+                                GHashFunc          hash_value_func,
+                                GCompareFunc       key_compare_func);
+void     g_cache_destroy       (GCache            *cache);
+gpointer g_cache_insert        (GCache            *cache,
+                                gpointer           key);
+void     g_cache_remove        (GCache            *cache,
+                                gconstpointer      value);
+void     g_cache_key_foreach   (GCache            *cache,
+                                GHFunc             func,
+                                gpointer           user_data);
+void     g_cache_value_foreach (GCache            *cache,
+                                GHFunc             func,
+                                gpointer           user_data);
+
+G_END_DECLS
+
+#endif /* __G_CACHE_H__ */
+
+
+
diff --git a/glib/gcompletion.h b/glib/gcompletion.h
new file mode 100644 (file)
index 0000000..5af9475
--- /dev/null
@@ -0,0 +1,64 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_COMPLETION_H__
+#define __G_COMPLETION_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GCompletion     GCompletion;
+
+typedef gchar*          (*GCompletionFunc)      (gpointer);
+
+/* GCompletion
+ */
+
+struct _GCompletion
+{
+  GList* items;
+  GCompletionFunc func;
+  gchar* prefix;
+  GList* cache;
+};
+
+GCompletion* g_completion_new          (GCompletionFunc func);
+void         g_completion_add_items    (GCompletion*    cmp,
+                                        GList*          items);
+void         g_completion_remove_items (GCompletion*    cmp,
+                                        GList*          items);
+void         g_completion_clear_items  (GCompletion*    cmp);
+GList*       g_completion_complete     (GCompletion*    cmp,
+                                        gchar*          prefix,
+                                        gchar**         new_prefix);
+void         g_completion_free         (GCompletion*    cmp);
+
+G_END_DECLS
+
+#endif /* __G_COMPLETION_H__ */
+
diff --git a/glib/gconvert.h b/glib/gconvert.h
new file mode 100644 (file)
index 0000000..0586a19
--- /dev/null
@@ -0,0 +1,62 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_CONVERT_H__
+#define __G_CONVERT_H__
+
+#include <gerror.h>
+
+G_BEGIN_DECLS
+
+typedef enum 
+{
+  G_CONVERT_ERROR_NO_CONVERSION,
+  G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
+  G_CONVERT_ERROR_FAILED
+} GConvertError;
+
+#define G_CONVERT_ERROR g_convert_error_quark()
+GQuark g_convert_error_quark();
+
+gchar* g_convert               (const gchar  *str,
+                               gint          len,
+                               const gchar  *to_codeset,
+                               const gchar  *from_codeset,
+                               gint         *bytes_read,
+                               gint         *bytes_written,
+                               GError      **error);
+gchar* g_convert_with_fallback (const gchar  *str,
+                               gint          len,
+                               const gchar  *to_codeset,
+                               const gchar  *from_codeset,
+                               gchar        *fallback,
+                               gint         *bytes_read,
+                               gint         *bytes_written,
+                               GError      **error);
+
+G_END_DECLS
+
+#endif /* __G_CONVERT_H__ */
diff --git a/glib/gdataset.h b/glib/gdataset.h
new file mode 100644 (file)
index 0000000..f9d15b3
--- /dev/null
@@ -0,0 +1,106 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_DATASET_H__
+#define __G_DATASET_H__
+
+#include <gquark.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GData           GData;
+
+typedef void            (*GDataForeachFunc)     (GQuark         key_id,
+                                                 gpointer       data,
+                                                 gpointer       user_data);
+
+/* Keyed Data List
+ */
+void      g_datalist_init                (GData          **datalist);
+void      g_datalist_clear               (GData          **datalist);
+gpointer  g_datalist_id_get_data         (GData          **datalist,
+                                          GQuark           key_id);
+void      g_datalist_id_set_data_full    (GData          **datalist,
+                                          GQuark           key_id,
+                                          gpointer         data,
+                                          GDestroyNotify   destroy_func);
+gpointer  g_datalist_id_remove_no_notify (GData          **datalist,
+                                          GQuark           key_id);
+void      g_datalist_foreach             (GData          **datalist,
+                                          GDataForeachFunc func,
+                                          gpointer         user_data);
+#define   g_datalist_id_set_data(dl, q, d)      \
+     g_datalist_id_set_data_full ((dl), (q), (d), NULL)
+#define   g_datalist_id_remove_data(dl, q)      \
+     g_datalist_id_set_data ((dl), (q), NULL)
+#define   g_datalist_get_data(dl, k)            \
+     (g_datalist_id_get_data ((dl), g_quark_try_string (k)))
+#define   g_datalist_set_data_full(dl, k, d, f) \
+     g_datalist_id_set_data_full ((dl), g_quark_from_string (k), (d), (f))
+#define   g_datalist_remove_no_notify(dl, k)    \
+     g_datalist_id_remove_no_notify ((dl), g_quark_try_string (k))
+#define   g_datalist_set_data(dl, k, d)         \
+     g_datalist_set_data_full ((dl), (k), (d), NULL)
+#define   g_datalist_remove_data(dl, k)         \
+     g_datalist_id_set_data ((dl), g_quark_try_string (k), NULL)
+
+
+/* Location Associated Keyed Data
+ */
+void      g_dataset_destroy             (gconstpointer    dataset_location);
+gpointer  g_dataset_id_get_data         (gconstpointer    dataset_location,
+                                         GQuark           key_id);
+void      g_dataset_id_set_data_full    (gconstpointer    dataset_location,
+                                         GQuark           key_id,
+                                         gpointer         data,
+                                         GDestroyNotify   destroy_func);
+gpointer  g_dataset_id_remove_no_notify (gconstpointer    dataset_location,
+                                         GQuark           key_id);
+void      g_dataset_foreach             (gconstpointer    dataset_location,
+                                         GDataForeachFunc func,
+                                         gpointer         user_data);
+#define   g_dataset_id_set_data(l, k, d)        \
+     g_dataset_id_set_data_full ((l), (k), (d), NULL)
+#define   g_dataset_id_remove_data(l, k)        \
+     g_dataset_id_set_data ((l), (k), NULL)
+#define   g_dataset_get_data(l, k)              \
+     (g_dataset_id_get_data ((l), g_quark_try_string (k)))
+#define   g_dataset_set_data_full(l, k, d, f)   \
+     g_dataset_id_set_data_full ((l), g_quark_from_string (k), (d), (f))
+#define   g_dataset_remove_no_notify(l, k)      \
+     g_dataset_id_remove_no_notify ((l), g_quark_try_string (k))
+#define   g_dataset_set_data(l, k, d)           \
+     g_dataset_set_data_full ((l), (k), (d), NULL)
+#define   g_dataset_remove_data(l, k)           \
+     g_dataset_id_set_data ((l), g_quark_try_string (k), NULL)
+
+G_END_DECLS
+
+#endif /* __G_DATASET_H__ */
+
+
+
+
diff --git a/glib/gdate.h b/glib/gdate.h
new file mode 100644 (file)
index 0000000..149eace
--- /dev/null
@@ -0,0 +1,224 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_DATE_H__
+#define __G_DATE_H__
+
+#include <gquark.h>
+
+G_BEGIN_DECLS
+
+/* GDate
+ *
+ * Date calculations (not time for now, to be resolved). These are a
+ * mutant combination of Steffen Beyer's DateCalc routines
+ * (http://www.perl.com/CPAN/authors/id/STBEY/) and Jon Trowbridge's
+ * date routines (written for in-house software).  Written by Havoc
+ * Pennington <hp@pobox.com>
+ */
+
+typedef gint32  GTime;
+typedef guint16 GDateYear;
+typedef guint8  GDateDay;   /* day of the month */
+typedef struct _GDate GDate;
+/* make struct tm known without having to include time.h */
+struct tm;
+
+/* enum used to specify order of appearance in parsed date strings */
+typedef enum
+{
+  G_DATE_DAY   = 0,
+  G_DATE_MONTH = 1,
+  G_DATE_YEAR  = 2
+} GDateDMY;
+
+/* actual week and month values */
+typedef enum
+{
+  G_DATE_BAD_WEEKDAY  = 0,
+  G_DATE_MONDAY       = 1,
+  G_DATE_TUESDAY      = 2,
+  G_DATE_WEDNESDAY    = 3,
+  G_DATE_THURSDAY     = 4,
+  G_DATE_FRIDAY       = 5,
+  G_DATE_SATURDAY     = 6,
+  G_DATE_SUNDAY       = 7
+} GDateWeekday;
+typedef enum
+{
+  G_DATE_BAD_MONTH = 0,
+  G_DATE_JANUARY   = 1,
+  G_DATE_FEBRUARY  = 2,
+  G_DATE_MARCH     = 3,
+  G_DATE_APRIL     = 4,
+  G_DATE_MAY       = 5,
+  G_DATE_JUNE      = 6,
+  G_DATE_JULY      = 7,
+  G_DATE_AUGUST    = 8,
+  G_DATE_SEPTEMBER = 9,
+  G_DATE_OCTOBER   = 10,
+  G_DATE_NOVEMBER  = 11,
+  G_DATE_DECEMBER  = 12
+} GDateMonth;
+
+#define G_DATE_BAD_JULIAN 0U
+#define G_DATE_BAD_DAY    0U
+#define G_DATE_BAD_YEAR   0U
+
+/* Note: directly manipulating structs is generally a bad idea, but
+ * in this case it's an *incredibly* bad idea, because all or part
+ * of this struct can be invalid at any given time. Use the functions,
+ * or you will get hosed, I promise.
+ */
+struct _GDate
+{
+  guint julian_days : 32; /* julian days representation - we use a
+                           *  bitfield hoping that 64 bit platforms
+                           *  will pack this whole struct in one big
+                           *  int
+                           */
+
+  guint julian : 1;    /* julian is valid */
+  guint dmy    : 1;    /* dmy is valid */
+
+  /* DMY representation */
+  guint day    : 6;
+  guint month  : 4;
+  guint year   : 16;
+};
+
+/* g_date_new() returns an invalid date, you then have to _set() stuff
+ * to get a usable object. You can also allocate a GDate statically,
+ * then call g_date_clear() to initialize.
+ */
+GDate*       g_date_new                   (void);
+GDate*       g_date_new_dmy               (GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    year);
+GDate*       g_date_new_julian            (guint32      julian_day);
+void         g_date_free                  (GDate       *date);
+
+/* check g_date_valid() after doing an operation that might fail, like
+ * _parse.  Almost all g_date operations are undefined on invalid
+ * dates (the exceptions are the mutators, since you need those to
+ * return to validity).
+ */
+gboolean     g_date_valid                 (GDate       *date);
+gboolean     g_date_valid_day             (GDateDay     day) G_GNUC_CONST;
+gboolean     g_date_valid_month           (GDateMonth month) G_GNUC_CONST;
+gboolean     g_date_valid_year            (GDateYear  year) G_GNUC_CONST;
+gboolean     g_date_valid_weekday         (GDateWeekday weekday) G_GNUC_CONST;
+gboolean     g_date_valid_julian          (guint32 julian_date) G_GNUC_CONST;
+gboolean     g_date_valid_dmy             (GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    year) G_GNUC_CONST;
+
+GDateWeekday g_date_weekday               (GDate       *date);
+GDateMonth   g_date_month                 (GDate       *date);
+GDateYear    g_date_year                  (GDate       *date);
+GDateDay     g_date_day                   (GDate       *date);
+guint32      g_date_julian                (GDate       *date);
+guint        g_date_day_of_year           (GDate       *date);
+/* First monday/sunday is the start of week 1; if we haven't reached
+ * that day, return 0. These are not ISO weeks of the year; that
+ * routine needs to be added.
+ * these functions return the number of weeks, starting on the
+ * corrsponding day
+ */
+guint        g_date_monday_week_of_year   (GDate      *date);
+guint        g_date_sunday_week_of_year   (GDate      *date);
+
+/* If you create a static date struct you need to clear it to get it
+ * in a sane state before use. You can clear a whole array at
+ * once with the ndates argument.
+ */
+void         g_date_clear                 (GDate       *date,
+                                           guint        n_dates);
+
+/* The parse routine is meant for dates typed in by a user, so it
+ * permits many formats but tries to catch common typos. If your data
+ * needs to be strictly validated, it is not an appropriate function.
+ */
+void         g_date_set_parse             (GDate       *date,
+                                           const gchar *str);
+void         g_date_set_time              (GDate       *date,
+                                           GTime        time);
+void         g_date_set_month             (GDate       *date,
+                                           GDateMonth   month);
+void         g_date_set_day               (GDate       *date,
+                                           GDateDay     day);
+void         g_date_set_year              (GDate       *date,
+                                           GDateYear    year);
+void         g_date_set_dmy               (GDate       *date,
+                                           GDateDay     day,
+                                           GDateMonth   month,
+                                           GDateYear    y);
+void         g_date_set_julian            (GDate       *date,
+                                           guint32      julian_date);
+gboolean     g_date_is_first_of_month     (GDate       *date);
+gboolean     g_date_is_last_of_month      (GDate       *date);
+
+/* To go forward by some number of weeks just go forward weeks*7 days */
+void         g_date_add_days              (GDate       *date,
+                                           guint        n_days);
+void         g_date_subtract_days         (GDate       *date,
+                                           guint        n_days);
+
+/* If you add/sub months while day > 28, the day might change */
+void         g_date_add_months            (GDate       *date,
+                                           guint        n_months);
+void         g_date_subtract_months       (GDate       *date,
+                                           guint        n_months);
+
+/* If it's feb 29, changing years can move you to the 28th */
+void         g_date_add_years             (GDate       *date,
+                                           guint        n_years);
+void         g_date_subtract_years        (GDate       *date,
+                                           guint        n_years);
+gboolean     g_date_is_leap_year          (GDateYear    year) G_GNUC_CONST;
+guint8       g_date_days_in_month         (GDateMonth   month,
+                                           GDateYear    year) G_GNUC_CONST;
+guint8       g_date_monday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
+guint8       g_date_sunday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
+
+/* qsort-friendly (with a cast...) */
+gint         g_date_compare               (GDate       *lhs,
+                                           GDate       *rhs);
+void         g_date_to_struct_tm          (GDate       *date,
+                                           struct tm   *tm);
+
+/* Just like strftime() except you can only use date-related formats.
+ *   Using a time format is undefined.
+ */
+gsize        g_date_strftime              (gchar       *s,
+                                           gsize        slen,
+                                           const gchar *format,
+                                           GDate       *date);
+
+G_END_DECLS
+
+#endif /* __G_DATE_H__ */
+
index 458c20a..a7eb8fd 100644 (file)
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GERROR_H__
-#define __GERROR_H__
+#ifndef __G_ERROR_H__
+#define __G_ERROR_H__
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+#include <gquark.h>
+
+G_BEGIN_DECLS
 
 typedef struct _GError GError;
 
@@ -69,9 +68,7 @@ void     g_propagate_error     (GError       **dest,
 void     g_clear_error         (GError       **err);
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GERROR_H__ */
+#endif /* __G_ERROR_H__ */
 
index f6edd43..d49c921 100644 (file)
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GFILEUTILS_H__
-#define __GFILEUTILS_H__
+#ifndef __G_FILEUTILS_H__
+#define __G_FILEUTILS_H__
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+#include <gerror.h>
+
+G_BEGIN_DECLS
 
 #define G_FILE_ERROR g_file_error_quark ()
 
@@ -82,10 +81,8 @@ gboolean g_file_get_contents (const gchar  *filename,
 
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GFILEUTILS_H__ */
+#endif /* __G_FILEUTILS_H__ */
 
 
diff --git a/glib/ghash.h b/glib/ghash.h
new file mode 100644 (file)
index 0000000..280ad60
--- /dev/null
@@ -0,0 +1,92 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_HASH_H__
+#define __G_HASH_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GHashTable     GHashTable;
+
+typedef gboolean       (*GHRFunc)              (gpointer       key,
+                                                gpointer       value,
+                                                gpointer       user_data);
+
+/* Hash tables
+ */
+GHashTable* g_hash_table_new           (GHashFunc       hash_func,
+                                        GCompareFunc    key_compare_func);
+void       g_hash_table_destroy        (GHashTable     *hash_table);
+void       g_hash_table_insert         (GHashTable     *hash_table,
+                                        gpointer        key,
+                                        gpointer        value);
+void       g_hash_table_remove         (GHashTable     *hash_table,
+                                        gconstpointer   key);
+gpointer    g_hash_table_lookup                (GHashTable     *hash_table,
+                                        gconstpointer   key);
+gboolean    g_hash_table_lookup_extended(GHashTable    *hash_table,
+                                        gconstpointer   lookup_key,
+                                        gpointer       *orig_key,
+                                        gpointer       *value);
+void       g_hash_table_foreach        (GHashTable     *hash_table,
+                                        GHFunc          func,
+                                        gpointer        user_data);
+guint      g_hash_table_foreach_remove (GHashTable     *hash_table,
+                                        GHRFunc         func,
+                                        gpointer        user_data);
+guint      g_hash_table_size           (GHashTable     *hash_table);
+
+/* The following two functions are deprecated and will be removed in
+ * the next major release. They do no good. */
+void       g_hash_table_freeze         (GHashTable     *hash_table);
+void       g_hash_table_thaw           (GHashTable     *hash_table);
+
+/* Hash Functions
+ */
+gboolean g_str_equal (gconstpointer   v,
+                      gconstpointer   v2);
+guint    g_str_hash  (gconstpointer   v);
+
+gint     g_int_equal (gconstpointer   v,
+                      gconstpointer   v2) G_GNUC_CONST;
+guint    g_int_hash  (gconstpointer   v) G_GNUC_CONST;
+
+/* This "hash" function will just return the key's adress as an
+ * unsigned integer. Useful for hashing on plain adresses or
+ * simple integer values.
+ * passing NULL into g_hash_table_new() as GHashFunc has the
+ * same effect as passing g_direct_hash().
+ */
+guint g_direct_hash  (gconstpointer v) G_GNUC_CONST;
+gint  g_direct_equal (gconstpointer v,
+                      gconstpointer v2) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_HASH_H__ */
+
diff --git a/glib/ghook.h b/glib/ghook.h
new file mode 100644 (file)
index 0000000..fe350e1
--- /dev/null
@@ -0,0 +1,175 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_HOOK_H__
+#define __G_HOOK_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GHook          GHook;
+typedef struct _GHookList      GHookList;
+
+typedef gint           (*GHookCompareFunc)     (GHook          *new_hook,
+                                                GHook          *sibling);
+typedef gboolean       (*GHookFindFunc)        (GHook          *hook,
+                                                gpointer        data);
+typedef void           (*GHookMarshaller)      (GHook          *hook,
+                                                gpointer        data);
+typedef gboolean       (*GHookCheckMarshaller) (GHook          *hook,
+                                                gpointer        data);
+typedef void           (*GHookFunc)            (gpointer        data);
+typedef gboolean       (*GHookCheckFunc)       (gpointer        data);
+typedef void           (*GHookFreeFunc)        (GHookList      *hook_list,
+                                                GHook          *hook);
+
+/* Callback maintenance functions
+ */
+#define G_HOOK_FLAG_USER_SHIFT (4)
+typedef enum
+{
+  G_HOOK_FLAG_ACTIVE   = 1 << 0,
+  G_HOOK_FLAG_IN_CALL  = 1 << 1,
+  G_HOOK_FLAG_MASK     = 0x0f
+} GHookFlagMask;
+
+#define        G_HOOK_DEFERRED_DESTROY ((GHookFreeFunc) 0x01)
+
+struct _GHookList
+{
+  guint                 seq_id;
+  guint                 hook_size;
+  guint                 is_setup : 1;
+  GHook                *hooks;
+  GMemChunk    *hook_memchunk;
+  GHookFreeFunc         hook_free; /* virtual function */
+  GHookFreeFunc         hook_destroy; /* virtual function */
+};
+
+struct _GHook
+{
+  gpointer      data;
+  GHook                *next;
+  GHook                *prev;
+  guint                 ref_count;
+  guint                 hook_id;
+  guint                 flags;
+  gpointer      func;
+  GDestroyNotify destroy;
+};
+
+#define        G_HOOK_ACTIVE(hook)             ((((GHook*) hook)->flags & \
+                                         G_HOOK_FLAG_ACTIVE) != 0)
+#define        G_HOOK_IN_CALL(hook)            ((((GHook*) hook)->flags & \
+                                         G_HOOK_FLAG_IN_CALL) != 0)
+#define G_HOOK_IS_VALID(hook)          (((GHook*) hook)->hook_id != 0 && \
+                                        G_HOOK_ACTIVE (hook))
+#define G_HOOK_IS_UNLINKED(hook)       (((GHook*) hook)->next == NULL && \
+                                        ((GHook*) hook)->prev == NULL && \
+                                        ((GHook*) hook)->hook_id == 0 && \
+                                        ((GHook*) hook)->ref_count == 0)
+
+void    g_hook_list_init               (GHookList              *hook_list,
+                                        guint                   hook_size);
+void    g_hook_list_clear              (GHookList              *hook_list);
+GHook*  g_hook_alloc                   (GHookList              *hook_list);
+void    g_hook_free                    (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_ref                     (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_unref                   (GHookList              *hook_list,
+                                        GHook                  *hook);
+gboolean g_hook_destroy                        (GHookList              *hook_list,
+                                        guint                   hook_id);
+void    g_hook_destroy_link            (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_prepend                 (GHookList              *hook_list,
+                                        GHook                  *hook);
+void    g_hook_insert_before           (GHookList              *hook_list,
+                                        GHook                  *sibling,
+                                        GHook                  *hook);
+void    g_hook_insert_sorted           (GHookList              *hook_list,
+                                        GHook                  *hook,
+                                        GHookCompareFunc        func);
+GHook*  g_hook_get                     (GHookList              *hook_list,
+                                        guint                   hook_id);
+GHook*  g_hook_find                    (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        GHookFindFunc           func,
+                                        gpointer                data);
+GHook*  g_hook_find_data               (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                data);
+GHook*  g_hook_find_func               (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                func);
+GHook*  g_hook_find_func_data          (GHookList              *hook_list,
+                                        gboolean                need_valids,
+                                        gpointer                func,
+                                        gpointer                data);
+/* return the first valid hook, and increment its reference count */
+GHook*  g_hook_first_valid             (GHookList              *hook_list,
+                                        gboolean                may_be_in_call);
+/* return the next valid hook with incremented reference count, and
+ * decrement the reference count of the original hook
+ */
+GHook*  g_hook_next_valid              (GHookList              *hook_list,
+                                        GHook                  *hook,
+                                        gboolean                may_be_in_call);
+
+/* GHookCompareFunc implementation to insert hooks sorted by their id */
+gint    g_hook_compare_ids             (GHook                  *new_hook,
+                                        GHook                  *sibling);
+
+/* convenience macros */
+#define         g_hook_append( hook_list, hook )  \
+     g_hook_insert_before ((hook_list), NULL, (hook))
+
+/* invoke all valid hooks with the (*GHookFunc) signature.
+ */
+void    g_hook_list_invoke             (GHookList              *hook_list,
+                                        gboolean                may_recurse);
+/* invoke all valid hooks with the (*GHookCheckFunc) signature,
+ * and destroy the hook if FALSE is returned.
+ */
+void    g_hook_list_invoke_check       (GHookList              *hook_list,
+                                        gboolean                may_recurse);
+/* invoke a marshaller on all valid hooks.
+ */
+void    g_hook_list_marshal            (GHookList              *hook_list,
+                                        gboolean                may_recurse,
+                                        GHookMarshaller         marshaller,
+                                        gpointer                data);
+void    g_hook_list_marshal_check      (GHookList              *hook_list,
+                                        gboolean                may_recurse,
+                                        GHookCheckMarshaller    marshaller,
+                                        gpointer                data);
+
+G_END_DECLS
+
+#endif /* __G_HOOK_H__ */
+
diff --git a/glib/giochannel.h b/glib/giochannel.h
new file mode 100644 (file)
index 0000000..b2ae71e
--- /dev/null
@@ -0,0 +1,267 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_IOCHANNEL_H__
+#define __G_IOCHANNEL_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* GIOChannel
+ */
+
+typedef struct _GIOChannel     GIOChannel;
+typedef struct _GIOFuncs        GIOFuncs;
+typedef enum
+{
+  G_IO_ERROR_NONE,
+  G_IO_ERROR_AGAIN,
+  G_IO_ERROR_INVAL,
+  G_IO_ERROR_UNKNOWN
+} GIOError;
+typedef enum
+{
+  G_SEEK_CUR,
+  G_SEEK_SET,
+  G_SEEK_END
+} GSeekType;
+typedef enum
+{
+  G_IO_IN      GLIB_SYSDEF_POLLIN,
+  G_IO_OUT     GLIB_SYSDEF_POLLOUT,
+  G_IO_PRI     GLIB_SYSDEF_POLLPRI,
+  G_IO_ERR     GLIB_SYSDEF_POLLERR,
+  G_IO_HUP     GLIB_SYSDEF_POLLHUP,
+  G_IO_NVAL    GLIB_SYSDEF_POLLNVAL
+} GIOCondition;
+
+struct _GIOChannel
+{
+  guint channel_flags;
+  guint ref_count;
+  GIOFuncs *funcs;
+};
+
+typedef gboolean (*GIOFunc) (GIOChannel   *source,
+                            GIOCondition  condition,
+                            gpointer      data);
+struct _GIOFuncs
+{
+  GIOError (*io_read)   (GIOChannel    *channel, 
+                        gchar          *buf, 
+                        guint           count,
+                        guint          *bytes_read);
+  GIOError (*io_write)  (GIOChannel    *channel, 
+                        gchar          *buf, 
+                        guint           count,
+                        guint          *bytes_written);
+  GIOError (*io_seek)   (GIOChannel    *channel, 
+                        gint            offset, 
+                        GSeekType       type);
+  void (*io_close)      (GIOChannel    *channel);
+  guint (*io_add_watch) (GIOChannel     *channel,
+                        gint            priority,
+                        GIOCondition    condition,
+                        GIOFunc         func,
+                        gpointer        user_data,
+                        GDestroyNotify  notify);
+  void (*io_free)       (GIOChannel    *channel);
+};
+
+void        g_io_channel_init   (GIOChannel    *channel);
+void        g_io_channel_ref    (GIOChannel    *channel);
+void        g_io_channel_unref  (GIOChannel    *channel);
+GIOError    g_io_channel_read   (GIOChannel    *channel, 
+                                gchar         *buf, 
+                                guint          count,
+                                guint         *bytes_read);
+GIOError  g_io_channel_write    (GIOChannel    *channel, 
+                                gchar         *buf, 
+                                guint          count,
+                                guint         *bytes_written);
+GIOError  g_io_channel_seek     (GIOChannel    *channel,
+                                gint           offset, 
+                                GSeekType      type);
+void      g_io_channel_close    (GIOChannel    *channel);
+guint     g_io_add_watch_full   (GIOChannel    *channel,
+                                gint           priority,
+                                GIOCondition   condition,
+                                GIOFunc        func,
+                                gpointer       user_data,
+                                GDestroyNotify notify);
+guint    g_io_add_watch         (GIOChannel    *channel,
+                                GIOCondition   condition,
+                                GIOFunc        func,
+                                gpointer       user_data);
+
+/* On Unix, IO channels created with this function for any file
+ * descriptor or socket.
+ *
+ * On Win32, use this only for files opened with the MSVCRT (the
+ * Microsoft run-time C library) _open() or _pipe, including file
+ * descriptors 0, 1 and 2 (corresponding to stdin, stdout and stderr).
+ *
+ * The term file descriptor as used in the context of Win32 refers to
+ * the emulated Unix-like file descriptors MSVCRT provides. The native
+ * corresponding concept is file HANDLE. There isn't as of yet a way to
+ * get GIOChannels for file HANDLEs.
+ */
+GIOChannel* g_io_channel_unix_new    (int         fd);
+gint        g_io_channel_unix_get_fd (GIOChannel *channel);
+
+#ifdef G_OS_WIN32
+
+#define G_WIN32_MSG_HANDLE 19981206
+
+/* Use this to get a GPollFD from a GIOChannel, so that you can call
+ * g_io_channel_win32_poll(). After calling this you should only use
+ * g_io_channel_read() to read from the GIOChannel, i.e. never read()
+ * or recv() from the underlying file descriptor or SOCKET.
+ */
+void        g_io_channel_win32_make_pollfd (GIOChannel   *channel,
+                                           GIOCondition  condition,
+                                           GPollFD      *fd);
+
+/* This can be used to wait a until at least one of the channels is readable.
+ * On Unix you would do a select() on the file descriptors of the channels.
+ * This should probably be available for all platforms?
+ */
+gint        g_io_channel_win32_poll   (GPollFD    *fds,
+                                      gint        n_fds,
+                                      gint        timeout);
+
+/* This is used to add polling for Windows messages. GDK (GTk+) programs
+ * should *not* use this.
+ */
+void        g_main_poll_win32_msg_add (gint        priority,
+                                      GPollFD    *fd,
+                                      guint       hwnd);
+
+/* An IO channel for Windows messages for window handle hwnd. */
+GIOChannel *g_io_channel_win32_new_messages (guint hwnd);
+
+/* An IO channel for C runtime (emulated Unix-like) file
+ * descriptors. Identical to g_io_channel_unix_new above.
+ * After calling g_io_add_watch() on a IO channel returned
+ * by this function, you shouldn't call read() on the file
+ * descriptor.
+ */
+GIOChannel* g_io_channel_win32_new_fd (int         fd);
+
+/* Get the C runtime file descriptor of a channel. */
+gint        g_io_channel_win32_get_fd (GIOChannel *channel);
+
+/* An IO channel for a SOCK_STREAM winsock socket. The parameter
+ * should be a SOCKET. After calling g_io_add_watch() on a IO channel
+ * returned by this function, you shouldn't call recv() on the SOCKET.
+ */
+GIOChannel *g_io_channel_win32_new_stream_socket (int socket);
+
+#endif
+
+/* Windows emulation stubs for common Unix functions
+ */
+#ifdef G_OS_WIN32
+#  define MAXPATHLEN 1024
+
+#ifdef _MSC_VER
+typedef int pid_t;
+#endif
+
+/*
+ * To get prototypes for the following POSIXish functions, you have to
+ * include the indicated non-POSIX headers. The functions are defined
+ * in OLDNAMES.LIB (MSVC) or -lmoldname-msvc (mingw32).
+ *
+ * getcwd: <direct.h> (MSVC), <io.h> (mingw32)
+ * getpid: <process.h>
+ * access: <io.h>
+ * unlink: <stdio.h> or <io.h>
+ * open, read, write, lseek, close: <io.h>
+ * rmdir: <direct.h>
+ * pipe: <direct.h>
+ */
+
+/* pipe is not in OLDNAMES.LIB or -lmoldname-msvc. */
+#define pipe(phandles) _pipe (phandles, 4096, _O_BINARY)
+
+/* For some POSIX functions that are not provided by the MS runtime,
+ * we provide emulators in glib, which are prefixed with g_win32_.
+ */
+#    define ftruncate(fd, size)        g_win32_ftruncate (fd, size)
+
+/* -lmingw32 also has emulations for these, but we need our own
+ * for MSVC anyhow, so we might aswell use them always.
+ */
+#    define opendir            g_win32_opendir
+#    define readdir            g_win32_readdir
+#    define rewinddir          g_win32_rewinddir
+#    define closedir           g_win32_closedir
+#    define NAME_MAX 255
+
+struct dirent
+{
+  gchar  d_name[NAME_MAX + 1];
+};
+
+struct DIR
+{
+  gchar        *dir_name;
+  gboolean     just_opened;
+  guint        find_file_handle;
+  gpointer     find_file_data;
+  struct dirent readdir_result;
+};
+typedef struct DIR DIR;
+
+/* emulation functions */
+extern int     g_win32_ftruncate       (gint            f,
+                                        guint           size);
+DIR*           g_win32_opendir         (const gchar    *dirname);
+struct dirent* g_win32_readdir         (DIR            *dir);
+void           g_win32_rewinddir       (DIR            *dir);
+gint           g_win32_closedir        (DIR            *dir);
+
+/* The MS setlocale uses locale names of the form "English_United
+ * States.1252" etc. We want the Unixish standard form "en", "zh_TW"
+ * etc. This function gets the current thread locale from Windows and
+ * returns it as a string of the above form for use in forming file
+ * names etc. The returned string should be deallocated with g_free().
+ */
+gchar *                g_win32_getlocale  (void);
+
+/* Translate a Win32 error code (as returned by GetLastError()) into
+ * the corresponding message. The returned string should be deallocated
+ * with g_free().
+ */
+gchar *         g_win32_error_message (gint error);
+
+#endif  /* G_OS_WIN32 */
+
+G_END_DECLS
+
+#endif /* __G_IOCHANNEL_H__ */
index d6d53ae..25ea828 100644 (file)
 #ifndef __G_LIB_H__
 #define __G_LIB_H__
 
-/* Here we provide G_GNUC_EXTENSION as an alias for __extension__,
- * where this is valid. This allows for warningless compilation of
- * "long long" types even in the presence of '-ansi -pedantic'. This
- * of course should be with the other GCC-isms below, but then
- * glibconfig.h wouldn't load cleanly and it is better to have that
- * here, than in glibconfig.h.  
- */
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8)
-#  define G_GNUC_EXTENSION __extension__
-#else
-#  define G_GNUC_EXTENSION
-#endif
-
-/* system specific config file glibconfig.h provides definitions for
- * the extrema of many of the standard types. These are:
- *
- *  G_MINSHORT, G_MAXSHORT
- *  G_MININT, G_MAXINT
- *  G_MINLONG, G_MAXLONG
- *  G_MINFLOAT, G_MAXFLOAT
- *  G_MINDOUBLE, G_MAXDOUBLE
- *
- * It also provides the following typedefs:
- *
- *  gint8, guint8
- *  gint16, guint16
- *  gint32, guint32
- *  gint64, guint64
- *  gssize, gsize
- *
- * It defines the G_BYTE_ORDER symbol to one of G_*_ENDIAN (see later in
- * this file). 
- *
- * And it provides a way to store and retrieve a `gint' in/from a `gpointer'.
- * This is useful to pass an integer instead of a pointer to a callback.
- *
- *  GINT_TO_POINTER (i), GUINT_TO_POINTER (i)
- *  GPOINTER_TO_INT (p), GPOINTER_TO_UINT (p)
- *
- * Finally, it provides the following wrappers to STDC functions:
- *
- *  void g_memmove (gpointer dest, gconstpointer void *src, gulong count);
- *    A wrapper for STDC memmove, or an implementation, if memmove doesn't
- *    exist.  The prototype looks like the above, give or take a const,
- *    or size_t.
- */
-#include <glibconfig.h>
-
-/* Define some mathematical constants that aren't available
- * symbolically in some strict ISO C implementations.
- */
-#define G_E     2.7182818284590452354E0
-#define G_LN2   6.9314718055994530942E-1
-#define G_LN10  2.3025850929940456840E0
-#define G_PI    3.14159265358979323846E0
-#define G_PI_2  1.57079632679489661923E0
-#define G_PI_4  0.78539816339744830962E0
-#define G_SQRT2 1.4142135623730950488E0
-
-/* include varargs functions for assertment macros
- */
-#include <stdarg.h>
-
-/* optionally feature DMALLOC memory allocation debugger
- */
-#ifdef USE_DMALLOC
-#include "dmalloc.h"
-#endif
-
-
-#ifdef G_OS_WIN32
-
-/* On native Win32, directory separator is the backslash, and search path
- * separator is the semicolon.
- */
-#define G_DIR_SEPARATOR '\\'
-#define G_DIR_SEPARATOR_S "\\"
-#define G_SEARCHPATH_SEPARATOR ';'
-#define G_SEARCHPATH_SEPARATOR_S ";"
-
-#else  /* !G_OS_WIN32 */
-
-/* Unix */
-
-#define G_DIR_SEPARATOR '/'
-#define G_DIR_SEPARATOR_S "/"
-#define G_SEARCHPATH_SEPARATOR ':'
-#define G_SEARCHPATH_SEPARATOR_S ":"
-
-#endif /* !G_OS_WIN32 */
-
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
-
-/* Provide definitions for some commonly used macros.
- *  Some of them are only provided if they haven't already
- *  been defined. It is assumed that if they are already
- *  defined then the current definition is correct.
- */
-#ifndef NULL
-#  ifdef __cplusplus
-#    define NULL        (0L)
-#  else /* !__cplusplus */
-#    define NULL        ((void*) 0)
-#  endif /* !__cplusplus */
-#endif
-
-#ifndef        FALSE
-#define        FALSE   (0)
-#endif
-
-#ifndef        TRUE
-#define        TRUE    (!FALSE)
-#endif
-
-#undef MAX
-#define MAX(a, b)  (((a) > (b)) ? (a) : (b))
-
-#undef MIN
-#define MIN(a, b)  (((a) < (b)) ? (a) : (b))
-
-#undef ABS
-#define ABS(a)    (((a) < 0) ? -(a) : (a))
-
-#undef CLAMP
-#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
-
-#define G_STRINGIFY(macro_or_string)   G_STRINGIFY_ARG (macro_or_string)
-#define        G_STRINGIFY_ARG(contents)       #contents
-
-/* provide a string identifying the current code position */
-#ifdef  __GNUC__
-#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()"
-#else
-#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__)
-#endif
-
-
-/* Count the number of elements in an array. The array must be defined
- * as such; using this with a dynamically allocated array will give
- * incorrect results.
- */
-#define G_N_ELEMENTS(arr)              (sizeof (arr) / sizeof ((arr)[0]))
-
-/* Define G_VA_COPY() to do the right thing for copying va_list variables.
- * glibconfig.h may have already defined G_VA_COPY as va_copy or __va_copy.
- */
-#if !defined (G_VA_COPY)
-#  if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
-#    define G_VA_COPY(ap1, ap2)          (*(ap1) = *(ap2))
-#  elif defined (G_VA_COPY_AS_ARRAY)
-#    define G_VA_COPY(ap1, ap2)          g_memmove ((ap1), (ap2), sizeof (va_list))
-#  else /* va_list is a pointer */
-#    define G_VA_COPY(ap1, ap2)          ((ap1) = (ap2))
-#  endif /* va_list is a pointer */
-#endif /* !G_VA_COPY */
-
-
-/* Provide convenience macros for handling structure
- * fields through their offsets.
- */
-#define G_STRUCT_OFFSET(struct_type, member)   \
-    ((glong) ((guint8*) &((struct_type*) 0)->member))
-#define G_STRUCT_MEMBER_P(struct_p, struct_offset)   \
-    ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset)))
-#define G_STRUCT_MEMBER(member_type, struct_p, struct_offset)   \
-    (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset)))
-
-
-/* inlining hassle. for compilers that don't allow the `inline' keyword,
- * mostly because of strict ANSI C compliance or dumbness, we try to fall
- * back to either `__inline__' or `__inline'.
- * we define G_CAN_INLINE, if the compiler seems to be actually
- * *capable* to do function inlining, in which case inline function bodys
- * do make sense. we also define G_INLINE_FUNC to properly export the
- * function prototypes if no inlining can be performed.
- * inline function bodies have to be special cased with G_CAN_INLINE and a
- * .c file specific macro to allow one compiled instance with extern linkage
- * of the functions by defining G_IMPLEMENT_INLINES and the .c file macro.
- */
-#ifdef G_IMPLEMENT_INLINES
-#  define G_INLINE_FUNC extern
-#  undef  G_CAN_INLINE
-#endif
-#ifndef G_INLINE_FUNC
-#  define G_CAN_INLINE 1
-#endif
-#if defined (G_HAVE_INLINE) && defined (__GNUC__) && defined (__STRICT_ANSI__)
-#  undef inline
-#  define inline __inline__
-#elif !defined (G_HAVE_INLINE)
-#  undef inline
-#  if defined (G_HAVE___INLINE__)
-#    define inline __inline__
-#  elif defined (G_HAVE___INLINE)
-#    define inline __inline
-#  else /* !inline && !__inline__ && !__inline */
-#    define inline  /* don't inline, then */
-#    ifndef G_INLINE_FUNC
-#      undef G_CAN_INLINE
-#    endif
-#  endif
-#endif
-#ifndef G_INLINE_FUNC
-#  if defined (__GNUC__) && (__OPTIMIZE__)
-#    define G_INLINE_FUNC extern inline
-#  elif defined (G_CAN_INLINE) && !defined (__GNUC__)
-#    define G_INLINE_FUNC static inline
-#  else /* can't inline */
-#    define G_INLINE_FUNC extern
-#    undef G_CAN_INLINE
-#  endif
-#endif /* !G_INLINE_FUNC */
-
-
-/* Provide simple macro statement wrappers (adapted from Perl):
- *  G_STMT_START { statements; } G_STMT_END;
- *  can be used as a single statement, as in
- *  if (x) G_STMT_START { ... } G_STMT_END; else ...
- *
- *  For gcc we will wrap the statements within `({' and `})' braces.
- *  For SunOS they will be wrapped within `if (1)' and `else (void) 0',
- *  and otherwise within `do' and `while (0)'.
- */
-#if !(defined (G_STMT_START) && defined (G_STMT_END))
-#  if defined (__GNUC__) && !defined (__STRICT_ANSI__) && !defined (__cplusplus)
-#    define G_STMT_START       (void)(
-#    define G_STMT_END         )
-#  else
-#    if (defined (sun) || defined (__sun__))
-#      define G_STMT_START     if (1)
-#      define G_STMT_END       else (void)0
-#    else
-#      define G_STMT_START     do
-#      define G_STMT_END       while (0)
-#    endif
-#  endif
-#endif
-
-
-/* Provide macros to feature the GCC function attribute.
- */
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-#define G_GNUC_PURE                            \
-  __attribute__((pure))
-#else
-#define G_GNUC_PURE
-#endif
-
-#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
-#define G_GNUC_PRINTF( format_idx, arg_idx )   \
-  __attribute__((format (printf, format_idx, arg_idx)))
-#define G_GNUC_SCANF( format_idx, arg_idx )    \
-  __attribute__((format (scanf, format_idx, arg_idx)))
-#define G_GNUC_FORMAT( arg_idx )               \
-  __attribute__((format_arg (arg_idx)))
-#define G_GNUC_NORETURN                                \
-  __attribute__((noreturn))
-#define G_GNUC_CONST                           \
-  __attribute__((const))
-#define G_GNUC_UNUSED                          \
-  __attribute__((unused))
-#else  /* !__GNUC__ */
-#define G_GNUC_PRINTF( format_idx, arg_idx )
-#define G_GNUC_SCANF( format_idx, arg_idx )
-#define G_GNUC_FORMAT( arg_idx )
-#define G_GNUC_NORETURN
-#define G_GNUC_CONST
-#define        G_GNUC_UNUSED
-#endif /* !__GNUC__ */
-
-/* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with
- * macros, so we can refer to them as strings unconditionally.
- */
-#ifdef __GNUC__
-#define        G_GNUC_FUNCTION         __FUNCTION__
-#define        G_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__
-#else  /* !__GNUC__ */
-#define        G_GNUC_FUNCTION         ""
-#define        G_GNUC_PRETTY_FUNCTION  ""
-#endif /* !__GNUC__ */
-
-/* we try to provide a usefull equivalent for ATEXIT if it is
- * not defined, but use is actually abandoned. people should
- * use g_atexit() instead.
- */
-#ifndef ATEXIT
-# define ATEXIT(proc)  g_ATEXIT(proc)
-#else
-# define G_NATIVE_ATEXIT
-#endif /* ATEXIT */
-
-/* Hacker macro to place breakpoints for elected machines.
- * Actual use is strongly deprecated of course ;)
- */
-#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("int $03"); }G_STMT_END
-#elif defined (__alpha__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define G_BREAKPOINT()       G_STMT_START{ __asm__ __volatile__ ("bpt"); }G_STMT_END
-#else  /* !__i386__ && !__alpha__ */
-#  define G_BREAKPOINT()       G_STMT_START{ raise (5 /* SIGTRAP */); }G_STMT_END
-#endif /* __i386__ */
-
-/* g_alloca handling */
-#ifdef  __GNUC__
-/* GCC does the right thing */
-# undef alloca
-# define alloca(size)   __builtin_alloca (size)
-#elif defined (GLIB_HAVE_ALLOCA_H)
-/* a native and working alloca.h is there */ 
-# include <alloca.h>
-#else /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
-# ifdef _MSC_VER
-#  include <malloc.h>
-#  define alloca _alloca
-# else /* !_MSC_VER */
-#  ifdef _AIX
- #pragma alloca
-#  else /* !_AIX */
-#   ifndef alloca /* predefined by HP cc +Olibcalls */
-char *alloca ();
-#   endif /* !alloca */
-#  endif /* !_AIX */
-# endif /* !_MSC_VER */
-#endif /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */
-
-#define g_alloca(size) alloca (size)
-/* End g_alloca handling */
-
-/* Provide macros for easily allocating memory. The macros
- *  will cast the allocated memory to the specified type
- *  in order to avoid compiler warnings. (Makes the code neater).
- */
-
-#ifdef __DMALLOC_H__
-#  define g_new(type, count)           (ALLOC (type, count))
-#  define g_new0(type, count)          (CALLOC (type, count))
-#  define g_renew(type, mem, count)    (REALLOC (mem, type, count))
-#else /* __DMALLOC_H__ */
-#  define g_new(type, count)     \
-      ((type *) g_malloc ((unsigned) sizeof (type) * (count)))
-#  define g_new0(type, count)    \
-      ((type *) g_malloc0 ((unsigned) sizeof (type) * (count)))
-#  define g_renew(type, mem, count)      \
-      ((type *) g_realloc (mem, (unsigned) sizeof (type) * (count)))
-#endif /* __DMALLOC_H__ */
-
-#define g_mem_chunk_create(type, pre_alloc, alloc_type)        ( \
-  g_mem_chunk_new (#type " mem chunks (" #pre_alloc ")", \
-                  sizeof (type), \
-                  sizeof (type) * (pre_alloc), \
-                  (alloc_type)) \
-)
-#define g_chunk_new(type, chunk)       ( \
-  (type *) g_mem_chunk_alloc (chunk) \
-)
-#define g_chunk_new0(type, chunk)      ( \
-  (type *) g_mem_chunk_alloc0 (chunk) \
-)
-#define g_chunk_free(mem, mem_chunk)   G_STMT_START { \
-  g_mem_chunk_free ((mem_chunk), (mem)); \
-} G_STMT_END
-
-
-/* Provide macros for error handling. The "assert" macros will
- *  exit on failure. The "return" macros will exit the current
- *  function. Two different definitions are given for the macros
- *  if G_DISABLE_ASSERT is not defined, in order to support gcc's
- *  __PRETTY_FUNCTION__ capability.
- */
-
-#ifdef G_DISABLE_ASSERT
-
-#define g_assert(expr)
-#define g_assert_not_reached()
-
-#else /* !G_DISABLE_ASSERT */
-
-#ifdef __GNUC__
-
-#define g_assert(expr)                 G_STMT_START{           \
-     if (!(expr))                                              \
-       g_log (G_LOG_DOMAIN,                                    \
-             G_LOG_LEVEL_ERROR,                                \
-             "file %s: line %d (%s): assertion failed: (%s)",  \
-             __FILE__,                                         \
-             __LINE__,                                         \
-             __PRETTY_FUNCTION__,                              \
-             #expr);                   }G_STMT_END
-
-#define g_assert_not_reached()         G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_ERROR,                                  \
-           "file %s: line %d (%s): should not be reached",     \
-           __FILE__,                                           \
-           __LINE__,                                           \
-           __PRETTY_FUNCTION__);       }G_STMT_END
-
-#else /* !__GNUC__ */
-
-#define g_assert(expr)                 G_STMT_START{           \
-     if (!(expr))                                              \
-       g_log (G_LOG_DOMAIN,                                    \
-             G_LOG_LEVEL_ERROR,                                \
-             "file %s: line %d: assertion failed: (%s)",       \
-             __FILE__,                                         \
-             __LINE__,                                         \
-             #expr);                   }G_STMT_END
-
-#define g_assert_not_reached()         G_STMT_START{   \
-     g_log (G_LOG_DOMAIN,                              \
-           G_LOG_LEVEL_ERROR,                          \
-           "file %s: line %d: should not be reached",  \
-           __FILE__,                                   \
-           __LINE__);          }G_STMT_END
-
-#endif /* __GNUC__ */
-
-#endif /* !G_DISABLE_ASSERT */
-
-
-#ifdef G_DISABLE_CHECKS
-
-#define g_return_if_fail(expr)
-#define g_return_val_if_fail(expr,val)
-#define g_return_if_reached() return
-#define g_return_val_if_reached(val) return (val)
-
-#else /* !G_DISABLE_CHECKS */
-
-#ifdef __GNUC__
-
-#define g_return_if_fail(expr)         G_STMT_START{                   \
-     if (!(expr))                                                      \
-       {                                                               \
-        g_log (G_LOG_DOMAIN,                                           \
-               G_LOG_LEVEL_CRITICAL,                                   \
-               "file %s: line %d (%s): assertion `%s' failed",         \
-               __FILE__,                                               \
-               __LINE__,                                               \
-               __PRETTY_FUNCTION__,                                    \
-               #expr);                                                 \
-        return;                                                        \
-       };                              }G_STMT_END
-
-#define g_return_val_if_fail(expr,val) G_STMT_START{                   \
-     if (!(expr))                                                      \
-       {                                                               \
-        g_log (G_LOG_DOMAIN,                                           \
-               G_LOG_LEVEL_CRITICAL,                                   \
-               "file %s: line %d (%s): assertion `%s' failed",         \
-               __FILE__,                                               \
-               __LINE__,                                               \
-               __PRETTY_FUNCTION__,                                    \
-               #expr);                                                 \
-        return (val);                                                  \
-       };                              }G_STMT_END
-
-#define g_return_if_reached()          G_STMT_START{                   \
-     g_log (G_LOG_DOMAIN,                                              \
-           G_LOG_LEVEL_CRITICAL,                                       \
-           "file %s: line %d (%s): should not be reached",             \
-           __FILE__,                                                   \
-           __LINE__,                                                   \
-           __PRETTY_FUNCTION__);                                       \
-     return;                           }G_STMT_END
-
-#define g_return_val_if_reached(val)   G_STMT_START{                   \
-     g_log (G_LOG_DOMAIN,                                              \
-           G_LOG_LEVEL_CRITICAL,                                       \
-           "file %s: line %d (%s): should not be reached",             \
-           __FILE__,                                                   \
-           __LINE__,                                                   \
-           __PRETTY_FUNCTION__);                                       \
-     return (val);                     }G_STMT_END
-
-#else /* !__GNUC__ */
-
-#define g_return_if_fail(expr)         G_STMT_START{           \
-     if (!(expr))                                              \
-       {                                                       \
-        g_log (G_LOG_DOMAIN,                                   \
-               G_LOG_LEVEL_CRITICAL,                           \
-               "file %s: line %d: assertion `%s' failed",      \
-               __FILE__,                                       \
-               __LINE__,                                       \
-               #expr);                                         \
-        return;                                                \
-       };                              }G_STMT_END
-
-#define g_return_val_if_fail(expr, val)        G_STMT_START{           \
-     if (!(expr))                                              \
-       {                                                       \
-        g_log (G_LOG_DOMAIN,                                   \
-               G_LOG_LEVEL_CRITICAL,                           \
-               "file %s: line %d: assertion `%s' failed",      \
-               __FILE__,                                       \
-               __LINE__,                                       \
-               #expr);                                         \
-        return (val);                                          \
-       };                              }G_STMT_END
-
-#define g_return_if_reached()          G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_CRITICAL,                               \
-           "file %s: line %d: should not be reached",          \
-           __FILE__,                                           \
-           __LINE__);                                          \
-     return;                           }G_STMT_END
-
-#define g_return_val_if_reached(val)   G_STMT_START{           \
-     g_log (G_LOG_DOMAIN,                                      \
-           G_LOG_LEVEL_CRITICAL,                               \
-           "file %s: line %d: should not be reached",          \
-           __FILE__,                                           \
-           __LINE__);                                          \
-     return (val);                     }G_STMT_END
-
-#endif /* !__GNUC__ */
-
-#endif /* !G_DISABLE_CHECKS */
-
-
-/* Provide type definitions for commonly used types.
- *  These are useful because a "gint8" can be adjusted
- *  to be 1 byte (8 bits) on all platforms. Similarly and
- *  more importantly, "gint32" can be adjusted to be
- *  4 bytes (32 bits) on all platforms.
- */
-
-typedef char   gchar;
-typedef short  gshort;
-typedef long   glong;
-typedef int    gint;
-typedef gint   gboolean;
-typedef gchar* gstring;
-
-typedef unsigned char  guchar;
-typedef unsigned short gushort;
-typedef unsigned long  gulong;
-typedef unsigned int   guint;
-
-typedef float  gfloat;
-typedef double gdouble;
-
-/* HAVE_LONG_DOUBLE doesn't work correctly on all platforms.
- * Since gldouble isn't used anywhere, just disable it for now */
-
-#if 0
-#ifdef HAVE_LONG_DOUBLE
-typedef long double gldouble;
-#else /* HAVE_LONG_DOUBLE */
-typedef double gldouble;
-#endif /* HAVE_LONG_DOUBLE */
-#endif /* 0 */
-
-typedef void* gpointer;
-typedef const void *gconstpointer;
-
-
-typedef guint32 GQuark;
-typedef gint32 GTime;
-
-
-/* Portable endian checks and conversions
- *
- * glibconfig.h defines G_BYTE_ORDER which expands to one of
- * the below macros.
- */
-#define G_LITTLE_ENDIAN 1234
-#define G_BIG_ENDIAN    4321
-#define G_PDP_ENDIAN    3412           /* unused, need specific PDP check */   
-
-
-/* Basic bit swapping functions
- */
-#define GUINT16_SWAP_LE_BE_CONSTANT(val)       ((guint16) ( \
-    (((guint16) (val) & (guint16) 0x00ffU) << 8) | \
-    (((guint16) (val) & (guint16) 0xff00U) >> 8)))
-#define GUINT32_SWAP_LE_BE_CONSTANT(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x000000ffU) << 24) | \
-    (((guint32) (val) & (guint32) 0x0000ff00U) <<  8) | \
-    (((guint32) (val) & (guint32) 0x00ff0000U) >>  8) | \
-    (((guint32) (val) & (guint32) 0xff000000U) >> 24)))
-
-/* Intel specific stuff for speed
- */
-#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#  define GUINT16_SWAP_LE_BE_X86(val) \
-     (__extension__                                    \
-      ({ register guint16 __v;                         \
-        if (__builtin_constant_p (val))                \
-          __v = GUINT16_SWAP_LE_BE_CONSTANT (val);     \
-        else                                           \
-          __asm__ __const__ ("rorw $8, %w0"            \
-                             : "=r" (__v)              \
-                             : "0" ((guint16) (val))); \
-       __v; }))
-#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_X86 (val))
-#  if !defined(__i486__) && !defined(__i586__) \
-      && !defined(__pentium__) && !defined(__i686__) && !defined(__pentiumpro__)
-#     define GUINT32_SWAP_LE_BE_X86(val) \
-        (__extension__                                         \
-         ({ register guint32 __v;                              \
-           if (__builtin_constant_p (val))                     \
-             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
-         else                                                  \
-           __asm__ __const__ ("rorw $8, %w0\n\t"               \
-                              "rorl $16, %0\n\t"               \
-                              "rorw $8, %w0"                   \
-                              : "=r" (__v)                     \
-                              : "0" ((guint32) (val)));        \
-       __v; }))
-#  else /* 486 and higher has bswap */
-#     define GUINT32_SWAP_LE_BE_X86(val) \
-        (__extension__                                         \
-         ({ register guint32 __v;                              \
-           if (__builtin_constant_p (val))                     \
-             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
-         else                                                  \
-           __asm__ __const__ ("bswap %0"                       \
-                              : "=r" (__v)                     \
-                              : "0" ((guint32) (val)));        \
-       __v; }))
-#  endif /* processor specific 32-bit stuff */
-#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_X86 (val))
-#else /* !__i386__ */
-#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val))
-#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val))
-#endif /* __i386__ */
-
-#ifdef G_HAVE_GINT64
-#  define GUINT64_SWAP_LE_BE_CONSTANT(val)     ((guint64) ( \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00000000000000ffU)) << 56) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x000000000000ff00U)) << 40) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x0000000000ff0000U)) << 24) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00000000ff000000U)) <<  8) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x000000ff00000000U)) >>  8) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x0000ff0000000000U)) >> 24) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0x00ff000000000000U)) >> 40) |      \
-      (((guint64) (val) &                                              \
-       (guint64) G_GINT64_CONSTANT(0xff00000000000000U)) >> 56)))
-#  if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
-#    define GUINT64_SWAP_LE_BE_X86(val) \
-       (__extension__                                          \
-        ({ union { guint64 __ll;                               \
-                   guint32 __l[2]; } __r;                      \
-           if (__builtin_constant_p (val))                     \
-             __r.__ll = GUINT64_SWAP_LE_BE_CONSTANT (val);     \
-           else                                                \
-             {                                                 \
-               union { guint64 __ll;                           \
-                       guint32 __l[2]; } __w;                  \
-               __w.__ll = ((guint64) val);                     \
-               __r.__l[0] = GUINT32_SWAP_LE_BE (__w.__l[1]);   \
-               __r.__l[1] = GUINT32_SWAP_LE_BE (__w.__l[0]);   \
-             }                                                 \
-         __r.__ll; }))
-#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_X86 (val))
-#  else /* !__i386__ */
-#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT(val))
-#  endif
-#endif
-
-#define GUINT16_SWAP_LE_PDP(val)       ((guint16) (val))
-#define GUINT16_SWAP_BE_PDP(val)       (GUINT16_SWAP_LE_BE (val))
-#define GUINT32_SWAP_LE_PDP(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x0000ffffU) << 16) | \
-    (((guint32) (val) & (guint32) 0xffff0000U) >> 16)))
-#define GUINT32_SWAP_BE_PDP(val)       ((guint32) ( \
-    (((guint32) (val) & (guint32) 0x00ff00ffU) << 8) | \
-    (((guint32) (val) & (guint32) 0xff00ff00U) >> 8)))
-
-/* The G*_TO_?E() macros are defined in glibconfig.h.
- * The transformation is symmetric, so the FROM just maps to the TO.
- */
-#define GINT16_FROM_LE(val)    (GINT16_TO_LE (val))
-#define GUINT16_FROM_LE(val)   (GUINT16_TO_LE (val))
-#define GINT16_FROM_BE(val)    (GINT16_TO_BE (val))
-#define GUINT16_FROM_BE(val)   (GUINT16_TO_BE (val))
-#define GINT32_FROM_LE(val)    (GINT32_TO_LE (val))
-#define GUINT32_FROM_LE(val)   (GUINT32_TO_LE (val))
-#define GINT32_FROM_BE(val)    (GINT32_TO_BE (val))
-#define GUINT32_FROM_BE(val)   (GUINT32_TO_BE (val))
-
-#ifdef G_HAVE_GINT64
-#define GINT64_FROM_LE(val)    (GINT64_TO_LE (val))
-#define GUINT64_FROM_LE(val)   (GUINT64_TO_LE (val))
-#define GINT64_FROM_BE(val)    (GINT64_TO_BE (val))
-#define GUINT64_FROM_BE(val)   (GUINT64_TO_BE (val))
-#endif
-
-#define GLONG_FROM_LE(val)     (GLONG_TO_LE (val))
-#define GULONG_FROM_LE(val)    (GULONG_TO_LE (val))
-#define GLONG_FROM_BE(val)     (GLONG_TO_BE (val))
-#define GULONG_FROM_BE(val)    (GULONG_TO_BE (val))
-
-#define GINT_FROM_LE(val)      (GINT_TO_LE (val))
-#define GUINT_FROM_LE(val)     (GUINT_TO_LE (val))
-#define GINT_FROM_BE(val)      (GINT_TO_BE (val))
-#define GUINT_FROM_BE(val)     (GUINT_TO_BE (val))
-
-
-/* Portable versions of host-network order stuff
- */
-#define g_ntohl(val) (GUINT32_FROM_BE (val))
-#define g_ntohs(val) (GUINT16_FROM_BE (val))
-#define g_htonl(val) (GUINT32_TO_BE (val))
-#define g_htons(val) (GUINT16_TO_BE (val))
-
-
-/* Glib version.
- * we prefix variable declarations so they can
- * properly get exported in windows dlls.
- */
-#ifdef G_OS_WIN32
-#  ifdef GLIB_COMPILATION
-#    define GLIB_VAR __declspec(dllexport)
-#  else /* !GLIB_COMPILATION */
-#    define GLIB_VAR extern __declspec(dllimport)
-#  endif /* !GLIB_COMPILATION */
-#else /* !G_OS_WIN32 */
-#  define GLIB_VAR extern
-#endif /* !G_OS_WIN32 */
-
-GLIB_VAR const guint glib_major_version;
-GLIB_VAR const guint glib_minor_version;
-GLIB_VAR const guint glib_micro_version;
-GLIB_VAR const guint glib_interface_age;
-GLIB_VAR const guint glib_binary_age;
-
-#define GLIB_CHECK_VERSION(major,minor,micro)    \
-    (GLIB_MAJOR_VERSION > (major) || \
-     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \
-     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION == (minor) && \
-      GLIB_MICRO_VERSION >= (micro)))
-
-/* Forward declarations of glib types.
- */
-typedef struct _GAllocator     GAllocator;
-typedef struct _GArray         GArray;
-typedef struct _GByteArray     GByteArray;
-typedef struct _GCache         GCache;
-typedef struct _GCompletion    GCompletion;
-typedef        struct _GData           GData;
-typedef struct _GDebugKey      GDebugKey;
-typedef union  _GDoubleIEEE754 GDoubleIEEE754;
-typedef union  _GFloatIEEE754  GFloatIEEE754;
-typedef struct _GHashTable     GHashTable;
-typedef struct _GHook          GHook;
-typedef struct _GHookList      GHookList;
-typedef struct _GList          GList;
-typedef struct _GMemChunk      GMemChunk;
-typedef struct _GNode          GNode;
-typedef struct _GPtrArray      GPtrArray;
-typedef struct _GQueue         GQueue;
-typedef struct _GRand          GRand;
-typedef struct _GRelation      GRelation;
-typedef struct _GScanner       GScanner;
-typedef struct _GScannerConfig GScannerConfig;
-typedef struct _GSList         GSList;
-typedef struct _GString                GString;
-typedef struct _GStringChunk   GStringChunk;
-typedef struct _GTimer         GTimer;
-typedef struct _GTrashStack     GTrashStack;
-typedef struct _GTree          GTree;
-typedef struct _GTuples                GTuples;
-typedef union  _GTokenValue    GTokenValue;
-typedef struct _GIOChannel     GIOChannel;
-
-/* Tree traverse flags */
-typedef enum
-{
-  G_TRAVERSE_LEAFS     = 1 << 0,
-  G_TRAVERSE_NON_LEAFS = 1 << 1,
-  G_TRAVERSE_ALL       = G_TRAVERSE_LEAFS | G_TRAVERSE_NON_LEAFS,
-  G_TRAVERSE_MASK      = 0x03
-} GTraverseFlags;
-
-/* Tree traverse orders */
-typedef enum
-{
-  G_IN_ORDER,
-  G_PRE_ORDER,
-  G_POST_ORDER,
-  G_LEVEL_ORDER
-} GTraverseType;
-
-/* Log level shift offset for user defined
- * log levels (0-7 are used by GLib).
- */
-#define        G_LOG_LEVEL_USER_SHIFT  (8)
-
-/* Glib log levels and flags.
- */
-typedef enum
-{
-  /* log flags */
-  G_LOG_FLAG_RECURSION         = 1 << 0,
-  G_LOG_FLAG_FATAL             = 1 << 1,
-  
-  /* GLib log levels */
-  G_LOG_LEVEL_ERROR            = 1 << 2,       /* always fatal */
-  G_LOG_LEVEL_CRITICAL         = 1 << 3,
-  G_LOG_LEVEL_WARNING          = 1 << 4,
-  G_LOG_LEVEL_MESSAGE          = 1 << 5,
-  G_LOG_LEVEL_INFO             = 1 << 6,
-  G_LOG_LEVEL_DEBUG            = 1 << 7,
-  
-  G_LOG_LEVEL_MASK             = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
-} GLogLevelFlags;
-
-/* GLib log levels that are considered fatal by default */
-#define        G_LOG_FATAL_MASK        (G_LOG_FLAG_RECURSION | G_LOG_LEVEL_ERROR)
-
-
-typedef gpointer       (*GCacheNewFunc)        (gpointer       key);
-typedef gpointer       (*GCacheDupFunc)        (gpointer       value);
-typedef void           (*GCacheDestroyFunc)    (gpointer       value);
-typedef gint           (*GCompareFunc)         (gconstpointer  a,
-                                                gconstpointer  b);
-typedef gchar*         (*GCompletionFunc)      (gpointer);
-typedef void           (*GDestroyNotify)       (gpointer       data);
-typedef void           (*GDataForeachFunc)     (GQuark         key_id,
-                                                gpointer       data,
-                                                gpointer       user_data);
-typedef void           (*GFunc)                (gpointer       data,
-                                                gpointer       user_data);
-typedef guint          (*GHashFunc)            (gconstpointer  key);
-typedef void           (*GFreeFunc)            (gpointer       data);
-typedef void           (*GHFunc)               (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       user_data);
-typedef gboolean       (*GHRFunc)              (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       user_data);
-typedef gint           (*GHookCompareFunc)     (GHook          *new_hook,
-                                                GHook          *sibling);
-typedef gboolean       (*GHookFindFunc)        (GHook          *hook,
-                                                gpointer        data);
-typedef void           (*GHookMarshaller)      (GHook          *hook,
-                                                gpointer        data);
-typedef gboolean       (*GHookCheckMarshaller) (GHook          *hook,
-                                                gpointer        data);
-typedef void           (*GHookFunc)            (gpointer        data);
-typedef gboolean       (*GHookCheckFunc)       (gpointer        data);
-typedef void           (*GHookFreeFunc)        (GHookList      *hook_list,
-                                                GHook          *hook);
-typedef void           (*GLogFunc)             (const gchar   *log_domain,
-                                                GLogLevelFlags log_level,
-                                                const gchar   *message,
-                                                gpointer       user_data);
-typedef gboolean       (*GNodeTraverseFunc)    (GNode         *node,
-                                                gpointer       data);
-typedef void           (*GNodeForeachFunc)     (GNode         *node,
-                                                gpointer       data);
-typedef void           (*GScannerMsgFunc)      (GScanner      *scanner,
-                                                gchar         *message,
-                                                gint           error);
-typedef gint           (*GTraverseFunc)        (gpointer       key,
-                                                gpointer       value,
-                                                gpointer       data);
-typedef        void            (*GVoidFunc)            (void);
-
-
-struct _GArray
-{
-  gchar *data;
-  guint len;
-};
-
-struct _GByteArray
-{
-  guint8 *data;
-  guint          len;
-};
-
-struct _GDebugKey
-{
-  gchar *key;
-  guint         value;
-};
-
-struct _GList
-{
-  gpointer data;
-  GList *next;
-  GList *prev;
-};
-
-struct _GPtrArray
-{
-  gpointer *pdata;
-  guint            len;
-};
-
-struct _GQueue
-{
-  GList *head;
-  GList *tail;
-  guint  length;
-};
-
-struct _GSList
-{
-  gpointer data;
-  GSList *next;
-};
-
-struct _GString
-{
-  gchar *str;
-  gint len;
-};
-
-struct _GTrashStack
-{
-  GTrashStack *next;
-};
-
-struct _GTuples
-{
-  guint len;
-};
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
-
-#include <gerror.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
-/* IEEE Standard 754 Single Precision Storage Format (gfloat):
- *
- *        31 30           23 22            0
- * +--------+---------------+---------------+
- * | s 1bit | e[30:23] 8bit | f[22:0] 23bit |
- * +--------+---------------+---------------+
- * B0------------------->B1------->B2-->B3-->
- *
- * IEEE Standard 754 Double Precision Storage Format (gdouble):
- *
- *        63 62            52 51            32   31            0
- * +--------+----------------+----------------+ +---------------+
- * | s 1bit | e[62:52] 11bit | f[51:32] 20bit | | f[31:0] 32bit |
- * +--------+----------------+----------------+ +---------------+
- * B0--------------->B1---------->B2--->B3---->  B4->B5->B6->B7->
- */
-/* subtract from biased_exponent to form base2 exponent (normal numbers) */
-#define G_IEEE754_FLOAT_BIAS   (127)
-#define G_IEEE754_DOUBLE_BIAS  (1023)
-/* multiply with base2 exponent to get base10 exponent (nomal numbers) */
-#define G_LOG_2_BASE_10                (0.30102999566398119521)
-#if G_BYTE_ORDER == G_LITTLE_ENDIAN
-union _GFloatIEEE754
-{
-  gfloat v_float;
-  struct {
-    guint mantissa : 23;
-    guint biased_exponent : 8;
-    guint sign : 1;
-  } mpn;
-};
-union _GDoubleIEEE754
-{
-  gdouble v_double;
-  struct {
-    guint mantissa_low : 32;
-    guint mantissa_high : 20;
-    guint biased_exponent : 11;
-    guint sign : 1;
-  } mpn;
-};
-#elif G_BYTE_ORDER == G_BIG_ENDIAN
-union _GFloatIEEE754
-{
-  gfloat v_float;
-  struct {
-    guint sign : 1;
-    guint biased_exponent : 8;
-    guint mantissa : 23;
-  } mpn;
-};
-union _GDoubleIEEE754
-{
-  gdouble v_double;
-  struct {
-    guint sign : 1;
-    guint biased_exponent : 11;
-    guint mantissa_high : 20;
-    guint mantissa_low : 32;
-  } mpn;
-};
-#else /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
-#error unknown ENDIAN type
-#endif /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
-
-
-/* Doubly linked lists
- */
-void   g_list_push_allocator    (GAllocator     *allocator);
-void   g_list_pop_allocator     (void);
-GList* g_list_alloc            (void);
-void   g_list_free             (GList          *list);
-void   g_list_free_1           (GList          *list);
-GList* g_list_append           (GList          *list,
-                                gpointer        data);
-GList* g_list_prepend          (GList          *list,
-                                gpointer        data);
-GList* g_list_insert           (GList          *list,
-                                gpointer        data,
-                                gint            position);
-GList* g_list_insert_sorted    (GList          *list,
-                                gpointer        data,
-                                GCompareFunc    func);
-GList* g_list_concat           (GList          *list1,
-                                GList          *list2);
-GList* g_list_remove           (GList          *list,
-                                gconstpointer   data);
-GList* g_list_remove_link      (GList          *list,
-                                GList          *llink);
-GList* g_list_delete_link      (GList          *list,
-                                GList          *link);
-GList* g_list_reverse          (GList          *list);
-GList* g_list_copy             (GList          *list);
-GList* g_list_nth              (GList          *list,
-                                guint           n);
-GList* g_list_find             (GList          *list,
-                                gconstpointer   data);
-GList* g_list_find_custom      (GList          *list,
-                                gconstpointer   data,
-                                GCompareFunc    func);
-gint   g_list_position         (GList          *list,
-                                GList          *llink);
-gint   g_list_index            (GList          *list,
-                                gconstpointer   data);
-GList* g_list_last             (GList          *list);
-GList* g_list_first            (GList          *list);
-guint  g_list_length           (GList          *list);
-void   g_list_foreach          (GList          *list,
-                                GFunc           func,
-                                gpointer        user_data);
-GList* g_list_sort              (GList          *list,
-                                GCompareFunc    compare_func);
-gpointer g_list_nth_data       (GList          *list,
-                                guint           n);
-#define g_list_previous(list)  ((list) ? (((GList *)(list))->prev) : NULL)
-#define g_list_next(list)      ((list) ? (((GList *)(list))->next) : NULL)
-
-
-/* Singly linked lists
- */
-void    g_slist_push_allocator  (GAllocator     *allocator);
-void    g_slist_pop_allocator   (void);
-GSList* g_slist_alloc          (void);
-void   g_slist_free            (GSList         *list);
-void   g_slist_free_1          (GSList         *list);
-GSList* g_slist_append         (GSList         *list,
-                                gpointer        data);
-GSList* g_slist_prepend                (GSList         *list,
-                                gpointer        data);
-GSList* g_slist_insert         (GSList         *list,
-                                gpointer        data,
-                                gint            position);
-GSList* g_slist_insert_sorted  (GSList         *list,
-                                gpointer        data,
-                                GCompareFunc    func);
-GSList* g_slist_insert_before   (GSList         *slist,
-                                GSList         *sibling,
-                                gpointer        data);
-GSList* g_slist_concat         (GSList         *list1,
-                                GSList         *list2);
-GSList* g_slist_remove         (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_remove_link    (GSList         *list,
-                                GSList         *link);
-GSList* g_slist_delete_link     (GSList         *list,
-                                GSList         *link);
-GSList* g_slist_reverse                (GSList         *list);
-GSList*        g_slist_copy            (GSList         *list);
-GSList* g_slist_nth            (GSList         *list,
-                                guint           n);
-GSList* g_slist_find           (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_find_custom    (GSList         *list,
-                                gconstpointer   data,
-                                GCompareFunc    func);
-gint   g_slist_position        (GSList         *list,
-                                GSList         *llink);
-gint   g_slist_index           (GSList         *list,
-                                gconstpointer   data);
-GSList* g_slist_last           (GSList         *list);
-guint  g_slist_length          (GSList         *list);
-void   g_slist_foreach         (GSList         *list,
-                                GFunc           func,
-                                gpointer        user_data);
-GSList*  g_slist_sort           (GSList          *list,
-                                GCompareFunc    compare_func);
-gpointer g_slist_nth_data      (GSList         *list,
-                                guint           n);
-#define  g_slist_next(slist)   ((slist) ? (((GSList *)(slist))->next) : NULL)
-
-
-/* Queues
- */
-GQueue*  g_queue_new            (void);
-void     g_queue_free           (GQueue  *queue);
-void     g_queue_push_head      (GQueue  *queue,
-                                gpointer data);
-void     g_queue_push_tail      (GQueue  *queue,
-                                gpointer data);
-gpointer g_queue_pop_head       (GQueue  *queue);
-gpointer g_queue_pop_tail       (GQueue  *queue);
-gboolean g_queue_is_empty       (GQueue  *queue);
-gpointer g_queue_peek_head      (GQueue  *queue);
-gpointer g_queue_peek_tail      (GQueue  *queue);
-void     g_queue_push_head_link (GQueue  *queue,
-                                GList   *link);
-void     g_queue_push_tail_link (GQueue  *queue,
-                                GList   *link);
-GList*   g_queue_pop_head_link  (GQueue  *queue);
-GList*   g_queue_pop_tail_link  (GQueue  *queue);
-
-/* Hash tables
- */
-GHashTable* g_hash_table_new           (GHashFunc       hash_func,
-                                        GCompareFunc    key_compare_func);
-void       g_hash_table_destroy        (GHashTable     *hash_table);
-void       g_hash_table_insert         (GHashTable     *hash_table,
-                                        gpointer        key,
-                                        gpointer        value);
-void       g_hash_table_remove         (GHashTable     *hash_table,
-                                        gconstpointer   key);
-gpointer    g_hash_table_lookup                (GHashTable     *hash_table,
-                                        gconstpointer   key);
-gboolean    g_hash_table_lookup_extended(GHashTable    *hash_table,
-                                        gconstpointer   lookup_key,
-                                        gpointer       *orig_key,
-                                        gpointer       *value);
-void       g_hash_table_foreach        (GHashTable     *hash_table,
-                                        GHFunc          func,
-                                        gpointer        user_data);
-guint      g_hash_table_foreach_remove (GHashTable     *hash_table,
-                                        GHRFunc         func,
-                                        gpointer        user_data);
-guint      g_hash_table_size           (GHashTable     *hash_table);
-
-/* The following two functions are deprecated and will be removed in
- * the next major release. They do no good. */
-void       g_hash_table_freeze         (GHashTable     *hash_table);
-void       g_hash_table_thaw           (GHashTable     *hash_table);
-
-/* Caches
- */
-GCache*         g_cache_new           (GCacheNewFunc      value_new_func,
-                               GCacheDestroyFunc  value_destroy_func,
-                               GCacheDupFunc      key_dup_func,
-                               GCacheDestroyFunc  key_destroy_func,
-                               GHashFunc          hash_key_func,
-                               GHashFunc          hash_value_func,
-                               GCompareFunc       key_compare_func);
-void    g_cache_destroy       (GCache            *cache);
-gpointer g_cache_insert               (GCache            *cache,
-                               gpointer           key);
-void    g_cache_remove        (GCache            *cache,
-                               gconstpointer      value);
-void    g_cache_key_foreach   (GCache            *cache,
-                               GHFunc             func,
-                               gpointer           user_data);
-void    g_cache_value_foreach (GCache            *cache,
-                               GHFunc             func,
-                               gpointer           user_data);
-
-
-/* Balanced binary trees
- */
-GTree*  g_tree_new      (GCompareFunc   key_compare_func);
-void    g_tree_destroy  (GTree         *tree);
-void    g_tree_insert   (GTree         *tree,
-                         gpointer       key,
-                         gpointer       value);
-void    g_tree_remove   (GTree         *tree,
-                         gconstpointer  key);
-gpointer g_tree_lookup  (GTree         *tree,
-                         gconstpointer  key);
-void    g_tree_traverse (GTree         *tree,
-                         GTraverseFunc  traverse_func,
-                         GTraverseType  traverse_type,
-                         gpointer       data);
-gpointer g_tree_search  (GTree         *tree,
-                         GCompareFunc   search_func,
-                         gconstpointer  data);
-gint    g_tree_height   (GTree         *tree);
-gint    g_tree_nnodes   (GTree         *tree);
-
-
-
-/* N-way tree implementation
- */
-struct _GNode
-{
-  gpointer data;
-  GNode          *next;
-  GNode          *prev;
-  GNode          *parent;
-  GNode          *children;
-};
-
-#define         G_NODE_IS_ROOT(node)   (((GNode*) (node))->parent == NULL && \
-                                ((GNode*) (node))->prev == NULL && \
-                                ((GNode*) (node))->next == NULL)
-#define         G_NODE_IS_LEAF(node)   (((GNode*) (node))->children == NULL)
-
-void     g_node_push_allocator  (GAllocator       *allocator);
-void     g_node_pop_allocator   (void);
-GNode*  g_node_new             (gpointer          data);
-void    g_node_destroy         (GNode            *root);
-void    g_node_unlink          (GNode            *node);
-GNode*   g_node_copy            (GNode            *node);
-GNode*  g_node_insert          (GNode            *parent,
-                                gint              position,
-                                GNode            *node);
-GNode*  g_node_insert_before   (GNode            *parent,
-                                GNode            *sibling,
-                                GNode            *node);
-GNode*  g_node_insert_after    (GNode            *parent,
-                                GNode            *sibling,
-                                GNode            *node);
-GNode*  g_node_prepend         (GNode            *parent,
-                                GNode            *node);
-guint   g_node_n_nodes         (GNode            *root,
-                                GTraverseFlags    flags);
-GNode*  g_node_get_root        (GNode            *node);
-gboolean g_node_is_ancestor    (GNode            *node,
-                                GNode            *descendant);
-guint   g_node_depth           (GNode            *node);
-GNode*  g_node_find            (GNode            *root,
-                                GTraverseType     order,
-                                GTraverseFlags    flags,
-                                gpointer          data);
-
-/* convenience macros */
-#define g_node_append(parent, node)                            \
-     g_node_insert_before ((parent), NULL, (node))
-#define        g_node_insert_data(parent, position, data)              \
-     g_node_insert ((parent), (position), g_node_new (data))
-#define        g_node_insert_data_before(parent, sibling, data)        \
-     g_node_insert_before ((parent), (sibling), g_node_new (data))
-#define        g_node_prepend_data(parent, data)                       \
-     g_node_prepend ((parent), g_node_new (data))
-#define        g_node_append_data(parent, data)                        \
-     g_node_insert_before ((parent), NULL, g_node_new (data))
-
-/* traversal function, assumes that `node' is root
- * (only traverses `node' and its subtree).
- * this function is just a high level interface to
- * low level traversal functions, optimized for speed.
- */
-void    g_node_traverse        (GNode            *root,
-                                GTraverseType     order,
-                                GTraverseFlags    flags,
-                                gint              max_depth,
-                                GNodeTraverseFunc func,
-                                gpointer          data);
-
-/* return the maximum tree height starting with `node', this is an expensive
- * operation, since we need to visit all nodes. this could be shortened by
- * adding `guint height' to struct _GNode, but then again, this is not very
- * often needed, and would make g_node_insert() more time consuming.
- */
-guint   g_node_max_height       (GNode *root);
-
-void    g_node_children_foreach (GNode           *node,
-                                 GTraverseFlags   flags,
-                                 GNodeForeachFunc func,
-                                 gpointer         data);
-void    g_node_reverse_children (GNode           *node);
-guint   g_node_n_children       (GNode           *node);
-GNode*  g_node_nth_child        (GNode           *node,
-                                 guint            n);
-GNode*  g_node_last_child       (GNode           *node);
-GNode*  g_node_find_child       (GNode           *node,
-                                 GTraverseFlags   flags,
-                                 gpointer         data);
-gint    g_node_child_position   (GNode           *node,
-                                 GNode           *child);
-gint    g_node_child_index      (GNode           *node,
-                                 gpointer         data);
-
-GNode*  g_node_first_sibling    (GNode           *node);
-GNode*  g_node_last_sibling     (GNode           *node);
-
-#define         g_node_prev_sibling(node)      ((node) ? \
-                                        ((GNode*) (node))->prev : NULL)
-#define         g_node_next_sibling(node)      ((node) ? \
-                                        ((GNode*) (node))->next : NULL)
-#define         g_node_first_child(node)       ((node) ? \
-                                        ((GNode*) (node))->children : NULL)
-
-
-/* Callback maintenance functions
- */
-#define G_HOOK_FLAG_USER_SHIFT (4)
-typedef enum
-{
-  G_HOOK_FLAG_ACTIVE   = 1 << 0,
-  G_HOOK_FLAG_IN_CALL  = 1 << 1,
-  G_HOOK_FLAG_MASK     = 0x0f
-} GHookFlagMask;
-
-#define        G_HOOK_DEFERRED_DESTROY ((GHookFreeFunc) 0x01)
-
-struct _GHookList
-{
-  guint                 seq_id;
-  guint                 hook_size;
-  guint                 is_setup : 1;
-  GHook                *hooks;
-  GMemChunk    *hook_memchunk;
-  GHookFreeFunc         hook_free; /* virtual function */
-  GHookFreeFunc         hook_destroy; /* virtual function */
-};
-
-struct _GHook
-{
-  gpointer      data;
-  GHook                *next;
-  GHook                *prev;
-  guint                 ref_count;
-  guint                 hook_id;
-  guint                 flags;
-  gpointer      func;
-  GDestroyNotify destroy;
-};
-
-#define        G_HOOK_ACTIVE(hook)             ((((GHook*) hook)->flags & \
-                                         G_HOOK_FLAG_ACTIVE) != 0)
-#define        G_HOOK_IN_CALL(hook)            ((((GHook*) hook)->flags & \
-                                         G_HOOK_FLAG_IN_CALL) != 0)
-#define G_HOOK_IS_VALID(hook)          (((GHook*) hook)->hook_id != 0 && \
-                                        G_HOOK_ACTIVE (hook))
-#define G_HOOK_IS_UNLINKED(hook)       (((GHook*) hook)->next == NULL && \
-                                        ((GHook*) hook)->prev == NULL && \
-                                        ((GHook*) hook)->hook_id == 0 && \
-                                        ((GHook*) hook)->ref_count == 0)
-
-void    g_hook_list_init               (GHookList              *hook_list,
-                                        guint                   hook_size);
-void    g_hook_list_clear              (GHookList              *hook_list);
-GHook*  g_hook_alloc                   (GHookList              *hook_list);
-void    g_hook_free                    (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_ref                     (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_unref                   (GHookList              *hook_list,
-                                        GHook                  *hook);
-gboolean g_hook_destroy                        (GHookList              *hook_list,
-                                        guint                   hook_id);
-void    g_hook_destroy_link            (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_prepend                 (GHookList              *hook_list,
-                                        GHook                  *hook);
-void    g_hook_insert_before           (GHookList              *hook_list,
-                                        GHook                  *sibling,
-                                        GHook                  *hook);
-void    g_hook_insert_sorted           (GHookList              *hook_list,
-                                        GHook                  *hook,
-                                        GHookCompareFunc        func);
-GHook*  g_hook_get                     (GHookList              *hook_list,
-                                        guint                   hook_id);
-GHook*  g_hook_find                    (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        GHookFindFunc           func,
-                                        gpointer                data);
-GHook*  g_hook_find_data               (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                data);
-GHook*  g_hook_find_func               (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                func);
-GHook*  g_hook_find_func_data          (GHookList              *hook_list,
-                                        gboolean                need_valids,
-                                        gpointer                func,
-                                        gpointer                data);
-/* return the first valid hook, and increment its reference count */
-GHook*  g_hook_first_valid             (GHookList              *hook_list,
-                                        gboolean                may_be_in_call);
-/* return the next valid hook with incremented reference count, and
- * decrement the reference count of the original hook
- */
-GHook*  g_hook_next_valid              (GHookList              *hook_list,
-                                        GHook                  *hook,
-                                        gboolean                may_be_in_call);
-
-/* GHookCompareFunc implementation to insert hooks sorted by their id */
-gint    g_hook_compare_ids             (GHook                  *new_hook,
-                                        GHook                  *sibling);
-
-/* convenience macros */
-#define         g_hook_append( hook_list, hook )  \
-     g_hook_insert_before ((hook_list), NULL, (hook))
-
-/* invoke all valid hooks with the (*GHookFunc) signature.
- */
-void    g_hook_list_invoke             (GHookList              *hook_list,
-                                        gboolean                may_recurse);
-/* invoke all valid hooks with the (*GHookCheckFunc) signature,
- * and destroy the hook if FALSE is returned.
- */
-void    g_hook_list_invoke_check       (GHookList              *hook_list,
-                                        gboolean                may_recurse);
-/* invoke a marshaller on all valid hooks.
- */
-void    g_hook_list_marshal            (GHookList              *hook_list,
-                                        gboolean                may_recurse,
-                                        GHookMarshaller         marshaller,
-                                        gpointer                data);
-void    g_hook_list_marshal_check      (GHookList              *hook_list,
-                                        gboolean                may_recurse,
-                                        GHookCheckMarshaller    marshaller,
-                                        gpointer                data);
-
-
-/* Fatal error handlers.
- * g_on_error_query() will prompt the user to either
- * [E]xit, [H]alt, [P]roceed or show [S]tack trace.
- * g_on_error_stack_trace() invokes gdb, which attaches to the current
- * process and shows a stack trace.
- * These function may cause different actions on non-unix platforms.
- * The prg_name arg is required by gdb to find the executable, if it is
- * passed as NULL, g_on_error_query() will try g_get_prgname().
- */
-void g_on_error_query (const gchar *prg_name);
-void g_on_error_stack_trace (const gchar *prg_name);
-
-
-/* Logging mechanism
- */
-extern         const gchar             *g_log_domain_glib;
-guint          g_log_set_handler       (const gchar    *log_domain,
-                                        GLogLevelFlags  log_levels,
-                                        GLogFunc        log_func,
-                                        gpointer        user_data);
-void           g_log_remove_handler    (const gchar    *log_domain,
-                                        guint           handler_id);
-void           g_log_default_handler   (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *message,
-                                        gpointer        unused_data);
-void           g_log                   (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *format,
-                                        ...) G_GNUC_PRINTF (3, 4);
-void           g_logv                  (const gchar    *log_domain,
-                                        GLogLevelFlags  log_level,
-                                        const gchar    *format,
-                                        va_list         args);
-GLogLevelFlags g_log_set_fatal_mask    (const gchar    *log_domain,
-                                        GLogLevelFlags  fatal_mask);
-GLogLevelFlags g_log_set_always_fatal  (GLogLevelFlags  fatal_mask);
-#ifndef        G_LOG_DOMAIN
-#define        G_LOG_DOMAIN    ((gchar*) 0)
-#endif /* G_LOG_DOMAIN */
-#if defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
-#define        g_error(...)    g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_ERROR,    \
-                              __VA_ARGS__)
-#define        g_message(...)  g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_MESSAGE,  \
-                              __VA_ARGS__)
-#define        g_critical(...) g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_CRITICAL, \
-                              __VA_ARGS__)
-#define        g_warning(...)  g_log (G_LOG_DOMAIN,         \
-                              G_LOG_LEVEL_WARNING,  \
-                              __VA_ARGS__)
-#elif __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4)
-#define        g_error(format...)      g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_ERROR,    \
-                                      format)
-#define        g_message(format...)    g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_MESSAGE,  \
-                                      format)
-#define        g_critical(format...)   g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_CRITICAL, \
-                                      format)
-#define        g_warning(format...)    g_log (G_LOG_DOMAIN,         \
-                                      G_LOG_LEVEL_WARNING,  \
-                                      format)
-#else  /* !__GNUC__ */
-static void
-g_error (const gchar *format,
-        ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, args);
-  va_end (args);
-}
-static void
-g_message (const gchar *format,
-          ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, args);
-  va_end (args);
-}
-static void
-g_critical (const gchar *format,
-           ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, args);
-  va_end (args);
-}
-static void
-g_warning (const gchar *format,
-          ...)
-{
-  va_list args;
-  va_start (args, format);
-  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, args);
-  va_end (args);
-}
-#endif /* !__GNUC__ */
-
-typedef void   (*GPrintFunc)           (const gchar    *string);
-void           g_print                 (const gchar    *format,
-                                        ...) G_GNUC_PRINTF (1, 2);
-GPrintFunc     g_set_print_handler     (GPrintFunc      func);
-void           g_printerr              (const gchar    *format,
-                                        ...) G_GNUC_PRINTF (1, 2);
-GPrintFunc     g_set_printerr_handler  (GPrintFunc      func);
-
-/* deprecated compatibility functions, use g_log_set_handler() instead */
-typedef void           (*GErrorFunc)           (const gchar *str);
-typedef void           (*GWarningFunc)         (const gchar *str);
-GErrorFunc   g_set_error_handler   (GErrorFunc  func);
-GWarningFunc g_set_warning_handler (GWarningFunc func);
-GPrintFunc   g_set_message_handler (GPrintFunc func);
-
-
-/* Memory allocation and debugging
- */
-#ifdef USE_DMALLOC
-
-#define g_malloc(size)      ((gpointer) MALLOC (size))
-#define g_malloc0(size)             ((gpointer) CALLOC (char, size))
-#define g_realloc(mem,size)  ((gpointer) REALLOC (mem, char, size))
-#define g_free(mem)         FREE (mem)
-
-#else /* !USE_DMALLOC */
-
-gpointer g_malloc      (gulong   size);
-gpointer g_malloc0     (gulong   size);
-gpointer g_realloc     (gpointer  mem,
-                       gulong    size);
-void    g_free        (gpointer  mem);
-
-#endif /* !USE_DMALLOC */
-
-void    g_mem_profile (void);
-void    g_mem_check   (gpointer  mem);
-
-/* Generic allocators
- */
-GAllocator* g_allocator_new   (const gchar  *name,
-                              guint         n_preallocs);
-void        g_allocator_free  (GAllocator   *allocator);
-
-#define        G_ALLOCATOR_LIST        (1)
-#define        G_ALLOCATOR_SLIST       (2)
-#define        G_ALLOCATOR_NODE        (3)
-
-
-/* "g_mem_chunk_new" creates a new memory chunk.
- * Memory chunks are used to allocate pieces of memory which are
- *  always the same size. Lists are a good example of such a data type.
- * The memory chunk allocates and frees blocks of memory as needed.
- *  Just be sure to call "g_mem_chunk_free" and not "g_free" on data
- *  allocated in a mem chunk. ("g_free" will most likely cause a seg
- *  fault...somewhere).
- *
- * Oh yeah, GMemChunk is an opaque data type. (You don't really
- *  want to know what's going on inside do you?)
- */
-
-/* ALLOC_ONLY MemChunk's can only allocate memory. The free operation
- *  is interpreted as a no op. ALLOC_ONLY MemChunk's save 4 bytes per
- *  atom. (They are also useful for lists which use MemChunk to allocate
- *  memory but are also part of the MemChunk implementation).
- * ALLOC_AND_FREE MemChunk's can allocate and free memory.
- */
-
-#define G_ALLOC_ONLY     1
-#define G_ALLOC_AND_FREE  2
-
-GMemChunk* g_mem_chunk_new     (gchar    *name,
-                               gint       atom_size,
-                               gulong     area_size,
-                               gint       type);
-void      g_mem_chunk_destroy (GMemChunk *mem_chunk);
-gpointer   g_mem_chunk_alloc   (GMemChunk *mem_chunk);
-gpointer   g_mem_chunk_alloc0  (GMemChunk *mem_chunk);
-void      g_mem_chunk_free    (GMemChunk *mem_chunk,
-                               gpointer   mem);
-void      g_mem_chunk_clean   (GMemChunk *mem_chunk);
-void      g_mem_chunk_reset   (GMemChunk *mem_chunk);
-void      g_mem_chunk_print   (GMemChunk *mem_chunk);
-void      g_mem_chunk_info    (void);
-
-/* Ah yes...we have a "g_blow_chunks" function.
- * "g_blow_chunks" simply compresses all the chunks. This operation
- *  consists of freeing every memory area that should be freed (but
- *  which we haven't gotten around to doing yet). And, no,
- *  "g_blow_chunks" doesn't follow the naming scheme, but it is a
- *  much better name than "g_mem_chunk_clean_all" or something
- *  similar.
- */
-void g_blow_chunks (void);
-
-
-/* Timer
- */
-
-/* microseconds per second */
-#define G_USEC_PER_SEC 1000000
-
-GTimer* g_timer_new    (void);
-void   g_timer_destroy (GTimer  *timer);
-void   g_timer_start   (GTimer  *timer);
-void   g_timer_stop    (GTimer  *timer);
-void   g_timer_reset   (GTimer  *timer);
-gdouble g_timer_elapsed (GTimer         *timer,
-                        gulong  *microseconds);
-void    g_usleep        (gulong microseconds);
-
-/* String utility functions that modify a string argument or
- * return a constant string that must not be freed.
- */
-#define         G_STR_DELIMITERS       "_-|> <."
-gchar*  g_strdelimit           (gchar       *string,
-                                const gchar *delimiters,
-                                gchar        new_delimiter);
-gchar*  g_strcanon             (gchar       *string,
-                                const gchar *valid_chars,
-                                gchar        subsitutor);
-gdouble         g_strtod               (const gchar *nptr,
-                                gchar      **endptr);
-gchar*  g_strerror             (gint         errnum) G_GNUC_CONST;
-gchar*  g_strsignal            (gint         signum) G_GNUC_CONST;
-gint    g_strcasecmp           (const gchar *s1,
-                                const gchar *s2);
-gint    g_strncasecmp          (const gchar *s1,
-                                const gchar *s2,
-                                guint        n);
-gchar*  g_strdown              (gchar       *string);
-gchar*  g_strup                (gchar       *string);
-gchar*  g_strreverse           (gchar       *string);
-gsize   g_strlcpy              (gchar       *dest,
-                                const gchar *src,
-                                gsize        dest_size);
-gsize   g_strlcat              (gchar       *dest,
-                                const gchar *src,
-                                gsize        dest_size);
-/* removes leading spaces */
-gchar*   g_strchug              (gchar        *string);
-/* removes trailing spaces */
-gchar*  g_strchomp              (gchar        *string);
-/* removes leading & trailing spaces */
-#define g_strstrip( string )   g_strchomp (g_strchug (string))
-
-/* String utility functions that return a newly allocated string which
- * ought to be freed with g_free from the caller at some point.
- */
-gchar*  g_strdup               (const gchar *str);
-gchar*  g_strdup_printf        (const gchar *format,
-                                ...) G_GNUC_PRINTF (1, 2);
-gchar*  g_strdup_vprintf       (const gchar *format,
-                                va_list      args);
-gchar*  g_strndup              (const gchar *str,
-                                guint        n);
-gchar*  g_strnfill             (guint        length,
-                                gchar        fill_char);
-gchar*  g_strconcat            (const gchar *string1,
-                                ...); /* NULL terminated */
-gchar*   g_strjoin             (const gchar  *separator,
-                                ...); /* NULL terminated */
-/* Make a copy of a string interpreting C string -style escape
- * sequences. Inverse of g_strescape. The recognized sequences are \b
- * \f \n \r \t \\ \" and the octal format.
- */
-gchar*   g_strcompress         (const gchar *source);
-
-/* Convert between the operating system (or C runtime)
- * representation of file names and UTF-8.
- */
-gchar*   g_filename_to_utf8 (const gchar *opsysstring);
-gchar*   g_filename_from_utf8 (const gchar *utf8string);
-
-/* Copy a string escaping nonprintable characters like in C strings.
- * Inverse of g_strcompress. The exceptions parameter, if non-NULL, points
- * to a string containing characters that are not to be escaped.
- *
- * Deprecated API: gchar* g_strescape (const gchar *source);
- * Luckily this function wasn't used much, using NULL as second parameter
- * provides mostly identical semantics.
- */
-gchar*   g_strescape           (const gchar *source,
-                                const gchar *exceptions);
-
-gpointer g_memdup              (gconstpointer mem,
-                                guint         byte_size);
-
-/* NULL terminated string arrays.
- * g_strsplit() splits up string into max_tokens tokens at delim and
- * returns a newly allocated string array.
- * g_strjoinv() concatenates all of str_array's strings, sliding in an
- * optional separator, the returned string is newly allocated.
- * g_strfreev() frees the array itself and all of its strings.
- */
-gchar**         g_strsplit             (const gchar  *string,
-                                const gchar  *delimiter,
-                                gint          max_tokens);
-gchar*   g_strjoinv            (const gchar  *separator,
-                                gchar       **str_array);
-void     g_strfreev            (gchar       **str_array);
-
-
-
-/* calculate a string size, guarranteed to fit format + args.
- */
-guint  g_printf_string_upper_bound (const gchar* format,
-                                    va_list      args);
-
-
-/* Retrive static string info
- */
-gchar* g_get_user_name         (void);
-gchar* g_get_real_name         (void);
-gchar* g_get_home_dir          (void);
-gchar* g_get_tmp_dir           (void);
-gchar* g_get_prgname           (void);
-void   g_set_prgname           (const gchar *prgname);
-
-
-/* Miscellaneous utility functions
- */
-guint  g_parse_debug_string    (const gchar *string,
-                                GDebugKey   *keys,
-                                guint        nkeys);
-gint   g_snprintf              (gchar       *string,
-                                gulong       n,
-                                gchar const *format,
-                                ...) G_GNUC_PRINTF (3, 4);
-gint   g_vsnprintf             (gchar       *string,
-                                gulong       n,
-                                gchar const *format,
-                                va_list      args);
-/* Check if a file name is an absolute path */
-gboolean g_path_is_absolute    (const gchar *file_name);
-/* In case of absolute paths, skip the root part */
-gchar*  g_path_skip_root       (gchar       *file_name);
-
-/* These two functions are deprecated and will be removed in the next
- * major release of GLib. Use g_path_get_dirname/g_path_get_basename
- * instead. Whatch out! The string returned by g_path_get_basename
- * must be g_freed, while the string returned by g_basename must not.*/
-gchar* g_basename              (const gchar *file_name);
-gchar* g_dirname               (const gchar *file_name);
-
-/* The returned strings are newly allocated with g_malloc() */
-gchar* g_get_current_dir       (void);
-gchar* g_path_get_basename     (const gchar *file_name);
-gchar* g_path_get_dirname      (const gchar *file_name);
-
-/* Get the codeset for the current locale */
-/* gchar * g_get_codeset    (void); */
-
-/* return the environment string for the variable. The returned memory
- * must not be freed. */
-gchar*  g_getenv               (const gchar *variable);
-
-/* we use a GLib function as a replacement for ATEXIT, so
- * the programmer is not required to check the return value
- * (if there is any in the implementation) and doesn't encounter
- * missing include files.
- */
-void   g_atexit                (GVoidFunc    func);
-
-/* Look for an executable in PATH, following execvp() rules */
-gchar*  g_find_program_in_path  (const gchar *program);
-
-/* Bit tests
- */
-G_INLINE_FUNC gint     g_bit_nth_lsf (guint32 mask,
-                                      gint    nth_bit);
-G_INLINE_FUNC gint     g_bit_nth_msf (guint32 mask,
-                                      gint    nth_bit);
-G_INLINE_FUNC guint    g_bit_storage (guint number);
-
-
-/* Trash Stacks
- * elements need to be >= sizeof (gpointer)
- */
-G_INLINE_FUNC void     g_trash_stack_push      (GTrashStack **stack_p,
-                                                gpointer      data_p);
-G_INLINE_FUNC gpointer g_trash_stack_pop       (GTrashStack **stack_p);
-G_INLINE_FUNC gpointer g_trash_stack_peek      (GTrashStack **stack_p);
-G_INLINE_FUNC guint    g_trash_stack_height    (GTrashStack **stack_p);
-
-
-/* inline function implementations
- */
-#if defined (G_CAN_INLINE) || defined (__G_UTILS_C__)
-G_INLINE_FUNC gint
-g_bit_nth_lsf (guint32 mask,
-              gint    nth_bit)
-{
-  do
-    {
-      nth_bit++;
-      if (mask & (1 << (guint) nth_bit))
-       return nth_bit;
-    }
-  while (nth_bit < 32);
-  return -1;
-}
-G_INLINE_FUNC gint
-g_bit_nth_msf (guint32 mask,
-              gint    nth_bit)
-{
-  if (nth_bit < 0)
-    nth_bit = 32;
-  do
-    {
-      nth_bit--;
-      if (mask & (1 << (guint) nth_bit))
-       return nth_bit;
-    }
-  while (nth_bit > 0);
-  return -1;
-}
-G_INLINE_FUNC guint
-g_bit_storage (guint number)
-{
-  register guint n_bits = 0;
-  
-  do
-    {
-      n_bits++;
-      number >>= 1;
-    }
-  while (number);
-  return n_bits;
-}
-G_INLINE_FUNC void
-g_trash_stack_push (GTrashStack **stack_p,
-                   gpointer      data_p)
-{
-  GTrashStack *data = (GTrashStack *) data_p;
-
-  data->next = *stack_p;
-  *stack_p = data;
-}
-G_INLINE_FUNC gpointer
-g_trash_stack_pop (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-
-  data = *stack_p;
-  if (data)
-    {
-      *stack_p = data->next;
-      /* NULLify private pointer here, most platforms store NULL as
-       * subsequent 0 bytes
-       */
-      data->next = NULL;
-    }
-
-  return data;
-}
-G_INLINE_FUNC gpointer
-g_trash_stack_peek (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-
-  data = *stack_p;
-
-  return data;
-}
-G_INLINE_FUNC guint
-g_trash_stack_height (GTrashStack **stack_p)
-{
-  GTrashStack *data;
-  guint i = 0;
-
-  for (data = *stack_p; data; data = data->next)
-    i++;
-
-  return i;
-}
-#endif  /* G_CAN_INLINE || __G_UTILS_C__ */
-
-
-/* String Chunks
- */
-GStringChunk* g_string_chunk_new          (gint size);
-void         g_string_chunk_free          (GStringChunk *chunk);
-gchar*       g_string_chunk_insert        (GStringChunk *chunk,
-                                           const gchar  *string);
-gchar*       g_string_chunk_insert_const  (GStringChunk *chunk,
-                                           const gchar  *string);
-
-
-/* Strings
- */
-GString*     g_string_new              (const gchar     *init);
-GString*     g_string_sized_new         (guint           dfl_size);
-gchar*      g_string_free              (GString         *string,
-                                        gboolean         free_segment);
-gboolean     g_string_equal             (const GString  *v,
-                                        const GString   *v2);
-guint        g_string_hash              (const GString   *str);
-GString*     g_string_assign            (GString        *string,
-                                        const gchar     *rval);
-GString*     g_string_truncate          (GString        *string,
-                                        guint            len);
-GString*     g_string_insert_len        (GString         *string,
-                                         gint             pos,
-                                         const gchar     *val,
-                                         gint             len);
-GString*     g_string_append            (GString        *string,
-                                        const gchar     *val);
-GString*     g_string_append_len        (GString        *string,
-                                        const gchar     *val,
-                                         gint             len);
-GString*     g_string_append_c          (GString        *string,
-                                        gchar            c);
-GString*     g_string_prepend           (GString        *string,
-                                        const gchar     *val);
-GString*     g_string_prepend_c         (GString        *string,
-                                        gchar            c);
-GString*     g_string_prepend_len       (GString        *string,
-                                        const gchar     *val,
-                                         gint             len);
-GString*     g_string_insert            (GString        *string,
-                                        gint             pos,
-                                        const gchar     *val);
-GString*     g_string_insert_c          (GString        *string,
-                                        gint             pos,
-                                        gchar            c);
-GString*     g_string_erase            (GString         *string,
-                                        gint             pos,
-                                        gint             len);
-GString*     g_string_down              (GString        *string);
-GString*     g_string_up                (GString        *string);
-void         g_string_sprintf           (GString        *string,
-                                        const gchar     *format,
-                                        ...) G_GNUC_PRINTF (2, 3);
-void         g_string_sprintfa          (GString        *string,
-                                        const gchar     *format,
-                                        ...) G_GNUC_PRINTF (2, 3);
-
-
-/* Resizable arrays, remove fills any cleared spot and shortens the
- * array, while preserving the order. remove_fast will distort the
- * order by moving the last element to the position of the removed 
- */
-
-#define g_array_append_val(a,v)          g_array_append_vals (a, &v, 1)
-#define g_array_prepend_val(a,v)  g_array_prepend_vals (a, &v, 1)
-#define g_array_insert_val(a,i,v) g_array_insert_vals (a, i, &v, 1)
-#define g_array_index(a,t,i)      (((t*) (a)->data) [(i)])
-
-GArray* g_array_new              (gboolean         zero_terminated,
-                                  gboolean         clear,
-                                  guint            element_size);
-GArray* g_array_sized_new         (gboolean        zero_terminated,
-                                  gboolean         clear,
-                                  guint            element_size,
-                                  guint            reserved_size);
-gchar*  g_array_free             (GArray          *array,
-                                  gboolean         free_segment);
-GArray* g_array_append_vals       (GArray         *array,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_prepend_vals      (GArray         *array,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_insert_vals       (GArray          *array,
-                                  guint            index,
-                                  gconstpointer    data,
-                                  guint            len);
-GArray* g_array_set_size          (GArray         *array,
-                                  guint            length);
-GArray* g_array_remove_index     (GArray          *array,
-                                  guint            index);
-GArray* g_array_remove_index_fast (GArray         *array,
-                                  guint            index);
-
-/* Resizable pointer array.  This interface is much less complicated
- * than the above.  Add appends appends a pointer.  Remove fills any
- * cleared spot and shortens the array. remove_fast will again distort
- * order.  
- */
-#define            g_ptr_array_index(array,index) (array->pdata)[index]
-GPtrArray*  g_ptr_array_new               (void);
-GPtrArray*  g_ptr_array_sized_new         (guint        reserved_size);
-gpointer*   g_ptr_array_free              (GPtrArray   *array,
-                                           gboolean     free_seg);
-void       g_ptr_array_set_size           (GPtrArray   *array,
-                                           gint         length);
-gpointer    g_ptr_array_remove_index      (GPtrArray   *array,
-                                           guint        index);
-gpointer    g_ptr_array_remove_index_fast  (GPtrArray  *array,
-                                           guint        index);
-gboolean    g_ptr_array_remove            (GPtrArray   *array,
-                                           gpointer     data);
-gboolean    g_ptr_array_remove_fast        (GPtrArray  *array,
-                                           gpointer     data);
-void       g_ptr_array_add                (GPtrArray   *array,
-                                           gpointer     data);
-
-/* Byte arrays, an array of guint8.  Implemented as a GArray,
- * but type-safe.
- */
-
-GByteArray* g_byte_array_new              (void);
-GByteArray* g_byte_array_sized_new        (guint        reserved_size);
-guint8*            g_byte_array_free              (GByteArray   *array,
-                                           gboolean      free_segment);
-GByteArray* g_byte_array_append                   (GByteArray   *array,
-                                           const guint8 *data,
-                                           guint         len);
-GByteArray* g_byte_array_prepend           (GByteArray  *array,
-                                           const guint8 *data,
-                                           guint         len);
-GByteArray* g_byte_array_set_size          (GByteArray  *array,
-                                           guint         length);
-GByteArray* g_byte_array_remove_index     (GByteArray   *array,
-                                           guint         index);
-GByteArray* g_byte_array_remove_index_fast (GByteArray  *array,
-                                           guint         index);
-
-
-/* Hash Functions
- */
-gboolean g_str_equal (gconstpointer   v,
-                     gconstpointer   v2);
-guint   g_str_hash  (gconstpointer   v);
-
-gint    g_int_equal (gconstpointer   v,
-                     gconstpointer   v2) G_GNUC_CONST;
-guint   g_int_hash  (gconstpointer   v) G_GNUC_CONST;
-
-/* This "hash" function will just return the key's adress as an
- * unsigned integer. Useful for hashing on plain adresses or
- * simple integer values.
- * passing NULL into g_hash_table_new() as GHashFunc has the
- * same effect as passing g_direct_hash().
- */
-guint g_direct_hash  (gconstpointer v) G_GNUC_CONST;
-gint  g_direct_equal (gconstpointer v,
-                     gconstpointer v2) G_GNUC_CONST;
-
-
-/* Quarks (string<->id association)
- */
-GQuark   g_quark_try_string            (const gchar    *string);
-GQuark   g_quark_from_static_string    (const gchar    *string);
-GQuark   g_quark_from_string           (const gchar    *string);
-gchar*   g_quark_to_string             (GQuark          quark) G_GNUC_CONST;
-
-
-/* Keyed Data List
- */
-void     g_datalist_init                (GData          **datalist);
-void     g_datalist_clear               (GData          **datalist);
-gpointer  g_datalist_id_get_data        (GData          **datalist,
-                                         GQuark           key_id);
-void     g_datalist_id_set_data_full    (GData          **datalist,
-                                         GQuark           key_id,
-                                         gpointer         data,
-                                         GDestroyNotify   destroy_func);
-gpointer  g_datalist_id_remove_no_notify (GData                 **datalist,
-                                         GQuark           key_id);
-void     g_datalist_foreach             (GData          **datalist,
-                                         GDataForeachFunc func,
-                                         gpointer         user_data);
-#define          g_datalist_id_set_data(dl, q, d)      \
-     g_datalist_id_set_data_full ((dl), (q), (d), NULL)
-#define          g_datalist_id_remove_data(dl, q)      \
-     g_datalist_id_set_data ((dl), (q), NULL)
-#define          g_datalist_get_data(dl, k)            \
-     (g_datalist_id_get_data ((dl), g_quark_try_string (k)))
-#define          g_datalist_set_data_full(dl, k, d, f) \
-     g_datalist_id_set_data_full ((dl), g_quark_from_string (k), (d), (f))
-#define          g_datalist_remove_no_notify(dl, k)    \
-     g_datalist_id_remove_no_notify ((dl), g_quark_try_string (k))
-#define          g_datalist_set_data(dl, k, d)         \
-     g_datalist_set_data_full ((dl), (k), (d), NULL)
-#define          g_datalist_remove_data(dl, k)         \
-     g_datalist_id_set_data ((dl), g_quark_try_string (k), NULL)
-
-
-/* Location Associated Keyed Data
- */
-void     g_dataset_destroy             (gconstpointer    dataset_location);
-gpointer  g_dataset_id_get_data                (gconstpointer    dataset_location,
-                                        GQuark           key_id);
-void     g_dataset_id_set_data_full    (gconstpointer    dataset_location,
-                                        GQuark           key_id,
-                                        gpointer         data,
-                                        GDestroyNotify   destroy_func);
-gpointer  g_dataset_id_remove_no_notify        (gconstpointer    dataset_location,
-                                        GQuark           key_id);
-void     g_dataset_foreach             (gconstpointer    dataset_location,
-                                        GDataForeachFunc func,
-                                        gpointer         user_data);
-#define          g_dataset_id_set_data(l, k, d)        \
-     g_dataset_id_set_data_full ((l), (k), (d), NULL)
-#define          g_dataset_id_remove_data(l, k)        \
-     g_dataset_id_set_data ((l), (k), NULL)
-#define          g_dataset_get_data(l, k)              \
-     (g_dataset_id_get_data ((l), g_quark_try_string (k)))
-#define          g_dataset_set_data_full(l, k, d, f)   \
-     g_dataset_id_set_data_full ((l), g_quark_from_string (k), (d), (f))
-#define          g_dataset_remove_no_notify(l, k)      \
-     g_dataset_id_remove_no_notify ((l), g_quark_try_string (k))
-#define          g_dataset_set_data(l, k, d)           \
-     g_dataset_set_data_full ((l), (k), (d), NULL)
-#define          g_dataset_remove_data(l, k)           \
-     g_dataset_id_set_data ((l), g_quark_try_string (k), NULL)
-
-
-/* GScanner: Flexible lexical scanner for general purpose.
- */
-
-/* Character sets */
-#define G_CSET_A_2_Z   "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
-#define G_CSET_a_2_z   "abcdefghijklmnopqrstuvwxyz"
-#define G_CSET_DIGITS  "0123456789"
-#define G_CSET_LATINC  "\300\301\302\303\304\305\306"\
-                       "\307\310\311\312\313\314\315\316\317\320"\
-                       "\321\322\323\324\325\326"\
-                       "\330\331\332\333\334\335\336"
-#define G_CSET_LATINS  "\337\340\341\342\343\344\345\346"\
-                       "\347\350\351\352\353\354\355\356\357\360"\
-                       "\361\362\363\364\365\366"\
-                       "\370\371\372\373\374\375\376\377"
-
-/* Error types */
-typedef enum
-{
-  G_ERR_UNKNOWN,
-  G_ERR_UNEXP_EOF,
-  G_ERR_UNEXP_EOF_IN_STRING,
-  G_ERR_UNEXP_EOF_IN_COMMENT,
-  G_ERR_NON_DIGIT_IN_CONST,
-  G_ERR_DIGIT_RADIX,
-  G_ERR_FLOAT_RADIX,
-  G_ERR_FLOAT_MALFORMED
-} GErrorType;
-
-/* Token types */
-typedef enum
-{
-  G_TOKEN_EOF                  =   0,
-  
-  G_TOKEN_LEFT_PAREN           = '(',
-  G_TOKEN_RIGHT_PAREN          = ')',
-  G_TOKEN_LEFT_CURLY           = '{',
-  G_TOKEN_RIGHT_CURLY          = '}',
-  G_TOKEN_LEFT_BRACE           = '[',
-  G_TOKEN_RIGHT_BRACE          = ']',
-  G_TOKEN_EQUAL_SIGN           = '=',
-  G_TOKEN_COMMA                        = ',',
-  
-  G_TOKEN_NONE                 = 256,
-  
-  G_TOKEN_ERROR,
-  
-  G_TOKEN_CHAR,
-  G_TOKEN_BINARY,
-  G_TOKEN_OCTAL,
-  G_TOKEN_INT,
-  G_TOKEN_HEX,
-  G_TOKEN_FLOAT,
-  G_TOKEN_STRING,
-  
-  G_TOKEN_SYMBOL,
-  G_TOKEN_IDENTIFIER,
-  G_TOKEN_IDENTIFIER_NULL,
-  
-  G_TOKEN_COMMENT_SINGLE,
-  G_TOKEN_COMMENT_MULTI,
-  G_TOKEN_LAST
-} GTokenType;
-
-union  _GTokenValue
-{
-  gpointer     v_symbol;
-  gchar                *v_identifier;
-  gulong       v_binary;
-  gulong       v_octal;
-  gulong       v_int;
-  gdouble      v_float;
-  gulong       v_hex;
-  gchar                *v_string;
-  gchar                *v_comment;
-  guchar       v_char;
-  guint                v_error;
-};
-
-struct _GScannerConfig
-{
-  /* Character sets
-   */
-  gchar                *cset_skip_characters;          /* default: " \t\n" */
-  gchar                *cset_identifier_first;
-  gchar                *cset_identifier_nth;
-  gchar                *cpair_comment_single;          /* default: "#\n" */
-  
-  /* Should symbol lookup work case sensitive?
-   */
-  guint                case_sensitive : 1;
-  
-  /* Boolean values to be adjusted "on the fly"
-   * to configure scanning behaviour.
-   */
-  guint                skip_comment_multi : 1;         /* C like comment */
-  guint                skip_comment_single : 1;        /* single line comment */
-  guint                scan_comment_multi : 1;         /* scan multi line comments? */
-  guint                scan_identifier : 1;
-  guint                scan_identifier_1char : 1;
-  guint                scan_identifier_NULL : 1;
-  guint                scan_symbols : 1;
-  guint                scan_binary : 1;
-  guint                scan_octal : 1;
-  guint                scan_float : 1;
-  guint                scan_hex : 1;                   /* `0x0ff0' */
-  guint                scan_hex_dollar : 1;            /* `$0ff0' */
-  guint                scan_string_sq : 1;             /* string: 'anything' */
-  guint                scan_string_dq : 1;             /* string: "\\-escapes!\n" */
-  guint                numbers_2_int : 1;              /* bin, octal, hex => int */
-  guint                int_2_float : 1;                /* int => G_TOKEN_FLOAT? */
-  guint                identifier_2_string : 1;
-  guint                char_2_token : 1;               /* return G_TOKEN_CHAR? */
-  guint                symbol_2_token : 1;
-  guint                scope_0_fallback : 1;           /* try scope 0 on lookups? */
-};
-
-struct _GScanner
-{
-  /* unused fields */
-  gpointer             user_data;
-  guint                        max_parse_errors;
-  
-  /* g_scanner_error() increments this field */
-  guint                        parse_errors;
-  
-  /* name of input stream, featured by the default message handler */
-  const gchar          *input_name;
-  
-  /* data pointer for derived structures */
-  gpointer             derived_data;
-  
-  /* link into the scanner configuration */
-  GScannerConfig       *config;
-  
-  /* fields filled in after g_scanner_get_next_token() */
-  GTokenType           token;
-  GTokenValue          value;
-  guint                        line;
-  guint                        position;
-  
-  /* fields filled in after g_scanner_peek_next_token() */
-  GTokenType           next_token;
-  GTokenValue          next_value;
-  guint                        next_line;
-  guint                        next_position;
-  
-  /* to be considered private */
-  GHashTable           *symbol_table;
-  gint                 input_fd;
-  const gchar          *text;
-  const gchar          *text_end;
-  gchar                        *buffer;
-  guint                        scope_id;
-  
-  /* handler function for _warn and _error */
-  GScannerMsgFunc      msg_handler;
-};
-
-GScanner*      g_scanner_new                   (GScannerConfig *config_templ);
-void           g_scanner_destroy               (GScanner       *scanner);
-void           g_scanner_input_file            (GScanner       *scanner,
-                                                gint           input_fd);
-void           g_scanner_sync_file_offset      (GScanner       *scanner);
-void           g_scanner_input_text            (GScanner       *scanner,
-                                                const  gchar   *text,
-                                                guint          text_len);
-GTokenType     g_scanner_get_next_token        (GScanner       *scanner);
-GTokenType     g_scanner_peek_next_token       (GScanner       *scanner);
-GTokenType     g_scanner_cur_token             (GScanner       *scanner);
-GTokenValue    g_scanner_cur_value             (GScanner       *scanner);
-guint          g_scanner_cur_line              (GScanner       *scanner);
-guint          g_scanner_cur_position          (GScanner       *scanner);
-gboolean       g_scanner_eof                   (GScanner       *scanner);
-guint          g_scanner_set_scope             (GScanner       *scanner,
-                                                guint           scope_id);
-void           g_scanner_scope_add_symbol      (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol,
-                                                gpointer       value);
-void           g_scanner_scope_remove_symbol   (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol);
-gpointer       g_scanner_scope_lookup_symbol   (GScanner       *scanner,
-                                                guint           scope_id,
-                                                const gchar    *symbol);
-void           g_scanner_scope_foreach_symbol  (GScanner       *scanner,
-                                                guint           scope_id,
-                                                GHFunc          func,
-                                                gpointer        user_data);
-gpointer       g_scanner_lookup_symbol         (GScanner       *scanner,
-                                                const gchar    *symbol);
-void           g_scanner_unexp_token           (GScanner       *scanner,
-                                                GTokenType     expected_token,
-                                                const gchar    *identifier_spec,
-                                                const gchar    *symbol_spec,
-                                                const gchar    *symbol_name,
-                                                const gchar    *message,
-                                                gint            is_error);
-void           g_scanner_error                 (GScanner       *scanner,
-                                                const gchar    *format,
-                                                ...) G_GNUC_PRINTF (2,3);
-void           g_scanner_warn                  (GScanner       *scanner,
-                                                const gchar    *format,
-                                                ...) G_GNUC_PRINTF (2,3);
-gint           g_scanner_stat_mode             (const gchar    *filename);
-/* keep downward source compatibility */
-#define                g_scanner_add_symbol( scanner, symbol, value )  G_STMT_START { \
-  g_scanner_scope_add_symbol ((scanner), 0, (symbol), (value)); \
-} G_STMT_END
-#define                g_scanner_remove_symbol( scanner, symbol )      G_STMT_START { \
-  g_scanner_scope_remove_symbol ((scanner), 0, (symbol)); \
-} G_STMT_END
-#define                g_scanner_foreach_symbol( scanner, func, data ) G_STMT_START { \
-  g_scanner_scope_foreach_symbol ((scanner), 0, (func), (data)); \
-} G_STMT_END
-
-/* The following two functions are deprecated and will be removed in
- * the next major release. They do no good. */
-void           g_scanner_freeze_symbol_table   (GScanner       *scanner);
-void           g_scanner_thaw_symbol_table     (GScanner       *scanner);
-
-/* GCompletion
- */
-
-struct _GCompletion
-{
-  GList* items;
-  GCompletionFunc func;
-  
-  gchar* prefix;
-  GList* cache;
-};
-
-GCompletion* g_completion_new         (GCompletionFunc func);
-void        g_completion_add_items    (GCompletion*    cmp,
-                                       GList*          items);
-void        g_completion_remove_items (GCompletion*    cmp,
-                                       GList*          items);
-void        g_completion_clear_items  (GCompletion*    cmp);
-GList*      g_completion_complete     (GCompletion*    cmp,
-                                       gchar*          prefix,
-                                       gchar**         new_prefix);
-void        g_completion_free         (GCompletion*    cmp);
-
-
-/* GDate
- *
- * Date calculations (not time for now, to be resolved). These are a
- * mutant combination of Steffen Beyer's DateCalc routines
- * (http://www.perl.com/CPAN/authors/id/STBEY/) and Jon Trowbridge's
- * date routines (written for in-house software).  Written by Havoc
- * Pennington <hp@pobox.com> 
- */
-
-typedef guint16 GDateYear;
-typedef guint8  GDateDay;   /* day of the month */
-typedef struct _GDate GDate;
-/* make struct tm known without having to include time.h */
-struct tm;
-
-/* enum used to specify order of appearance in parsed date strings */
-typedef enum
-{
-  G_DATE_DAY   = 0,
-  G_DATE_MONTH = 1,
-  G_DATE_YEAR  = 2
-} GDateDMY;
-
-/* actual week and month values */
-typedef enum
-{
-  G_DATE_BAD_WEEKDAY  = 0,
-  G_DATE_MONDAY       = 1,
-  G_DATE_TUESDAY      = 2,
-  G_DATE_WEDNESDAY    = 3,
-  G_DATE_THURSDAY     = 4,
-  G_DATE_FRIDAY       = 5,
-  G_DATE_SATURDAY     = 6,
-  G_DATE_SUNDAY       = 7
-} GDateWeekday;
-typedef enum
-{
-  G_DATE_BAD_MONTH = 0,
-  G_DATE_JANUARY   = 1,
-  G_DATE_FEBRUARY  = 2,
-  G_DATE_MARCH     = 3,
-  G_DATE_APRIL     = 4,
-  G_DATE_MAY       = 5,
-  G_DATE_JUNE      = 6,
-  G_DATE_JULY      = 7,
-  G_DATE_AUGUST    = 8,
-  G_DATE_SEPTEMBER = 9,
-  G_DATE_OCTOBER   = 10,
-  G_DATE_NOVEMBER  = 11,
-  G_DATE_DECEMBER  = 12
-} GDateMonth;
-
-#define G_DATE_BAD_JULIAN 0U
-#define G_DATE_BAD_DAY    0U
-#define G_DATE_BAD_YEAR   0U
-
-/* Note: directly manipulating structs is generally a bad idea, but
- * in this case it's an *incredibly* bad idea, because all or part
- * of this struct can be invalid at any given time. Use the functions,
- * or you will get hosed, I promise.
- */
-struct _GDate
-{ 
-  guint julian_days : 32; /* julian days representation - we use a
-                           *  bitfield hoping that 64 bit platforms
-                           *  will pack this whole struct in one big
-                           *  int 
-                           */
-
-  guint julian : 1;    /* julian is valid */
-  guint dmy    : 1;    /* dmy is valid */
-
-  /* DMY representation */
-  guint day    : 6;  
-  guint month  : 4; 
-  guint year   : 16; 
-};
-
-/* g_date_new() returns an invalid date, you then have to _set() stuff 
- * to get a usable object. You can also allocate a GDate statically,
- * then call g_date_clear() to initialize.
- */
-GDate*       g_date_new                   (void);
-GDate*       g_date_new_dmy               (GDateDay     day, 
-                                           GDateMonth   month, 
-                                           GDateYear    year);
-GDate*       g_date_new_julian            (guint32      julian_day);
-void         g_date_free                  (GDate       *date);
-
-/* check g_date_valid() after doing an operation that might fail, like
- * _parse.  Almost all g_date operations are undefined on invalid
- * dates (the exceptions are the mutators, since you need those to
- * return to validity).  
- */
-gboolean     g_date_valid                 (GDate       *date);
-gboolean     g_date_valid_day             (GDateDay     day) G_GNUC_CONST;
-gboolean     g_date_valid_month           (GDateMonth month) G_GNUC_CONST;
-gboolean     g_date_valid_year            (GDateYear  year) G_GNUC_CONST;
-gboolean     g_date_valid_weekday         (GDateWeekday weekday) G_GNUC_CONST;
-gboolean     g_date_valid_julian          (guint32 julian_date) G_GNUC_CONST;
-gboolean     g_date_valid_dmy             (GDateDay     day,
-                                           GDateMonth   month,
-                                           GDateYear    year) G_GNUC_CONST;
-
-GDateWeekday g_date_weekday               (GDate       *date);
-GDateMonth   g_date_month                 (GDate       *date);
-GDateYear    g_date_year                  (GDate       *date);
-GDateDay     g_date_day                   (GDate       *date);
-guint32      g_date_julian                (GDate       *date);
-guint        g_date_day_of_year           (GDate       *date);
-
-/* First monday/sunday is the start of week 1; if we haven't reached
- * that day, return 0. These are not ISO weeks of the year; that
- * routine needs to be added.
- * these functions return the number of weeks, starting on the
- * corrsponding day
- */
-guint        g_date_monday_week_of_year   (GDate      *date);
-guint        g_date_sunday_week_of_year   (GDate      *date);
-
-/* If you create a static date struct you need to clear it to get it
- * in a sane state before use. You can clear a whole array at
- * once with the ndates argument.
- */
-void         g_date_clear                 (GDate       *date, 
-                                           guint        n_dates);
-
-/* The parse routine is meant for dates typed in by a user, so it
- * permits many formats but tries to catch common typos. If your data
- * needs to be strictly validated, it is not an appropriate function.
- */
-void         g_date_set_parse             (GDate       *date,
-                                           const gchar *str);
-void         g_date_set_time              (GDate       *date, 
-                                           GTime        time);
-void         g_date_set_month             (GDate       *date, 
-                                           GDateMonth   month);
-void         g_date_set_day               (GDate       *date, 
-                                           GDateDay     day);
-void         g_date_set_year              (GDate       *date,
-                                           GDateYear    year);
-void         g_date_set_dmy               (GDate       *date,
-                                           GDateDay     day,
-                                           GDateMonth   month,
-                                           GDateYear    y);
-void         g_date_set_julian            (GDate       *date,
-                                           guint32      julian_date);
-gboolean     g_date_is_first_of_month     (GDate       *date);
-gboolean     g_date_is_last_of_month      (GDate       *date);
-
-/* To go forward by some number of weeks just go forward weeks*7 days */
-void         g_date_add_days              (GDate       *date, 
-                                           guint        n_days);
-void         g_date_subtract_days         (GDate       *date, 
-                                           guint        n_days);
-
-/* If you add/sub months while day > 28, the day might change */
-void         g_date_add_months            (GDate       *date,
-                                           guint        n_months);
-void         g_date_subtract_months       (GDate       *date,
-                                           guint        n_months);
-
-/* If it's feb 29, changing years can move you to the 28th */
-void         g_date_add_years             (GDate       *date,
-                                           guint        n_years);
-void         g_date_subtract_years        (GDate       *date,
-                                           guint        n_years);
-gboolean     g_date_is_leap_year          (GDateYear    year) G_GNUC_CONST;
-guint8       g_date_days_in_month         (GDateMonth   month, 
-                                           GDateYear    year) G_GNUC_CONST;
-guint8       g_date_monday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
-guint8       g_date_sunday_weeks_in_year  (GDateYear    year) G_GNUC_CONST;
-
-/* qsort-friendly (with a cast...) */
-gint         g_date_compare               (GDate       *lhs,
-                                           GDate       *rhs);
-void         g_date_to_struct_tm          (GDate       *date,
-                                           struct tm   *tm);
-
-/* Just like strftime() except you can only use date-related formats.
- *   Using a time format is undefined.
- */
-gsize        g_date_strftime              (gchar       *s,
-                                           gsize        slen,
-                                           const gchar *format,
-                                           GDate       *date);
-
-
-/* GRelation
- *
- * Indexed Relations.  Imagine a really simple table in a
- * database.  Relations are not ordered.  This data type is meant for
- * maintaining a N-way mapping.
- *
- * g_relation_new() creates a relation with FIELDS fields
- *
- * g_relation_destroy() frees all resources
- * g_tuples_destroy() frees the result of g_relation_select()
- *
- * g_relation_index() indexes relation FIELD with the provided
- *   equality and hash functions.  this must be done before any
- *   calls to insert are made.
- *
- * g_relation_insert() inserts a new tuple.  you are expected to
- *   provide the right number of fields.
- *
- * g_relation_delete() deletes all relations with KEY in FIELD
- * g_relation_select() returns ...
- * g_relation_count() counts ...
- */
-
-GRelation* g_relation_new     (gint        fields);
-void      g_relation_destroy (GRelation   *relation);
-void      g_relation_index   (GRelation   *relation,
-                              gint         field,
-                              GHashFunc    hash_func,
-                              GCompareFunc key_compare_func);
-void      g_relation_insert  (GRelation   *relation,
-                              ...);
-gint      g_relation_delete  (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-GTuples*   g_relation_select  (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-gint      g_relation_count   (GRelation   *relation,
-                              gconstpointer  key,
-                              gint         field);
-gboolean   g_relation_exists  (GRelation   *relation,
-                              ...);
-void      g_relation_print   (GRelation   *relation);
-
-void      g_tuples_destroy   (GTuples     *tuples);
-gpointer   g_tuples_index     (GTuples    *tuples,
-                              gint         index,
-                              gint         field);
-
-
-/* GRand - a good and fast random number generator: Mersenne Twister 
- * see http://www.math.keio.ac.jp/~matumoto/emt.html for more info.
- * The range functions return a value in the intervall [min,max).
- * int          -> [0..2^32-1]
- * int_range    -> [min..max-1]
- * double       -> [0..1)
- * double_range -> [min..max)
- */
-
-GRand*  g_rand_new_with_seed   (guint32     seed);
-GRand*  g_rand_new             (void);
-void    g_rand_free            (GRand      *rand);
-
-void    g_rand_set_seed        (GRand      *rand, 
-                               guint32     seed);
-guint32 g_rand_int             (GRand      *rand);
-gint32  g_rand_int_range       (GRand      *rand, 
-                               gint32      min, 
-                               gint32      max);
-gdouble g_rand_double          (GRand      *rand);
-gdouble g_rand_double_range    (GRand      *rand, 
-                               gdouble     min, 
-                               gdouble     max);
-
-void    g_random_set_seed      (guint32     seed);
-guint32 g_random_int           (void);
-gint32  g_random_int_range     (gint32      min, 
-                               gint32      max);
-gdouble g_random_double        (void);
-gdouble g_random_double_range  (gdouble     min, 
-                               gdouble     max);
-
-/* Prime numbers.
- */
-
-/* This function returns prime numbers spaced by approximately 1.5-2.0
- * and is for use in resizing data structures which prefer
- * prime-valued sizes. The closest spaced prime function returns the
- * next largest prime, or the highest it knows about which is about
- * MAXINT/4.
- */
-guint     g_spaced_primes_closest (guint num) G_GNUC_CONST;
-
-
-/* GIOChannel
- */
-
-typedef struct _GIOFuncs GIOFuncs;
-typedef enum
-{
-  G_IO_ERROR_NONE,
-  G_IO_ERROR_AGAIN,
-  G_IO_ERROR_INVAL,
-  G_IO_ERROR_UNKNOWN
-} GIOError;
-typedef enum
-{
-  G_SEEK_CUR,
-  G_SEEK_SET,
-  G_SEEK_END
-} GSeekType;
-typedef enum
-{
-  G_IO_IN      GLIB_SYSDEF_POLLIN,
-  G_IO_OUT     GLIB_SYSDEF_POLLOUT,
-  G_IO_PRI     GLIB_SYSDEF_POLLPRI,
-  G_IO_ERR     GLIB_SYSDEF_POLLERR,
-  G_IO_HUP     GLIB_SYSDEF_POLLHUP,
-  G_IO_NVAL    GLIB_SYSDEF_POLLNVAL
-} GIOCondition;
-
-struct _GIOChannel
-{
-  guint channel_flags;
-  guint ref_count;
-  GIOFuncs *funcs;
-};
-
-typedef gboolean (*GIOFunc) (GIOChannel   *source,
-                            GIOCondition  condition,
-                            gpointer      data);
-struct _GIOFuncs
-{
-  GIOError (*io_read)   (GIOChannel    *channel, 
-                        gchar          *buf, 
-                        guint           count,
-                        guint          *bytes_read);
-  GIOError (*io_write)  (GIOChannel    *channel, 
-                        gchar          *buf, 
-                        guint           count,
-                        guint          *bytes_written);
-  GIOError (*io_seek)   (GIOChannel    *channel, 
-                        gint            offset, 
-                        GSeekType       type);
-  void (*io_close)      (GIOChannel    *channel);
-  guint (*io_add_watch) (GIOChannel     *channel,
-                        gint            priority,
-                        GIOCondition    condition,
-                        GIOFunc         func,
-                        gpointer        user_data,
-                        GDestroyNotify  notify);
-  void (*io_free)       (GIOChannel    *channel);
-};
-
-void        g_io_channel_init   (GIOChannel    *channel);
-void        g_io_channel_ref    (GIOChannel    *channel);
-void        g_io_channel_unref  (GIOChannel    *channel);
-GIOError    g_io_channel_read   (GIOChannel    *channel, 
-                                gchar         *buf, 
-                                guint          count,
-                                guint         *bytes_read);
-GIOError  g_io_channel_write    (GIOChannel    *channel, 
-                                gchar         *buf, 
-                                guint          count,
-                                guint         *bytes_written);
-GIOError  g_io_channel_seek     (GIOChannel    *channel,
-                                gint           offset, 
-                                GSeekType      type);
-void      g_io_channel_close    (GIOChannel    *channel);
-guint     g_io_add_watch_full   (GIOChannel    *channel,
-                                gint           priority,
-                                GIOCondition   condition,
-                                GIOFunc        func,
-                                gpointer       user_data,
-                                GDestroyNotify notify);
-guint    g_io_add_watch         (GIOChannel    *channel,
-                                GIOCondition   condition,
-                                GIOFunc        func,
-                                gpointer       user_data);
-
-
-/* Main loop
- */
-typedef struct _GTimeVal       GTimeVal;
-typedef struct _GSourceFuncs   GSourceFuncs;
-typedef struct _GMainLoop      GMainLoop;      /* Opaque */
-
-struct _GTimeVal
-{
-  glong tv_sec;
-  glong tv_usec;
-};
-struct _GSourceFuncs
-{
-  gboolean (*prepare)  (gpointer  source_data, 
-                       GTimeVal *current_time,
-                       gint     *timeout,
-                       gpointer  user_data);
-  gboolean (*check)    (gpointer  source_data,
-                       GTimeVal *current_time,
-                       gpointer  user_data);
-  gboolean (*dispatch) (gpointer  source_data, 
-                       GTimeVal *dispatch_time,
-                       gpointer  user_data);
-  GDestroyNotify destroy;
-};
-
-/* Standard priorities */
-
-#define G_PRIORITY_HIGH            -100
-#define G_PRIORITY_DEFAULT          0
-#define G_PRIORITY_HIGH_IDLE        100
-#define G_PRIORITY_DEFAULT_IDLE     200
-#define G_PRIORITY_LOW             300
-
-typedef gboolean (*GSourceFunc) (gpointer data);
-
-/* Hooks for adding to the main loop */
-guint    g_source_add                        (gint           priority, 
-                                             gboolean       can_recurse,
-                                             GSourceFuncs  *funcs,
-                                             gpointer       source_data, 
-                                             gpointer       user_data,
-                                             GDestroyNotify notify);
-gboolean g_source_remove                     (guint          tag);
-gboolean g_source_remove_by_user_data        (gpointer       user_data);
-gboolean g_source_remove_by_source_data      (gpointer       source_data);
-gboolean g_source_remove_by_funcs_user_data  (GSourceFuncs  *funcs,
-                                             gpointer       user_data);
-
-void g_get_current_time                        (GTimeVal       *result);
-
-/* Running the main loop */
-GMainLoop*     g_main_new              (gboolean        is_running);
-void           g_main_run              (GMainLoop      *loop);
-void           g_main_quit             (GMainLoop      *loop);
-void           g_main_destroy          (GMainLoop      *loop);
-gboolean       g_main_is_running       (GMainLoop      *loop);
-
-/* Run a single iteration of the mainloop. If block is FALSE,
- * will never block
- */
-gboolean       g_main_iteration        (gboolean       may_block);
-
-/* See if any events are pending */
-gboolean       g_main_pending          (void);
-
-/* Idles and timeouts */
-guint          g_timeout_add_full      (gint           priority,
-                                        guint          interval, 
-                                        GSourceFunc    function,
-                                        gpointer       data,
-                                        GDestroyNotify notify);
-guint          g_timeout_add           (guint          interval,
-                                        GSourceFunc    function,
-                                        gpointer       data);
-guint          g_idle_add              (GSourceFunc    function,
-                                        gpointer       data);
-guint          g_idle_add_full         (gint           priority,
-                                        GSourceFunc    function,
-                                        gpointer       data,
-                                        GDestroyNotify destroy);
-gboolean       g_idle_remove_by_data   (gpointer       data);
-
-/* GPollFD
- *
- * System-specific IO and main loop calls
- *
- * On Win32, the fd in a GPollFD should be Win32 HANDLE (*not* a file
- * descriptor as provided by the C runtime) that can be used by
- * MsgWaitForMultipleObjects. This does *not* include file handles
- * from CreateFile, SOCKETs, nor pipe handles. (But you can use
- * WSAEventSelect to signal events when a SOCKET is readable).
- *
- * On Win32, fd can also be the special value G_WIN32_MSG_HANDLE to
- * indicate polling for messages. These message queue GPollFDs should
- * be added with the g_main_poll_win32_msg_add function.
- *
- * But note that G_WIN32_MSG_HANDLE GPollFDs should not be used by GDK
- * (GTK) programs, as GDK itself wants to read messages and convert them
- * to GDK events.
- *
- * So, unless you really know what you are doing, it's best not to try
- * to use the main loop polling stuff for your own needs on
- * Win32. It's really only written for the GIMP's needs so
- * far.
- */
-
-typedef struct _GPollFD GPollFD;
-typedef gint   (*GPollFunc)    (GPollFD *ufds,
-                                guint    nfsd,
-                                gint     timeout);
-struct _GPollFD
-{
-  gint         fd;
-  gushort      events;
-  gushort      revents;
-};
-
-void        g_main_add_poll          (GPollFD    *fd,
-                                     gint        priority);
-void        g_main_remove_poll       (GPollFD    *fd);
-void        g_main_set_poll_func     (GPollFunc   func);
-
-#ifdef G_OS_WIN32
-
-/* Useful on other platforms, too? */
-
-GPollFunc   g_main_win32_get_poll_func (void);
-
-#endif
-
-/* On Unix, IO channels created with this function for any file
- * descriptor or socket.
- *
- * On Win32, use this only for files opened with the MSVCRT (the
- * Microsoft run-time C library) _open() or _pipe, including file
- * descriptors 0, 1 and 2 (corresponding to stdin, stdout and stderr).
- *
- * The term file descriptor as used in the context of Win32 refers to
- * the emulated Unix-like file descriptors MSVCRT provides. The native
- * corresponding concept is file HANDLE. There isn't as of yet a way to
- * get GIOChannels for file HANDLEs.
- */
-GIOChannel* g_io_channel_unix_new    (int         fd);
-gint        g_io_channel_unix_get_fd (GIOChannel *channel);
-
-#ifdef G_OS_WIN32
-
-#define G_WIN32_MSG_HANDLE 19981206
-
-/* Use this to get a GPollFD from a GIOChannel, so that you can call
- * g_io_channel_win32_poll(). After calling this you should only use
- * g_io_channel_read() to read from the GIOChannel, i.e. never read()
- * or recv() from the underlying file descriptor or SOCKET.
- */
-void        g_io_channel_win32_make_pollfd (GIOChannel   *channel,
-                                           GIOCondition  condition,
-                                           GPollFD      *fd);
-
-/* This can be used to wait a until at least one of the channels is readable.
- * On Unix you would do a select() on the file descriptors of the channels.
- * This should probably be available for all platforms?
- */
-gint        g_io_channel_win32_poll   (GPollFD    *fds,
-                                      gint        n_fds,
-                                      gint        timeout);
-
-/* This is used to add polling for Windows messages. GDK (GTk+) programs
- * should *not* use this.
- */
-void        g_main_poll_win32_msg_add (gint        priority,
-                                      GPollFD    *fd,
-                                      guint       hwnd);
-
-/* An IO channel for Windows messages for window handle hwnd. */
-GIOChannel *g_io_channel_win32_new_messages (guint hwnd);
-
-/* An IO channel for C runtime (emulated Unix-like) file
- * descriptors. Identical to g_io_channel_unix_new above.
- * After calling g_io_add_watch() on a IO channel returned
- * by this function, you shouldn't call read() on the file
- * descriptor.
- */
-GIOChannel* g_io_channel_win32_new_fd (int         fd);
-
-/* Get the C runtime file descriptor of a channel. */
-gint        g_io_channel_win32_get_fd (GIOChannel *channel);
-
-/* An IO channel for a SOCK_STREAM winsock socket. The parameter
- * should be a SOCKET. After calling g_io_add_watch() on a IO channel
- * returned by this function, you shouldn't call recv() on the SOCKET.
- */
-GIOChannel *g_io_channel_win32_new_stream_socket (int socket);
-
-#endif
-
-/* Windows emulation stubs for common Unix functions
- */
-#ifdef G_OS_WIN32
-#  define MAXPATHLEN 1024
-
-#ifdef _MSC_VER
-typedef int pid_t;
-#endif
-
-/*
- * To get prototypes for the following POSIXish functions, you have to
- * include the indicated non-POSIX headers. The functions are defined
- * in OLDNAMES.LIB (MSVC) or -lmoldname-msvc (mingw32).
- *
- * getcwd: <direct.h> (MSVC), <io.h> (mingw32)
- * getpid: <process.h>
- * access: <io.h>
- * unlink: <stdio.h> or <io.h>
- * open, read, write, lseek, close: <io.h>
- * rmdir: <direct.h>
- * pipe: <direct.h>
- */
-
-/* pipe is not in OLDNAMES.LIB or -lmoldname-msvc. */
-#define pipe(phandles) _pipe (phandles, 4096, _O_BINARY)
-
-/* For some POSIX functions that are not provided by the MS runtime,
- * we provide emulators in glib, which are prefixed with g_win32_.
- */
-#    define ftruncate(fd, size)        g_win32_ftruncate (fd, size)
-
-/* -lmingw32 also has emulations for these, but we need our own
- * for MSVC anyhow, so we might aswell use them always.
- */
-#    define opendir            g_win32_opendir
-#    define readdir            g_win32_readdir
-#    define rewinddir          g_win32_rewinddir
-#    define closedir           g_win32_closedir
-#    define NAME_MAX 255
-
-struct dirent
-{
-  gchar  d_name[NAME_MAX + 1];
-};
-
-struct DIR
-{
-  gchar        *dir_name;
-  gboolean     just_opened;
-  guint        find_file_handle;
-  gpointer     find_file_data;
-  struct dirent readdir_result;
-};
-typedef struct DIR DIR;
-
-/* emulation functions */
-extern int     g_win32_ftruncate       (gint            f,
-                                        guint           size);
-DIR*           g_win32_opendir         (const gchar    *dirname);
-struct dirent* g_win32_readdir         (DIR            *dir);
-void           g_win32_rewinddir       (DIR            *dir);
-gint           g_win32_closedir        (DIR            *dir);
-
-/* The MS setlocale uses locale names of the form "English_United
- * States.1252" etc. We want the Unixish standard form "en", "zh_TW"
- * etc. This function gets the current thread locale from Windows and
- * returns it as a string of the above form for use in forming file
- * names etc. The returned string should be deallocated with g_free().
- */
-gchar *                g_win32_getlocale  (void);
-
-/* Translate a Win32 error code (as returned by GetLastError()) into
- * the corresponding message. The returned string should be deallocated
- * with g_free().
- */
-gchar *         g_win32_error_message (gint error);
-
-#endif  /* G_OS_WIN32 */
-
-
-/* GLib Thread support
- */
-
-extern GQuark g_thread_error_quark();
-#define G_THREAD_ERROR g_thread_error_quark()
-
-typedef enum
-{
-  G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */
-} GThreadError;
-
-typedef void           (*GThreadFunc)          (gpointer       value);
-
-typedef enum
-{
-  G_THREAD_PRIORITY_LOW,
-  G_THREAD_PRIORITY_NORMAL,
-  G_THREAD_PRIORITY_HIGH,
-  G_THREAD_PRIORITY_URGENT
-} GThreadPriority;
-
-typedef struct _GThread         GThread;
-struct  _GThread
-{
-  GThreadPriority priority;
-  gboolean bound;
-  gboolean joinable;
-};
-
-typedef struct _GMutex         GMutex;
-typedef struct _GCond          GCond;
-typedef struct _GPrivate       GPrivate;
-typedef struct _GStaticPrivate GStaticPrivate;
-typedef struct _GAsyncQueue    GAsyncQueue;
-typedef struct _GThreadPool     GThreadPool;
-
-typedef struct _GThreadFunctions GThreadFunctions;
-struct _GThreadFunctions
-{
-  GMutex*  (*mutex_new)           (void);
-  void     (*mutex_lock)          (GMutex              *mutex);
-  gboolean (*mutex_trylock)       (GMutex              *mutex);
-  void     (*mutex_unlock)        (GMutex              *mutex);
-  void     (*mutex_free)          (GMutex              *mutex);
-  GCond*   (*cond_new)            (void);
-  void     (*cond_signal)         (GCond               *cond);
-  void     (*cond_broadcast)      (GCond               *cond);
-  void     (*cond_wait)           (GCond               *cond,
-                                  GMutex               *mutex);
-  gboolean (*cond_timed_wait)     (GCond               *cond,
-                                  GMutex               *mutex, 
-                                  GTimeVal             *end_time);
-  void      (*cond_free)          (GCond               *cond);
-  GPrivate* (*private_new)        (GDestroyNotify       destructor);
-  gpointer  (*private_get)        (GPrivate            *private_key);
-  void      (*private_set)        (GPrivate            *private_key,
-                                  gpointer              data);
-  void      (*thread_create)      (GThreadFunc                  thread_func,
-                                  gpointer              arg,
-                                  gulong                stack_size,
-                                  gboolean              joinable,
-                                  gboolean              bound,
-                                  GThreadPriority       priority,
-                                  gpointer              thread,
-                                  GError              **error);
-  void      (*thread_yield)       (void);
-  void      (*thread_join)        (gpointer             thread);
-  void      (*thread_exit)        (void);
-  void      (*thread_set_priority)(gpointer             thread, 
-                                  GThreadPriority       priority);
-  void      (*thread_self)        (gpointer              thread);
-};
-
-GLIB_VAR GThreadFunctions      g_thread_functions_for_glib_use;
-GLIB_VAR gboolean              g_thread_use_default_impl;
-GLIB_VAR gboolean              g_threads_got_initialized;
-
-/* initializes the mutex/cond/private implementation for glib, might
- * only be called once, and must not be called directly or indirectly
- * from another glib-function, e.g. as a callback.
- */
-void   g_thread_init   (GThreadFunctions       *vtable);
-
-/* Errorcheck mutexes. If you define G_ERRORCHECK_MUTEXES, then all
- * mutexes will check for re-locking and re-unlocking */
-
-/* Initialize thread system with errorcheck mutexes. vtable must be
- * NULL.Do not call directly. Use #define G_ERRORCHECK_MUTEXES
- * instead.  
- */
-void    g_thread_init_with_errorcheck_mutexes (GThreadFunctions* vtable);
-
-/* A random number to recognize debug calls to g_mutex_... */
-#define G_MUTEX_DEBUG_MAGIC 0xf8e18ad7
-
-#ifdef G_ERRORCHECK_MUTEXES
-#define g_thread_init(vtable) g_thread_init_with_errorcheck_mutexes (vtable) 
-#endif
-
-/* internal function for fallback static mutex implementation */
-GMutex*        g_static_mutex_get_mutex_impl   (GMutex **mutex);
-
-/* shorthands for conditional and unconditional function calls */
-#define G_THREAD_UF(op, arglist) \
-    (*g_thread_functions_for_glib_use . op) arglist
-#define G_THREAD_CF(op, fail, arg) \
-    (g_thread_supported () ? G_THREAD_UF (op, arg) : (fail))
-#define G_THREAD_ECF(op, fail, mutex, name, type)                      \
-    (g_thread_supported () ?                                           \
-     ((type(*)(GMutex*, gulong, gchar*, gchar*))                       \
-      (*g_thread_functions_for_glib_use . op))                                 \
-     (mutex, G_MUTEX_DEBUG_MAGIC, G_STRINGIFY (name),  G_STRLOC) : (fail))
-#ifndef G_ERRORCHECK_MUTEXES
-#define g_mutex_lock_with_debug_name(mutex, name)                      \
-  G_THREAD_CF (mutex_lock,     (void)0, (mutex))
-#define g_mutex_trylock_with_debug_name(mutex, name)                   \
-   G_THREAD_CF (mutex_trylock,  TRUE,    (mutex))
-#define g_mutex_unlock_with_debug_name(mutex, name)                    \
-   G_THREAD_CF (mutex_unlock,   (void)0, (mutex))
-#else /* G_ERRORCHECK_MUTEXES */
-#define g_mutex_lock_with_debug_name(mutex, name)                      \
-  G_THREAD_ECF (mutex_lock,    (void)0, mutex, name, void)
-#define g_mutex_trylock_with_debug_name(mutex, name)                   \
-  G_THREAD_ECF (mutex_trylock, TRUE,    mutex, name, gboolean)
-#define g_mutex_unlock_with_debug_name(mutex, name)                    \
-  G_THREAD_ECF (mutex_unlock,  (void)0, mutex, name, void)
-#endif /* G_ERRORCHECK_MUTEXES */
-
-#define        g_thread_supported()    (g_threads_got_initialized)
-#define g_mutex_new()            G_THREAD_UF (mutex_new,      ())
-#define g_mutex_lock(mutex)     g_mutex_lock_with_debug_name(mutex, mutex)
-#define g_mutex_trylock(mutex)   g_mutex_trylock_with_debug_name(mutex, mutex)
-#define g_mutex_unlock(mutex)    g_mutex_unlock_with_debug_name(mutex, mutex)
-#define g_mutex_free(mutex)      G_THREAD_CF (mutex_free,     (void)0, (mutex))
-#define g_cond_new()             G_THREAD_UF (cond_new,       ())
-#define g_cond_signal(cond)      G_THREAD_CF (cond_signal,    (void)0, (cond))
-#define g_cond_broadcast(cond)   G_THREAD_CF (cond_broadcast, (void)0, (cond))
-#define g_cond_wait(cond, mutex) G_THREAD_CF (cond_wait,      (void)0, (cond, \
-                                                                        mutex))
-#define g_cond_free(cond)        G_THREAD_CF (cond_free,      (void)0, (cond))
-#define g_cond_timed_wait(cond, mutex, abs_time) G_THREAD_CF (cond_timed_wait, \
-                                                              TRUE, \
-                                                              (cond, mutex, \
-                                                              abs_time))
-#define g_private_new(destructor)        G_THREAD_UF (private_new, (destructor))
-#define g_private_get(private_key)       G_THREAD_CF (private_get, \
-                                                       ((gpointer)private_key), \
-                                                       (private_key))
-#define g_private_set(private_key, value) G_THREAD_CF (private_set, \
-                                                       (void) (private_key = \
-                                                        (GPrivate*) (value)), \
-                                                       (private_key, value))
-#define g_thread_yield()              G_THREAD_CF (thread_yield, (void)0, ())
-#define g_thread_exit()               G_THREAD_CF (thread_exit, (void)0, ())
-
-GThread* g_thread_create (GThreadFunc           thread_func,
-                         gpointer               arg,
-                         gulong                 stack_size,
-                         gboolean               joinable,
-                         gboolean               bound,
-                         GThreadPriority        priority,
-                         GError               **error);
-GThread* g_thread_self ();
-void g_thread_join (GThread *thread);
-void g_thread_set_priority (GThread         *thread, 
-                           GThreadPriority  priority);
-
-/* GStaticMutexes can be statically initialized with the value
- * G_STATIC_MUTEX_INIT, and then they can directly be used, that is
- * much easier, than having to explicitly allocate the mutex before
- * use
- */
-#define g_static_mutex_lock(mutex) \
-    g_mutex_lock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
-#define g_static_mutex_trylock(mutex) \
-    g_mutex_trylock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
-#define g_static_mutex_unlock(mutex) \
-    g_mutex_unlock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex) 
-
-struct _GStaticPrivate
-{
-  guint index;
-};
-#define G_STATIC_PRIVATE_INIT { 0 }
-gpointer g_static_private_get (GStaticPrivate  *private_key);
-void     g_static_private_set (GStaticPrivate  *private_key, 
-                              gpointer          data,
-                              GDestroyNotify    notify);
-gpointer g_static_private_get_for_thread (GStaticPrivate *private_key,
-                                         GThread        *thread);
-void g_static_private_set_for_thread (GStaticPrivate *private_key, 
-                                     GThread        *thread,
-                                     gpointer        data,
-                                     GDestroyNotify  notify);
-
-typedef struct _GStaticRecMutex GStaticRecMutex;
-struct _GStaticRecMutex
-{
-  GStaticMutex mutex;
-  unsigned int depth;
-  GSystemThread owner;
-};
-
-#define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
-void     g_static_rec_mutex_lock        (GStaticRecMutex *mutex);
-gboolean g_static_rec_mutex_trylock     (GStaticRecMutex *mutex);
-void     g_static_rec_mutex_unlock      (GStaticRecMutex *mutex);
-void     g_static_rec_mutex_lock_full   (GStaticRecMutex *mutex,
-                                        guint            depth);
-guint    g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex);
-
-typedef struct _GStaticRWLock GStaticRWLock;
-struct _GStaticRWLock
-{
-  GStaticMutex mutex; 
-  GCond *read_cond;
-  GCond *write_cond;
-  guint read_counter;
-  gboolean write;
-  guint want_to_write;
-};
-
-#define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, FALSE }
-
-void      g_static_rw_lock_reader_lock    (GStaticRWLock* lock);
-gboolean  g_static_rw_lock_reader_trylock (GStaticRWLock* lock);
-void      g_static_rw_lock_reader_unlock  (GStaticRWLock* lock);
-void      g_static_rw_lock_writer_lock    (GStaticRWLock* lock);
-gboolean  g_static_rw_lock_writer_trylock (GStaticRWLock* lock);
-void      g_static_rw_lock_writer_unlock  (GStaticRWLock* lock);
-void      g_static_rw_lock_free (GStaticRWLock* lock);
-
-/* these are some convenience macros that expand to nothing if GLib
- * was configured with --disable-threads. for using StaticMutexes,
- * you define them with G_LOCK_DEFINE_STATIC (name) or G_LOCK_DEFINE (name)
- * if you need to export the mutex. With G_LOCK_EXTERN (name) you can
- * declare such an globally defined lock. name is a unique identifier
- * for the protected varibale or code portion. locking, testing and
- * unlocking of such mutexes can be done with G_LOCK(), G_UNLOCK() and
- * G_TRYLOCK() respectively.  
- */
-extern void glib_dummy_decl (void);
-#define G_LOCK_NAME(name)              g__ ## name ## _lock
-#ifdef G_THREADS_ENABLED
-#  define G_LOCK_DEFINE_STATIC(name)   static G_LOCK_DEFINE (name)
-#  define G_LOCK_DEFINE(name)          \
-    GStaticMutex G_LOCK_NAME (name) = G_STATIC_MUTEX_INIT 
-#  define G_LOCK_EXTERN(name)          extern GStaticMutex G_LOCK_NAME (name)
-
-#  ifdef G_DEBUG_LOCKS
-#    define G_LOCK(name)               G_STMT_START{             \
-        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                          \
-              "file %s: line %d (%s): locking: %s ",             \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name);                                            \
-        g_static_mutex_lock (&G_LOCK_NAME (name));                \
-     }G_STMT_END
-#    define G_UNLOCK(name)             G_STMT_START{             \
-        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                          \
-              "file %s: line %d (%s): unlocking: %s ",           \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name);                                            \
-       g_static_mutex_unlock (&G_LOCK_NAME (name));               \
-     }G_STMT_END
-#    define G_TRYLOCK(name)                                      \
-        (g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                 \
-              "file %s: line %d (%s): try locking: %s ",         \
-              __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
-               #name), g_static_mutex_trylock (&G_LOCK_NAME (name)))
-#  else         /* !G_DEBUG_LOCKS */
-#    define G_LOCK(name) g_static_mutex_lock      (&G_LOCK_NAME (name)) 
-#    define G_UNLOCK(name) g_static_mutex_unlock   (&G_LOCK_NAME (name))
-#    define G_TRYLOCK(name) g_static_mutex_trylock (&G_LOCK_NAME (name))
-#  endif /* !G_DEBUG_LOCKS */
-#else  /* !G_THREADS_ENABLED */
-#  define G_LOCK_DEFINE_STATIC(name)   extern void glib_dummy_decl (void)
-#  define G_LOCK_DEFINE(name)          extern void glib_dummy_decl (void)
-#  define G_LOCK_EXTERN(name)          extern void glib_dummy_decl (void)
-#  define G_LOCK(name)
-#  define G_UNLOCK(name)
-#  define G_TRYLOCK(name)              (TRUE)
-#endif /* !G_THREADS_ENABLED */
-
-/* Asyncronous Queues, can be used to communicate between threads
- */
-
-/* Get a new GAsyncQueue with the ref_count 1 */
-GAsyncQueue*  g_async_queue_new                (void);
-
-/* Lock and unlock an GAsyncQueue, all functions lock the queue for
- * themselves, but in certain cirumstances you want to hold the lock longer,
- * thus you lock the queue, call the *_unlocked functions and unlock it again
- */
-void          g_async_queue_lock               (GAsyncQueue *queue);
-void          g_async_queue_unlock             (GAsyncQueue *queue);
-
-/* Ref and unref the GAsyncQueue. g_async_queue_unref_unlocked makes
- * no sense, as after the unreffing the Queue might be gone and can't
- * be unlocked. So you have a function to call, if you don't hold the
- * lock (g_async_queue_unref) and one to call, when you already hold
- * the lock (g_async_queue_unref_and_unlock). After that however, you
- * don't hold the lock anymore and the Queue might in fact be
- * destroyed, if you unrefed to zero */
-void          g_async_queue_ref                (GAsyncQueue *queue);
-void          g_async_queue_ref_unlocked       (GAsyncQueue *queue);
-void          g_async_queue_unref              (GAsyncQueue *queue);
-void          g_async_queue_unref_and_unlock   (GAsyncQueue *queue);
-
-/* Push data into the async queue. Must not be NULL */
-void          g_async_queue_push               (GAsyncQueue *queue,
-                                               gpointer     data);
-void          g_async_queue_push_unlocked      (GAsyncQueue *queue,
-                                               gpointer     data);
-
-/* Pop data from the async queue, when no data is there, the thread is blocked
- * until data arrives */
-gpointer      g_async_queue_pop                (GAsyncQueue *queue);
-gpointer      g_async_queue_pop_unlocked       (GAsyncQueue *queue);
-
-/* Try to pop data, NULL is returned in case of empty queue */
-gpointer      g_async_queue_try_pop            (GAsyncQueue *queue);
-gpointer      g_async_queue_try_pop_unlocked   (GAsyncQueue *queue);
-
-/* Wait for data until at maximum until end_time is reached, NULL is returned
- * in case of empty queue*/
-gpointer      g_async_queue_timed_pop          (GAsyncQueue *queue, 
-                                               GTimeVal    *end_time);
-gpointer      g_async_queue_timed_pop_unlocked (GAsyncQueue *queue, 
-                                               GTimeVal    *end_time);
-
-/* Return the length of the queue, negative values mean, that threads
- * are waiting, positve values mean, that there are entries in the
- * queue. Actually this function returns the length of the queue minus
- * the number of waiting threads, g_async_queue_length == 0 could also
- * mean 'n' entries in the queue and 'n' thread waiting, such can
- * happen due to locking of the queue or due to scheduling. */
-gint          g_async_queue_length             (GAsyncQueue *queue);
-gint          g_async_queue_length_unlocked    (GAsyncQueue *queue);
-
-/* Thread Pools
- */
-
-/* The real GThreadPool is bigger, so you may only create a thread
- * pool with the constructor function */
-struct _GThreadPool
-{
-  GFunc thread_func;
-  gulong stack_size;
-  gboolean bound; 
-  GThreadPriority priority;
-  gboolean exclusive;
-  gpointer user_data;
-};
-
-/* Get a thread pool with the function thread_func, at most max_threads may
- * run at a time (max_threads == -1 means no limit), stack_size, bound,
- * priority like in g_thread_create, exclusive == TRUE means, that the threads
- * shouldn't be shared and that they will be prestarted (otherwise they are
- * started, as needed) user_data is the 2nd argument to the thread_func */
-GThreadPool*    g_thread_pool_new             (GFunc            thread_func,
-                                              gint             max_threads,
-                                              gulong           stack_size,
-                                              gboolean         bound,
-                                              GThreadPriority  priority,
-                                              gboolean         exclusive,
-                                              gpointer         user_data,
-                                              GError         **error);
-
-/* Push new data into the thread pool. This task is assigned to a thread later
- * (when the maximal number of threads is reached for that pool) or now
- * (otherwise). If necessary a new thread will be started. The function
- * returns immediatly */
-void            g_thread_pool_push            (GThreadPool     *pool,
-                                              gpointer         data,
-                                              GError         **error);
-
-/* Set the number of threads, which can run concurrently for that pool, -1
- * means no limit. 0 means has the effect, that the pool won't process
- * requests until the limit is set higher again */
-void            g_thread_pool_set_max_threads (GThreadPool     *pool,
-                                              gint             max_threads,
-                                              GError         **error);
-gint            g_thread_pool_get_max_threads (GThreadPool     *pool);
-
-/* Get the number of threads assigned to that pool. This number doesn't
- * necessarily represent the number of working threads in that pool */
-guint           g_thread_pool_get_num_threads (GThreadPool     *pool);
-
-/* Get the number of unprocessed items in the pool */
-guint           g_thread_pool_unprocessed     (GThreadPool     *pool);
-
-/* Free the pool, immediate means, that all unprocessed items in the queue
- * wont be processed, wait means, that the function doesn't return immediatly,
- * but after all threads in the pool are ready processing items. immediate
- * does however not mean, that threads are killed. */
-void            g_thread_pool_free            (GThreadPool     *pool,
-                                               gboolean         immediate,
-                                              gboolean         wait);
-
-/* Set the maximal number of unused threads before threads will be stopped by
- * GLib, -1 means no limit */
-void            g_thread_pool_set_max_unused_threads (gint      max_threads);
-gint            g_thread_pool_get_max_unused_threads (void);
-guint           g_thread_pool_get_num_unused_threads (void);
-
-/* Stop all currently unused threads, but leave the limit untouched */
-void            g_thread_pool_stop_unused_threads    (void);
-
-typedef enum 
-{
-  G_CONVERT_ERROR_NO_CONVERSION,
-  G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
-  G_CONVERT_ERROR_FAILED
-} GConvertError;
-
-#define G_CONVERT_ERROR g_convert_error_quark()
-GQuark g_convert_error_quark();
-
-gchar* g_convert               (const gchar  *str,
-                               gint          len,
-                               const gchar  *to_codeset,
-                               const gchar  *from_codeset,
-                               gint         *bytes_read,
-                               gint         *bytes_written,
-                               GError      **error);
-gchar* g_convert_with_fallback (const gchar  *str,
-                               gint          len,
-                               const gchar  *to_codeset,
-                               const gchar  *from_codeset,
-                               gchar        *fallback,
-                               gint         *bytes_read,
-                               gint         *bytes_written,
-                               GError      **error);
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
-
-#include <gunicode.h>
-#include <gerror.h>
+#include <galloca.h>
+#include <garray.h>
+#include <gasyncqueue.h>
+#include <gbacktrace.h>
+#include <gcache.h>
+#include <gcompletion.h>
+#include <gconvert.h>
+#include <gdataset.h>
+#include <gdate.h>
+#include <gfileutils.h>
+#include <ghash.h>
+#include <ghook.h>
+#include <giochannel.h>
+#include <glist.h>
+#include <gmacros.h>
+#include <gmain.h>
+#include <gmem.h>
+#include <gmessages.h>
+#include <gnode.h>
+#include <gprimes.h>
+#include <gquark.h>
+#include <gqueue.h>
+#include <grand.h>
+#include <grel.h>
+#include <gscanner.h>
 #include <gshell.h>
+#include <gslist.h>
 #include <gspawn.h>
-#include <gfileutils.h>
+#include <gstrfuncs.h>
+#include <gstring.h>
+#include <gthread.h>
+#include <gthreadpool.h>
+#include <gtimer.h>
+#include <gtree.h>
+#include <gtypes.h>
+#include <gunicode.h>
+#include <gutils.h>
 
 #endif /* __G_LIB_H__ */
diff --git a/glib/glist.h b/glib/glist.h
new file mode 100644 (file)
index 0000000..ec160c8
--- /dev/null
@@ -0,0 +1,97 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_LIST_H__
+#define __G_LIST_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GList          GList;
+
+struct _GList
+{
+  gpointer data;
+  GList *next;
+  GList *prev;
+};
+
+/* Doubly linked lists
+ */
+void   g_list_push_allocator    (GAllocator     *allocator);
+void   g_list_pop_allocator     (void);
+GList* g_list_alloc            (void);
+void   g_list_free             (GList          *list);
+void   g_list_free_1           (GList          *list);
+GList* g_list_append           (GList          *list,
+                                gpointer        data);
+GList* g_list_prepend          (GList          *list,
+                                gpointer        data);
+GList* g_list_insert           (GList          *list,
+                                gpointer        data,
+                                gint            position);
+GList* g_list_insert_sorted    (GList          *list,
+                                gpointer        data,
+                                GCompareFunc    func);
+GList* g_list_concat           (GList          *list1,
+                                GList          *list2);
+GList* g_list_remove           (GList          *list,
+                                gconstpointer   data);
+GList* g_list_remove_link      (GList          *list,
+                                GList          *llink);
+GList* g_list_delete_link      (GList          *list,
+                                GList          *link);
+GList* g_list_reverse          (GList          *list);
+GList* g_list_copy             (GList          *list);
+GList* g_list_nth              (GList          *list,
+                                guint           n);
+GList* g_list_find             (GList          *list,
+                                gconstpointer   data);
+GList* g_list_find_custom      (GList          *list,
+                                gconstpointer   data,
+                                GCompareFunc    func);
+gint   g_list_position         (GList          *list,
+                                GList          *llink);
+gint   g_list_index            (GList          *list,
+                                gconstpointer   data);
+GList* g_list_last             (GList          *list);
+GList* g_list_first            (GList          *list);
+guint  g_list_length           (GList          *list);
+void   g_list_foreach          (GList          *list,
+                                GFunc           func,
+                                gpointer        user_data);
+GList* g_list_sort              (GList          *list,
+                                GCompareFunc    compare_func);
+gpointer g_list_nth_data       (GList          *list,
+                                guint           n);
+#define g_list_previous(list)  ((list) ? (((GList *)(list))->prev) : NULL)
+#define g_list_next(list)      ((list) ? (((GList *)(list))->next) : NULL)
+
+G_END_DECLS
+
+#endif /* __G_LIST_H__ */
+
diff --git a/glib/gmacros.h b/glib/gmacros.h
new file mode 100644 (file)
index 0000000..7033766
--- /dev/null
@@ -0,0 +1,178 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+/* This file must not include any other glib header file and must thus
+ * not refer to variables from glibconfig.h 
+ */
+
+#ifndef __G_MACROS_H__
+#define __G_MACROS_H__
+
+/* Here we provide G_GNUC_EXTENSION as an alias for __extension__,
+ * where this is valid. This allows for warningless compilation of
+ * "long long" types even in the presence of '-ansi -pedantic'. 
+ */
+#if     __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8)
+#  define G_GNUC_EXTENSION __extension__
+#else
+#  define G_GNUC_EXTENSION
+#endif
+
+/* Provide macros to feature the GCC function attribute.
+ */
+#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
+#define G_GNUC_PURE                            \
+  __attribute__((pure))
+#else
+#define G_GNUC_PURE
+#endif
+
+#if     __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
+#define G_GNUC_PRINTF( format_idx, arg_idx )    \
+  __attribute__((format (printf, format_idx, arg_idx)))
+#define G_GNUC_SCANF( format_idx, arg_idx )     \
+  __attribute__((format (scanf, format_idx, arg_idx)))
+#define G_GNUC_FORMAT( arg_idx )                \
+  __attribute__((format_arg (arg_idx)))
+#define G_GNUC_NORETURN                         \
+  __attribute__((noreturn))
+#define G_GNUC_CONST                            \
+  __attribute__((const))
+#define G_GNUC_UNUSED                           \
+  __attribute__((unused))
+#else   /* !__GNUC__ */
+#define G_GNUC_PRINTF( format_idx, arg_idx )
+#define G_GNUC_SCANF( format_idx, arg_idx )
+#define G_GNUC_FORMAT( arg_idx )
+#define G_GNUC_NORETURN
+#define G_GNUC_CONST
+#define G_GNUC_UNUSED
+#endif  /* !__GNUC__ */
+
+/* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with
+ * macros, so we can refer to them as strings unconditionally.
+ */
+#ifdef  __GNUC__
+#define G_GNUC_FUNCTION         __FUNCTION__
+#define G_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__
+#else   /* !__GNUC__ */
+#define G_GNUC_FUNCTION         ""
+#define G_GNUC_PRETTY_FUNCTION  ""
+#endif  /* !__GNUC__ */
+
+#define G_STRINGIFY(macro_or_string)   G_STRINGIFY_ARG (macro_or_string)
+#define        G_STRINGIFY_ARG(contents)       #contents
+
+/* Provide a string identifying the current code position */
+#ifdef  __GNUC__
+#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()"
+#else
+#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__)
+#endif
+
+/* Guard C code in headers, while including them from C++ */
+#ifdef  __cplusplus
+# define G_BEGIN_DECLS  extern "C" {
+# define G_END_DECLS    }
+#else
+# define G_BEGIN_DECLS
+# define G_END_DECLS
+#endif
+
+/* Provide definitions for some commonly used macros.
+ *  Some of them are only provided if they haven't already
+ *  been defined. It is assumed that if they are already
+ *  defined then the current definition is correct.
+ */
+#ifndef NULL
+#  ifdef __cplusplus
+#    define NULL        (0L)
+#  else /* !__cplusplus */
+#    define NULL        ((void*) 0)
+#  endif /* !__cplusplus */
+#endif
+
+#ifndef        FALSE
+#define        FALSE   (0)
+#endif
+
+#ifndef        TRUE
+#define        TRUE    (!FALSE)
+#endif
+
+#undef MAX
+#define MAX(a, b)  (((a) > (b)) ? (a) : (b))
+
+#undef MIN
+#define MIN(a, b)  (((a) < (b)) ? (a) : (b))
+
+#undef ABS
+#define ABS(a)    (((a) < 0) ? -(a) : (a))
+
+#undef CLAMP
+#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
+
+/* Count the number of elements in an array. The array must be defined
+ * as such; using this with a dynamically allocated array will give
+ * incorrect results.
+ */
+#define G_N_ELEMENTS(arr)              (sizeof (arr) / sizeof ((arr)[0]))
+
+/* Provide convenience macros for handling structure
+ * fields through their offsets.
+ */
+#define G_STRUCT_OFFSET(struct_type, member)   \
+    ((glong) ((guint8*) &((struct_type*) 0)->member))
+#define G_STRUCT_MEMBER_P(struct_p, struct_offset)   \
+    ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset)))
+#define G_STRUCT_MEMBER(member_type, struct_p, struct_offset)   \
+    (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset)))
+
+/* Provide simple macro statement wrappers (adapted from Perl):
+ *  G_STMT_START { statements; } G_STMT_END;
+ *  can be used as a single statement, as in
+ *  if (x) G_STMT_START { ... } G_STMT_END; else ...
+ *
+ *  For gcc we will wrap the statements within `({' and `})' braces.
+ *  For SunOS they will be wrapped within `if (1)' and `else (void) 0',
+ *  and otherwise within `do' and `while (0)'.
+ */
+#if !(defined (G_STMT_START) && defined (G_STMT_END))
+#  if defined (__GNUC__) && !defined (__STRICT_ANSI__) && !defined (__cplusplus)
+#    define G_STMT_START       (void)(
+#    define G_STMT_END         )
+#  else
+#    if (defined (sun) || defined (__sun__))
+#      define G_STMT_START     if (1)
+#      define G_STMT_END       else (void)0
+#    else
+#      define G_STMT_START     do
+#      define G_STMT_END       while (0)
+#    endif
+#  endif
+#endif
+
+#endif /* __G_MACROS_H__ */
diff --git a/glib/gmain.h b/glib/gmain.h
new file mode 100644 (file)
index 0000000..7f08c3d
--- /dev/null
@@ -0,0 +1,168 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MAIN_H__
+#define __G_MAIN_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Main loop
+ */
+typedef struct _GTimeVal        GTimeVal;
+typedef struct _GSourceFuncs    GSourceFuncs;
+typedef struct _GMainLoop       GMainLoop;      /* Opaque */
+
+struct _GTimeVal
+{
+  glong tv_sec;
+  glong tv_usec;
+};
+struct _GSourceFuncs
+{
+  gboolean (*prepare)  (gpointer  source_data,
+                        GTimeVal *current_time,
+                        gint     *timeout,
+                        gpointer  user_data);
+  gboolean (*check)    (gpointer  source_data,
+                        GTimeVal *current_time,
+                        gpointer  user_data);
+  gboolean (*dispatch) (gpointer  source_data,
+                        GTimeVal *dispatch_time,
+                        gpointer  user_data);
+  GDestroyNotify destroy;
+};
+
+/* Standard priorities */
+
+#define G_PRIORITY_HIGH            -100
+#define G_PRIORITY_DEFAULT          0
+#define G_PRIORITY_HIGH_IDLE        100
+#define G_PRIORITY_DEFAULT_IDLE     200
+#define G_PRIORITY_LOW              300
+
+typedef gboolean (*GSourceFunc) (gpointer data);
+
+/* Hooks for adding to the main loop */
+guint    g_source_add                        (gint           priority,
+                                              gboolean       can_recurse,
+                                              GSourceFuncs  *funcs,
+                                              gpointer       source_data,
+                                              gpointer       user_data,
+                                              GDestroyNotify notify);
+gboolean g_source_remove                     (guint          tag);
+gboolean g_source_remove_by_user_data        (gpointer       user_data);
+gboolean g_source_remove_by_source_data      (gpointer       source_data);
+gboolean g_source_remove_by_funcs_user_data  (GSourceFuncs  *funcs,
+                                              gpointer       user_data);
+
+void g_get_current_time                 (GTimeVal       *result);
+
+/* Running the main loop */
+GMainLoop*      g_main_new              (gboolean        is_running);
+void            g_main_run              (GMainLoop      *loop);
+void            g_main_quit             (GMainLoop      *loop);
+void            g_main_destroy          (GMainLoop      *loop);
+gboolean        g_main_is_running       (GMainLoop      *loop);
+
+/* Run a single iteration of the mainloop. If block is FALSE,
+ * will never block
+ */
+gboolean        g_main_iteration        (gboolean       may_block);
+
+/* See if any events are pending */
+gboolean        g_main_pending          (void);
+
+/* Idles and timeouts */
+guint           g_timeout_add_full      (gint           priority,
+                                         guint          interval,
+                                         GSourceFunc    function,
+                                         gpointer       data,
+                                         GDestroyNotify notify);
+guint           g_timeout_add           (guint          interval,
+                                         GSourceFunc    function,
+                                         gpointer       data);
+guint           g_idle_add              (GSourceFunc    function,
+                                         gpointer       data);
+guint           g_idle_add_full         (gint           priority,
+                                         GSourceFunc    function,
+                                         gpointer       data,
+                                         GDestroyNotify destroy);
+gboolean        g_idle_remove_by_data   (gpointer       data);
+
+/* GPollFD
+ *
+ * System-specific IO and main loop calls
+ *
+ * On Win32, the fd in a GPollFD should be Win32 HANDLE (*not* a file
+ * descriptor as provided by the C runtime) that can be used by
+ * MsgWaitForMultipleObjects. This does *not* include file handles
+ * from CreateFile, SOCKETs, nor pipe handles. (But you can use
+ * WSAEventSelect to signal events when a SOCKET is readable).
+ *
+ * On Win32, fd can also be the special value G_WIN32_MSG_HANDLE to
+ * indicate polling for messages. These message queue GPollFDs should
+ * be added with the g_main_poll_win32_msg_add function.
+ *
+ * But note that G_WIN32_MSG_HANDLE GPollFDs should not be used by GDK
+ * (GTK) programs, as GDK itself wants to read messages and convert them
+ * to GDK events.
+ *
+ * So, unless you really know what you are doing, it's best not to try
+ * to use the main loop polling stuff for your own needs on
+ * Win32. It's really only written for the GIMP's needs so
+ * far.
+ */
+
+typedef struct _GPollFD GPollFD;
+typedef gint    (*GPollFunc)    (GPollFD *ufds,
+                                 guint    nfsd,
+                                 gint     timeout);
+struct _GPollFD
+{
+  gint          fd;
+  gushort       events;
+  gushort       revents;
+};
+
+void        g_main_add_poll          (GPollFD    *fd,
+                                      gint        priority);
+void        g_main_remove_poll       (GPollFD    *fd);
+void        g_main_set_poll_func     (GPollFunc   func);
+
+#ifdef G_OS_WIN32
+
+/* Useful on other platforms, too? */
+
+GPollFunc   g_main_win32_get_poll_func (void);
+
+#endif
+
+G_END_DECLS
+
+#endif /* __G_MAIN_H__ */
+
diff --git a/glib/gmem.h b/glib/gmem.h
new file mode 100644 (file)
index 0000000..72e7b28
--- /dev/null
@@ -0,0 +1,158 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MEM_H__
+#define __G_MEM_H__
+
+#include <gtypes.h>
+
+/* optionally feature DMALLOC memory allocation debugger
+ */
+#ifdef USE_DMALLOC
+#include "dmalloc.h"
+#endif
+
+G_BEGIN_DECLS
+
+typedef struct _GAllocator      GAllocator;
+typedef struct _GMemChunk       GMemChunk;
+
+/* Provide macros for easily allocating memory. The macros
+ *  will cast the allocated memory to the specified type
+ *  in order to avoid compiler warnings. (Makes the code neater).
+ */
+
+#ifdef __DMALLOC_H__
+#  define g_new(type, count)           (ALLOC (type, count))
+#  define g_new0(type, count)          (CALLOC (type, count))
+#  define g_renew(type, mem, count)    (REALLOC (mem, type, count))
+#else /* __DMALLOC_H__ */
+#  define g_new(type, count)     \
+      ((type *) g_malloc ((unsigned) sizeof (type) * (count)))
+#  define g_new0(type, count)    \
+      ((type *) g_malloc0 ((unsigned) sizeof (type) * (count)))
+#  define g_renew(type, mem, count)      \
+      ((type *) g_realloc (mem, (unsigned) sizeof (type) * (count)))
+#endif /* __DMALLOC_H__ */
+
+#define g_mem_chunk_create(type, pre_alloc, alloc_type)        ( \
+  g_mem_chunk_new (#type " mem chunks (" #pre_alloc ")", \
+                  sizeof (type), \
+                  sizeof (type) * (pre_alloc), \
+                  (alloc_type)) \
+)
+#define g_chunk_new(type, chunk)       ( \
+  (type *) g_mem_chunk_alloc (chunk) \
+)
+#define g_chunk_new0(type, chunk)      ( \
+  (type *) g_mem_chunk_alloc0 (chunk) \
+)
+#define g_chunk_free(mem, mem_chunk)   G_STMT_START { \
+  g_mem_chunk_free ((mem_chunk), (mem)); \
+} G_STMT_END
+
+/* Memory allocation and debugging
+ */
+#ifdef USE_DMALLOC
+
+#define g_malloc(size)      ((gpointer) MALLOC (size))
+#define g_malloc0(size)             ((gpointer) CALLOC (char, size))
+#define g_realloc(mem,size)  ((gpointer) REALLOC (mem, char, size))
+#define g_free(mem)         FREE (mem)
+
+#else /* !USE_DMALLOC */
+
+gpointer g_malloc      (gulong   size);
+gpointer g_malloc0     (gulong   size);
+gpointer g_realloc     (gpointer  mem,
+                       gulong    size);
+void    g_free        (gpointer  mem);
+
+#endif /* !USE_DMALLOC */
+
+void    g_mem_profile (void);
+void    g_mem_check   (gpointer  mem);
+
+/* Generic allocators
+ */
+GAllocator* g_allocator_new   (const gchar  *name,
+                              guint         n_preallocs);
+void        g_allocator_free  (GAllocator   *allocator);
+
+#define        G_ALLOCATOR_LIST        (1)
+#define        G_ALLOCATOR_SLIST       (2)
+#define        G_ALLOCATOR_NODE        (3)
+
+/* "g_mem_chunk_new" creates a new memory chunk.
+ * Memory chunks are used to allocate pieces of memory which are
+ *  always the same size. Lists are a good example of such a data type.
+ * The memory chunk allocates and frees blocks of memory as needed.
+ *  Just be sure to call "g_mem_chunk_free" and not "g_free" on data
+ *  allocated in a mem chunk. ("g_free" will most likely cause a seg
+ *  fault...somewhere).
+ *
+ * Oh yeah, GMemChunk is an opaque data type. (You don't really
+ *  want to know what's going on inside do you?)
+ */
+
+/* ALLOC_ONLY MemChunk's can only allocate memory. The free operation
+ *  is interpreted as a no op. ALLOC_ONLY MemChunk's save 4 bytes per
+ *  atom. (They are also useful for lists which use MemChunk to allocate
+ *  memory but are also part of the MemChunk implementation).
+ * ALLOC_AND_FREE MemChunk's can allocate and free memory.
+ */
+
+#define G_ALLOC_ONLY     1
+#define G_ALLOC_AND_FREE  2
+
+GMemChunk* g_mem_chunk_new     (gchar    *name,
+                               gint       atom_size,
+                               gulong     area_size,
+                               gint       type);
+void      g_mem_chunk_destroy (GMemChunk *mem_chunk);
+gpointer   g_mem_chunk_alloc   (GMemChunk *mem_chunk);
+gpointer   g_mem_chunk_alloc0  (GMemChunk *mem_chunk);
+void      g_mem_chunk_free    (GMemChunk *mem_chunk,
+                               gpointer   mem);
+void      g_mem_chunk_clean   (GMemChunk *mem_chunk);
+void      g_mem_chunk_reset   (GMemChunk *mem_chunk);
+void      g_mem_chunk_print   (GMemChunk *mem_chunk);
+void      g_mem_chunk_info    (void);
+
+/* Ah yes...we have a "g_blow_chunks" function.
+ * "g_blow_chunks" simply compresses all the chunks. This operation
+ *  consists of freeing every memory area that should be freed (but
+ *  which we haven't gotten around to doing yet). And, no,
+ *  "g_blow_chunks" doesn't follow the naming scheme, but it is a
+ *  much better name than "g_mem_chunk_clean_all" or something
+ *  similar.
+ */
+void g_blow_chunks (void);
+
+G_END_DECLS
+
+#endif /* __G_MEM_H__ */
+
diff --git a/glib/gmessages.h b/glib/gmessages.h
new file mode 100644 (file)
index 0000000..a33657f
--- /dev/null
@@ -0,0 +1,341 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MESSAGES_H__
+#define __G_MESSAGES_H__
+
+#include <stdarg.h>
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* calculate a string size, guarranteed to fit format + args.
+ */
+guint  g_printf_string_upper_bound (const gchar* format,
+                                    va_list      args);
+
+/* Log level shift offset for user defined
+ * log levels (0-7 are used by GLib).
+ */
+#define G_LOG_LEVEL_USER_SHIFT  (8)
+
+/* Glib log levels and flags.
+ */
+typedef enum
+{
+  /* log flags */
+  G_LOG_FLAG_RECURSION          = 1 << 0,
+  G_LOG_FLAG_FATAL              = 1 << 1,
+
+  /* GLib log levels */
+  G_LOG_LEVEL_ERROR             = 1 << 2,       /* always fatal */
+  G_LOG_LEVEL_CRITICAL          = 1 << 3,
+  G_LOG_LEVEL_WARNING           = 1 << 4,
+  G_LOG_LEVEL_MESSAGE           = 1 << 5,
+  G_LOG_LEVEL_INFO              = 1 << 6,
+  G_LOG_LEVEL_DEBUG             = 1 << 7,
+
+  G_LOG_LEVEL_MASK              = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
+} GLogLevelFlags;
+
+/* GLib log levels that are considered fatal by default */
+#define G_LOG_FATAL_MASK        (G_LOG_FLAG_RECURSION | G_LOG_LEVEL_ERROR)
+
+typedef void            (*GLogFunc)             (const gchar   *log_domain,
+                                                 GLogLevelFlags log_level,
+                                                 const gchar   *message,
+                                                 gpointer       user_data);
+
+/* Logging mechanism
+ */
+extern          const gchar             *g_log_domain_glib;
+guint           g_log_set_handler       (const gchar    *log_domain,
+                                         GLogLevelFlags  log_levels,
+                                         GLogFunc        log_func,
+                                         gpointer        user_data);
+void            g_log_remove_handler    (const gchar    *log_domain,
+                                         guint           handler_id);
+void            g_log_default_handler   (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *message,
+                                         gpointer        unused_data);
+void            g_log                   (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *format,
+                                         ...) G_GNUC_PRINTF (3, 4);
+void            g_logv                  (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *format,
+                                         va_list         args);
+GLogLevelFlags  g_log_set_fatal_mask    (const gchar    *log_domain,
+                                         GLogLevelFlags  fatal_mask);
+GLogLevelFlags  g_log_set_always_fatal  (GLogLevelFlags  fatal_mask);
+
+#ifndef G_LOG_DOMAIN
+#define G_LOG_DOMAIN    ((gchar*) 0)
+#endif  /* G_LOG_DOMAIN */
+#if defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
+#define g_error(...)    g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_ERROR,    \
+                               __VA_ARGS__)
+#define g_message(...)  g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_MESSAGE,  \
+                               __VA_ARGS__)
+#define g_critical(...) g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_CRITICAL, \
+                               __VA_ARGS__)
+#define g_warning(...)  g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_WARNING,  \
+                               __VA_ARGS__)
+#elif __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4)
+#define g_error(format...)      g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_ERROR,    \
+                                       format)
+#define g_message(format...)    g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_MESSAGE,  \
+                                       format)
+#define g_critical(format...)   g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_CRITICAL, \
+                                       format)
+#define g_warning(format...)    g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_WARNING,  \
+                                       format)
+#else   /* !__GNUC__ */
+static void
+g_error (const gchar *format,
+         ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, args);
+  va_end (args);
+}
+static void
+g_message (const gchar *format,
+           ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, args);
+  va_end (args);
+}
+static void
+g_critical (const gchar *format,
+            ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, args);
+  va_end (args);
+}
+static void
+g_warning (const gchar *format,
+           ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, args);
+  va_end (args);
+}
+#endif  /* !__GNUC__ */
+
+typedef void    (*GPrintFunc)           (const gchar    *string);
+void            g_print                 (const gchar    *format,
+                                         ...) G_GNUC_PRINTF (1, 2);
+GPrintFunc      g_set_print_handler     (GPrintFunc      func);
+void            g_printerr              (const gchar    *format,
+                                         ...) G_GNUC_PRINTF (1, 2);
+GPrintFunc      g_set_printerr_handler  (GPrintFunc      func);
+
+/* deprecated compatibility functions, use g_log_set_handler() instead */
+typedef void            (*GErrorFunc)           (const gchar *str);
+typedef void            (*GWarningFunc)         (const gchar *str);
+GErrorFunc   g_set_error_handler   (GErrorFunc   func);
+GWarningFunc g_set_warning_handler (GWarningFunc func);
+GPrintFunc   g_set_message_handler (GPrintFunc func);
+
+/* Provide macros for error handling. The "assert" macros will
+ *  exit on failure. The "return" macros will exit the current
+ *  function. Two different definitions are given for the macros
+ *  if G_DISABLE_ASSERT is not defined, in order to support gcc's
+ *  __PRETTY_FUNCTION__ capability.
+ */
+
+#ifdef G_DISABLE_ASSERT
+
+#define g_assert(expr)
+#define g_assert_not_reached()
+
+#else /* !G_DISABLE_ASSERT */
+
+#ifdef __GNUC__
+
+#define g_assert(expr)                 G_STMT_START{           \
+     if (!(expr))                                              \
+       g_log (G_LOG_DOMAIN,                                    \
+             G_LOG_LEVEL_ERROR,                                \
+             "file %s: line %d (%s): assertion failed: (%s)",  \
+             __FILE__,                                         \
+             __LINE__,                                         \
+             __PRETTY_FUNCTION__,                              \
+             #expr);                   }G_STMT_END
+
+#define g_assert_not_reached()         G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_ERROR,                                  \
+           "file %s: line %d (%s): should not be reached",     \
+           __FILE__,                                           \
+           __LINE__,                                           \
+           __PRETTY_FUNCTION__);       }G_STMT_END
+
+#else /* !__GNUC__ */
+
+#define g_assert(expr)                 G_STMT_START{           \
+     if (!(expr))                                              \
+       g_log (G_LOG_DOMAIN,                                    \
+             G_LOG_LEVEL_ERROR,                                \
+             "file %s: line %d: assertion failed: (%s)",       \
+             __FILE__,                                         \
+             __LINE__,                                         \
+             #expr);                   }G_STMT_END
+
+#define g_assert_not_reached()         G_STMT_START{   \
+     g_log (G_LOG_DOMAIN,                              \
+           G_LOG_LEVEL_ERROR,                          \
+           "file %s: line %d: should not be reached",  \
+           __FILE__,                                   \
+           __LINE__);          }G_STMT_END
+
+#endif /* __GNUC__ */
+
+#endif /* !G_DISABLE_ASSERT */
+
+
+#ifdef G_DISABLE_CHECKS
+
+#define g_return_if_fail(expr)
+#define g_return_val_if_fail(expr,val)
+#define g_return_if_reached() return
+#define g_return_val_if_reached(val) return (val)
+
+#else /* !G_DISABLE_CHECKS */
+
+#ifdef __GNUC__
+
+#define g_return_if_fail(expr)         G_STMT_START{                   \
+     if (!(expr))                                                      \
+       {                                                               \
+        g_log (G_LOG_DOMAIN,                                           \
+               G_LOG_LEVEL_CRITICAL,                                   \
+               "file %s: line %d (%s): assertion `%s' failed",         \
+               __FILE__,                                               \
+               __LINE__,                                               \
+               __PRETTY_FUNCTION__,                                    \
+               #expr);                                                 \
+        return;                                                        \
+       };                              }G_STMT_END
+
+#define g_return_val_if_fail(expr,val) G_STMT_START{                   \
+     if (!(expr))                                                      \
+       {                                                               \
+        g_log (G_LOG_DOMAIN,                                           \
+               G_LOG_LEVEL_CRITICAL,                                   \
+               "file %s: line %d (%s): assertion `%s' failed",         \
+               __FILE__,                                               \
+               __LINE__,                                               \
+               __PRETTY_FUNCTION__,                                    \
+               #expr);                                                 \
+        return (val);                                                  \
+       };                              }G_STMT_END
+
+#define g_return_if_reached()          G_STMT_START{                   \
+     g_log (G_LOG_DOMAIN,                                              \
+           G_LOG_LEVEL_CRITICAL,                                       \
+           "file %s: line %d (%s): should not be reached",             \
+           __FILE__,                                                   \
+           __LINE__,                                                   \
+           __PRETTY_FUNCTION__);                                       \
+     return;                           }G_STMT_END
+
+#define g_return_val_if_reached(val)   G_STMT_START{                   \
+     g_log (G_LOG_DOMAIN,                                              \
+           G_LOG_LEVEL_CRITICAL,                                       \
+           "file %s: line %d (%s): should not be reached",             \
+           __FILE__,                                                   \
+           __LINE__,                                                   \
+           __PRETTY_FUNCTION__);                                       \
+     return (val);                     }G_STMT_END
+
+#else /* !__GNUC__ */
+
+#define g_return_if_fail(expr)         G_STMT_START{           \
+     if (!(expr))                                              \
+       {                                                       \
+        g_log (G_LOG_DOMAIN,                                   \
+               G_LOG_LEVEL_CRITICAL,                           \
+               "file %s: line %d: assertion `%s' failed",      \
+               __FILE__,                                       \
+               __LINE__,                                       \
+               #expr);                                         \
+        return;                                                \
+       };                              }G_STMT_END
+
+#define g_return_val_if_fail(expr, val)        G_STMT_START{           \
+     if (!(expr))                                              \
+       {                                                       \
+        g_log (G_LOG_DOMAIN,                                   \
+               G_LOG_LEVEL_CRITICAL,                           \
+               "file %s: line %d: assertion `%s' failed",      \
+               __FILE__,                                       \
+               __LINE__,                                       \
+               #expr);                                         \
+        return (val);                                          \
+       };                              }G_STMT_END
+
+#define g_return_if_reached()          G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_CRITICAL,                               \
+           "file %s: line %d: should not be reached",          \
+           __FILE__,                                           \
+           __LINE__);                                          \
+     return;                           }G_STMT_END
+
+#define g_return_val_if_reached(val)   G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_CRITICAL,                               \
+           "file %s: line %d: should not be reached",          \
+           __FILE__,                                           \
+           __LINE__);                                          \
+     return (val);                     }G_STMT_END
+
+#endif /* !__GNUC__ */
+
+#endif /* !G_DISABLE_CHECKS */
+
+G_END_DECLS
+
+#endif /* __G_MESSAGES_H__ */
+
diff --git a/glib/gnode.h b/glib/gnode.h
new file mode 100644 (file)
index 0000000..2b9b21d
--- /dev/null
@@ -0,0 +1,160 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_NODE_H__
+#define __G_NODE_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GNode          GNode;
+
+/* Tree traverse flags */
+typedef enum
+{
+  G_TRAVERSE_LEAFS      = 1 << 0,
+  G_TRAVERSE_NON_LEAFS  = 1 << 1,
+  G_TRAVERSE_ALL        = G_TRAVERSE_LEAFS | G_TRAVERSE_NON_LEAFS,
+  G_TRAVERSE_MASK       = 0x03
+} GTraverseFlags;
+
+/* Tree traverse orders */
+typedef enum
+{
+  G_IN_ORDER,
+  G_PRE_ORDER,
+  G_POST_ORDER,
+  G_LEVEL_ORDER
+} GTraverseType;
+
+typedef gboolean       (*GNodeTraverseFunc)    (GNode         *node,
+                                                gpointer       data);
+typedef void           (*GNodeForeachFunc)     (GNode         *node,
+                                                gpointer       data);
+
+/* N-way tree implementation
+ */
+struct _GNode
+{
+  gpointer data;
+  GNode          *next;
+  GNode          *prev;
+  GNode          *parent;
+  GNode          *children;
+};
+
+#define         G_NODE_IS_ROOT(node)   (((GNode*) (node))->parent == NULL && \
+                                ((GNode*) (node))->prev == NULL && \
+                                ((GNode*) (node))->next == NULL)
+#define         G_NODE_IS_LEAF(node)   (((GNode*) (node))->children == NULL)
+
+void     g_node_push_allocator  (GAllocator       *allocator);
+void     g_node_pop_allocator   (void);
+GNode*  g_node_new             (gpointer          data);
+void    g_node_destroy         (GNode            *root);
+void    g_node_unlink          (GNode            *node);
+GNode*   g_node_copy            (GNode            *node);
+GNode*  g_node_insert          (GNode            *parent,
+                                gint              position,
+                                GNode            *node);
+GNode*  g_node_insert_before   (GNode            *parent,
+                                GNode            *sibling,
+                                GNode            *node);
+GNode*  g_node_prepend         (GNode            *parent,
+                                GNode            *node);
+guint   g_node_n_nodes         (GNode            *root,
+                                GTraverseFlags    flags);
+GNode*  g_node_get_root        (GNode            *node);
+gboolean g_node_is_ancestor    (GNode            *node,
+                                GNode            *descendant);
+guint   g_node_depth           (GNode            *node);
+GNode*  g_node_find            (GNode            *root,
+                                GTraverseType     order,
+                                GTraverseFlags    flags,
+                                gpointer          data);
+
+/* convenience macros */
+#define g_node_append(parent, node)                            \
+     g_node_insert_before ((parent), NULL, (node))
+#define        g_node_insert_data(parent, position, data)              \
+     g_node_insert ((parent), (position), g_node_new (data))
+#define        g_node_insert_data_before(parent, sibling, data)        \
+     g_node_insert_before ((parent), (sibling), g_node_new (data))
+#define        g_node_prepend_data(parent, data)                       \
+     g_node_prepend ((parent), g_node_new (data))
+#define        g_node_append_data(parent, data)                        \
+     g_node_insert_before ((parent), NULL, g_node_new (data))
+
+/* traversal function, assumes that `node' is root
+ * (only traverses `node' and its subtree).
+ * this function is just a high level interface to
+ * low level traversal functions, optimized for speed.
+ */
+void    g_node_traverse        (GNode            *root,
+                                GTraverseType     order,
+                                GTraverseFlags    flags,
+                                gint              max_depth,
+                                GNodeTraverseFunc func,
+                                gpointer          data);
+
+/* return the maximum tree height starting with `node', this is an expensive
+ * operation, since we need to visit all nodes. this could be shortened by
+ * adding `guint height' to struct _GNode, but then again, this is not very
+ * often needed, and would make g_node_insert() more time consuming.
+ */
+guint   g_node_max_height       (GNode *root);
+
+void    g_node_children_foreach (GNode           *node,
+                                 GTraverseFlags   flags,
+                                 GNodeForeachFunc func,
+                                 gpointer         data);
+void    g_node_reverse_children (GNode           *node);
+guint   g_node_n_children       (GNode           *node);
+GNode*  g_node_nth_child        (GNode           *node,
+                                 guint            n);
+GNode*  g_node_last_child       (GNode           *node);
+GNode*  g_node_find_child       (GNode           *node,
+                                 GTraverseFlags   flags,
+                                 gpointer         data);
+gint    g_node_child_position   (GNode           *node,
+                                 GNode           *child);
+gint    g_node_child_index      (GNode           *node,
+                                 gpointer         data);
+
+GNode*  g_node_first_sibling    (GNode           *node);
+GNode*  g_node_last_sibling     (GNode           *node);
+
+#define         g_node_prev_sibling(node)      ((node) ? \
+                                        ((GNode*) (node))->prev : NULL)
+#define         g_node_next_sibling(node)      ((node) ? \
+                                        ((GNode*) (node))->next : NULL)
+#define         g_node_first_child(node)       ((node) ? \
+                                        ((GNode*) (node))->children : NULL)
+
+G_END_DECLS
+
+#endif /* __G_NODE_H__ */
diff --git a/glib/gprimes.h b/glib/gprimes.h
new file mode 100644 (file)
index 0000000..daa1598
--- /dev/null
@@ -0,0 +1,47 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_PRIMES_H__
+#define __G_PRIMES_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Prime numbers.
+ */
+
+/* This function returns prime numbers spaced by approximately 1.5-2.0
+ * and is for use in resizing data structures which prefer
+ * prime-valued sizes. The closest spaced prime function returns the
+ * next largest prime, or the highest it knows about which is about
+ * MAXINT/4.
+ */
+guint     g_spaced_primes_closest (guint num) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_PRIMES_H__ */
diff --git a/glib/gquark.h b/glib/gquark.h
new file mode 100644 (file)
index 0000000..08dd9e4
--- /dev/null
@@ -0,0 +1,46 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_QUARK_H__
+#define __G_QUARK_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef guint32 GQuark;
+
+/* Quarks (string<->id association)
+ */
+GQuark    g_quark_try_string            (const gchar    *string);
+GQuark    g_quark_from_static_string    (const gchar    *string);
+GQuark    g_quark_from_string           (const gchar    *string);
+gchar*    g_quark_to_string             (GQuark          quark) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_QUARK_H__ */
+
diff --git a/glib/gqueue.h b/glib/gqueue.h
new file mode 100644 (file)
index 0000000..b71b6d6
--- /dev/null
@@ -0,0 +1,65 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_QUEUE_H__
+#define __G_QUEUE_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GQueue         GQueue;
+
+struct _GQueue
+{
+  GList *head;
+  GList *tail;
+  guint  length;
+};
+
+/* Queues
+ */
+GQueue*  g_queue_new            (void);
+void     g_queue_free           (GQueue  *queue);
+void     g_queue_push_head      (GQueue  *queue,
+                                gpointer data);
+void     g_queue_push_tail      (GQueue  *queue,
+                                gpointer data);
+gpointer g_queue_pop_head       (GQueue  *queue);
+gpointer g_queue_pop_tail       (GQueue  *queue);
+gboolean g_queue_is_empty       (GQueue  *queue);
+gpointer g_queue_peek_head      (GQueue  *queue);
+gpointer g_queue_peek_tail      (GQueue  *queue);
+void     g_queue_push_head_link (GQueue  *queue,
+                                GList   *link);
+void     g_queue_push_tail_link (GQueue  *queue,
+                                GList   *link);
+GList*   g_queue_pop_head_link  (GQueue  *queue);
+GList*   g_queue_pop_tail_link  (GQueue  *queue);
+
+G_END_DECLS
+
+#endif /* __G_QUEUE_H__ */
diff --git a/glib/grand.h b/glib/grand.h
new file mode 100644 (file)
index 0000000..38f4e5e
--- /dev/null
@@ -0,0 +1,76 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_RAND_H__
+#define __G_RAND_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GRand           GRand;
+
+/* GRand - a good and fast random number generator: Mersenne Twister
+ * see http://www.math.keio.ac.jp/~matumoto/emt.html for more info.
+ * The range functions return a value in the intervall [min,max).
+ * int          -> [0..2^32-1]
+ * int_range    -> [min..max-1]
+ * double       -> [0..1)
+ * double_range -> [min..max)
+ */
+
+GRand*  g_rand_new_with_seed   (guint32     seed);
+GRand*  g_rand_new             (void);
+void    g_rand_free            (GRand      *rand);
+
+void    g_rand_set_seed        (GRand      *rand,
+                                guint32     seed);
+guint32 g_rand_int             (GRand      *rand);
+gint32  g_rand_int_range       (GRand      *rand,
+                                gint32      min,
+                                gint32      max);
+gdouble g_rand_double          (GRand      *rand);
+gdouble g_rand_double_range    (GRand      *rand,
+                                gdouble     min,
+                                gdouble     max);
+
+void    g_random_set_seed      (guint32     seed);
+guint32 g_random_int           (void);
+gint32  g_random_int_range     (gint32      min,
+                                gint32      max);
+gdouble g_random_double        (void);
+gdouble g_random_double_range  (gdouble     min,
+                                gdouble     max);
+
+G_END_DECLS
+
+#endif /* __G_RAND_H__ */
+
+
+
+
+
+
diff --git a/glib/grel.h b/glib/grel.h
new file mode 100644 (file)
index 0000000..09b2e23
--- /dev/null
@@ -0,0 +1,94 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_REL_H__
+#define __G_REL_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GRelation       GRelation;
+typedef struct _GTuples         GTuples;
+
+struct _GTuples
+{
+  guint len;
+};
+
+/* GRelation
+ *
+ * Indexed Relations.  Imagine a really simple table in a
+ * database.  Relations are not ordered.  This data type is meant for
+ * maintaining a N-way mapping.
+ *
+ * g_relation_new() creates a relation with FIELDS fields
+ *
+ * g_relation_destroy() frees all resources
+ * g_tuples_destroy() frees the result of g_relation_select()
+ *
+ * g_relation_index() indexes relation FIELD with the provided
+ *   equality and hash functions.  this must be done before any
+ *   calls to insert are made.
+ *
+ * g_relation_insert() inserts a new tuple.  you are expected to
+ *   provide the right number of fields.
+ *
+ * g_relation_delete() deletes all relations with KEY in FIELD
+ * g_relation_select() returns ...
+ * g_relation_count() counts ...
+ */
+
+GRelation* g_relation_new     (gint         fields);
+void       g_relation_destroy (GRelation   *relation);
+void       g_relation_index   (GRelation   *relation,
+                               gint         field,
+                               GHashFunc    hash_func,
+                               GCompareFunc key_compare_func);
+void       g_relation_insert  (GRelation   *relation,
+                               ...);
+gint       g_relation_delete  (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+GTuples*   g_relation_select  (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+gint       g_relation_count   (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+gboolean   g_relation_exists  (GRelation   *relation,
+                               ...);
+void       g_relation_print   (GRelation   *relation);
+
+void       g_tuples_destroy   (GTuples     *tuples);
+gpointer   g_tuples_index     (GTuples     *tuples,
+                               gint         index,
+                               gint         field);
+
+G_END_DECLS
+
+#endif /* __G_REL_H__ */
+
diff --git a/glib/gscanner.h b/glib/gscanner.h
new file mode 100644 (file)
index 0000000..8cee79b
--- /dev/null
@@ -0,0 +1,267 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_SCANNER_H__
+#define __G_SCANNER_H__
+
+#include <ghash.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GScanner       GScanner;
+typedef struct _GScannerConfig GScannerConfig;
+typedef union  _GTokenValue     GTokenValue;
+
+typedef void           (*GScannerMsgFunc)      (GScanner      *scanner,
+                                                gchar         *message,
+                                                gint           error);
+
+/* GScanner: Flexible lexical scanner for general purpose.
+ */
+
+/* Character sets */
+#define G_CSET_A_2_Z   "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+#define G_CSET_a_2_z   "abcdefghijklmnopqrstuvwxyz"
+#define G_CSET_DIGITS  "0123456789"
+#define G_CSET_LATINC  "\300\301\302\303\304\305\306"\
+                       "\307\310\311\312\313\314\315\316\317\320"\
+                       "\321\322\323\324\325\326"\
+                       "\330\331\332\333\334\335\336"
+#define G_CSET_LATINS  "\337\340\341\342\343\344\345\346"\
+                       "\347\350\351\352\353\354\355\356\357\360"\
+                       "\361\362\363\364\365\366"\
+                       "\370\371\372\373\374\375\376\377"
+
+/* Error types */
+typedef enum
+{
+  G_ERR_UNKNOWN,
+  G_ERR_UNEXP_EOF,
+  G_ERR_UNEXP_EOF_IN_STRING,
+  G_ERR_UNEXP_EOF_IN_COMMENT,
+  G_ERR_NON_DIGIT_IN_CONST,
+  G_ERR_DIGIT_RADIX,
+  G_ERR_FLOAT_RADIX,
+  G_ERR_FLOAT_MALFORMED
+} GErrorType;
+
+/* Token types */
+typedef enum
+{
+  G_TOKEN_EOF                  =   0,
+  
+  G_TOKEN_LEFT_PAREN           = '(',
+  G_TOKEN_RIGHT_PAREN          = ')',
+  G_TOKEN_LEFT_CURLY           = '{',
+  G_TOKEN_RIGHT_CURLY          = '}',
+  G_TOKEN_LEFT_BRACE           = '[',
+  G_TOKEN_RIGHT_BRACE          = ']',
+  G_TOKEN_EQUAL_SIGN           = '=',
+  G_TOKEN_COMMA                        = ',',
+  
+  G_TOKEN_NONE                 = 256,
+  
+  G_TOKEN_ERROR,
+  
+  G_TOKEN_CHAR,
+  G_TOKEN_BINARY,
+  G_TOKEN_OCTAL,
+  G_TOKEN_INT,
+  G_TOKEN_HEX,
+  G_TOKEN_FLOAT,
+  G_TOKEN_STRING,
+  
+  G_TOKEN_SYMBOL,
+  G_TOKEN_IDENTIFIER,
+  G_TOKEN_IDENTIFIER_NULL,
+  
+  G_TOKEN_COMMENT_SINGLE,
+  G_TOKEN_COMMENT_MULTI,
+  G_TOKEN_LAST
+} GTokenType;
+
+union  _GTokenValue
+{
+  gpointer     v_symbol;
+  gchar                *v_identifier;
+  gulong       v_binary;
+  gulong       v_octal;
+  gulong       v_int;
+  gdouble      v_float;
+  gulong       v_hex;
+  gchar                *v_string;
+  gchar                *v_comment;
+  guchar       v_char;
+  guint                v_error;
+};
+
+struct _GScannerConfig
+{
+  /* Character sets
+   */
+  gchar                *cset_skip_characters;          /* default: " \t\n" */
+  gchar                *cset_identifier_first;
+  gchar                *cset_identifier_nth;
+  gchar                *cpair_comment_single;          /* default: "#\n" */
+  
+  /* Should symbol lookup work case sensitive?
+   */
+  guint                case_sensitive : 1;
+  
+  /* Boolean values to be adjusted "on the fly"
+   * to configure scanning behaviour.
+   */
+  guint                skip_comment_multi : 1;         /* C like comment */
+  guint                skip_comment_single : 1;        /* single line comment */
+  guint                scan_comment_multi : 1;         /* scan multi line comments? */
+  guint                scan_identifier : 1;
+  guint                scan_identifier_1char : 1;
+  guint                scan_identifier_NULL : 1;
+  guint                scan_symbols : 1;
+  guint                scan_binary : 1;
+  guint                scan_octal : 1;
+  guint                scan_float : 1;
+  guint                scan_hex : 1;                   /* `0x0ff0' */
+  guint                scan_hex_dollar : 1;            /* `$0ff0' */
+  guint                scan_string_sq : 1;             /* string: 'anything' */
+  guint                scan_string_dq : 1;             /* string: "\\-escapes!\n" */
+  guint                numbers_2_int : 1;              /* bin, octal, hex => int */
+  guint                int_2_float : 1;                /* int => G_TOKEN_FLOAT? */
+  guint                identifier_2_string : 1;
+  guint                char_2_token : 1;               /* return G_TOKEN_CHAR? */
+  guint                symbol_2_token : 1;
+  guint                scope_0_fallback : 1;           /* try scope 0 on lookups? */
+};
+
+struct _GScanner
+{
+  /* unused fields */
+  gpointer             user_data;
+  guint                        max_parse_errors;
+  
+  /* g_scanner_error() increments this field */
+  guint                        parse_errors;
+  
+  /* name of input stream, featured by the default message handler */
+  const gchar          *input_name;
+  
+  /* data pointer for derived structures */
+  gpointer             derived_data;
+  
+  /* link into the scanner configuration */
+  GScannerConfig       *config;
+  
+  /* fields filled in after g_scanner_get_next_token() */
+  GTokenType           token;
+  GTokenValue          value;
+  guint                        line;
+  guint                        position;
+  
+  /* fields filled in after g_scanner_peek_next_token() */
+  GTokenType           next_token;
+  GTokenValue          next_value;
+  guint                        next_line;
+  guint                        next_position;
+  
+  /* to be considered private */
+  GHashTable           *symbol_table;
+  gint                 input_fd;
+  const gchar          *text;
+  const gchar          *text_end;
+  gchar                        *buffer;
+  guint                        scope_id;
+  
+  /* handler function for _warn and _error */
+  GScannerMsgFunc      msg_handler;
+};
+
+GScanner*      g_scanner_new                   (GScannerConfig *config_templ);
+void           g_scanner_destroy               (GScanner       *scanner);
+void           g_scanner_input_file            (GScanner       *scanner,
+                                                gint           input_fd);
+void           g_scanner_sync_file_offset      (GScanner       *scanner);
+void           g_scanner_input_text            (GScanner       *scanner,
+                                                const  gchar   *text,
+                                                guint          text_len);
+GTokenType     g_scanner_get_next_token        (GScanner       *scanner);
+GTokenType     g_scanner_peek_next_token       (GScanner       *scanner);
+GTokenType     g_scanner_cur_token             (GScanner       *scanner);
+GTokenValue    g_scanner_cur_value             (GScanner       *scanner);
+guint          g_scanner_cur_line              (GScanner       *scanner);
+guint          g_scanner_cur_position          (GScanner       *scanner);
+gboolean       g_scanner_eof                   (GScanner       *scanner);
+guint          g_scanner_set_scope             (GScanner       *scanner,
+                                                guint           scope_id);
+void           g_scanner_scope_add_symbol      (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol,
+                                                gpointer       value);
+void           g_scanner_scope_remove_symbol   (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol);
+gpointer       g_scanner_scope_lookup_symbol   (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol);
+void           g_scanner_scope_foreach_symbol  (GScanner       *scanner,
+                                                guint           scope_id,
+                                                GHFunc          func,
+                                                gpointer        user_data);
+gpointer       g_scanner_lookup_symbol         (GScanner       *scanner,
+                                                const gchar    *symbol);
+void           g_scanner_unexp_token           (GScanner       *scanner,
+                                                GTokenType     expected_token,
+                                                const gchar    *identifier_spec,
+                                                const gchar    *symbol_spec,
+                                                const gchar    *symbol_name,
+                                                const gchar    *message,
+                                                gint            is_error);
+void           g_scanner_error                 (GScanner       *scanner,
+                                                const gchar    *format,
+                                                ...) G_GNUC_PRINTF (2,3);
+void           g_scanner_warn                  (GScanner       *scanner,
+                                                const gchar    *format,
+                                                ...) G_GNUC_PRINTF (2,3);
+gint           g_scanner_stat_mode             (const gchar    *filename);
+/* keep downward source compatibility */
+#define                g_scanner_add_symbol( scanner, symbol, value )  G_STMT_START { \
+  g_scanner_scope_add_symbol ((scanner), 0, (symbol), (value)); \
+} G_STMT_END
+#define                g_scanner_remove_symbol( scanner, symbol )      G_STMT_START { \
+  g_scanner_scope_remove_symbol ((scanner), 0, (symbol)); \
+} G_STMT_END
+#define                g_scanner_foreach_symbol( scanner, func, data ) G_STMT_START { \
+  g_scanner_scope_foreach_symbol ((scanner), 0, (func), (data)); \
+} G_STMT_END
+
+/* The following two functions are deprecated and will be removed in
+ * the next major release. They do no good. */
+void           g_scanner_freeze_symbol_table   (GScanner       *scanner);
+void           g_scanner_thaw_symbol_table     (GScanner       *scanner);
+
+G_END_DECLS
+
+#endif /* __G_SCANNER_H__ */
+
index 0f7fd1f..4f08c24 100644 (file)
  * Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GSHELL_H__
-#define __GSHELL_H__
+#ifndef __G_SHELL_H__
+#define __G_SHELL_H__
 
 #include <gerror.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 #define G_SHELL_ERROR g_shell_error_quark ()
 
@@ -49,11 +46,8 @@ gboolean g_shell_parse_argv (const gchar   *command_line,
                              gchar       ***argv,
                              GError       **error);
 
+G_END_DECLS
 
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* __GSHELL_H__ */
+#endif /* __G_SHELL_H__ */
 
 
diff --git a/glib/gslist.h b/glib/gslist.h
new file mode 100644 (file)
index 0000000..904f044
--- /dev/null
@@ -0,0 +1,97 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_SLIST_H__
+#define __G_SLIST_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GSList         GSList;
+
+struct _GSList
+{
+  gpointer data;
+  GSList *next;
+};
+
+/* Singly linked lists
+ */
+void    g_slist_push_allocator  (GAllocator     *allocator);
+void    g_slist_pop_allocator   (void);
+GSList* g_slist_alloc          (void);
+void   g_slist_free            (GSList         *list);
+void   g_slist_free_1          (GSList         *list);
+GSList* g_slist_append         (GSList         *list,
+                                gpointer        data);
+GSList* g_slist_prepend                (GSList         *list,
+                                gpointer        data);
+GSList* g_slist_insert         (GSList         *list,
+                                gpointer        data,
+                                gint            position);
+GSList* g_slist_insert_sorted  (GSList         *list,
+                                gpointer        data,
+                                GCompareFunc    func);
+GSList* g_slist_insert_before   (GSList         *slist,
+                                GSList         *sibling,
+                                gpointer        data);
+GSList* g_slist_concat         (GSList         *list1,
+                                GSList         *list2);
+GSList* g_slist_remove         (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_remove_link    (GSList         *list,
+                                GSList         *link);
+GSList* g_slist_delete_link     (GSList         *list,
+                                GSList         *link);
+GSList* g_slist_reverse                (GSList         *list);
+GSList*        g_slist_copy            (GSList         *list);
+GSList* g_slist_nth            (GSList         *list,
+                                guint           n);
+GSList* g_slist_find           (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_find_custom    (GSList         *list,
+                                gconstpointer   data,
+                                GCompareFunc    func);
+gint   g_slist_position        (GSList         *list,
+                                GSList         *llink);
+gint   g_slist_index           (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_last           (GSList         *list);
+guint  g_slist_length          (GSList         *list);
+void   g_slist_foreach         (GSList         *list,
+                                GFunc           func,
+                                gpointer        user_data);
+GSList*  g_slist_sort           (GSList          *list,
+                                GCompareFunc    compare_func);
+gpointer g_slist_nth_data      (GSList         *list,
+                                guint           n);
+#define  g_slist_next(slist)   ((slist) ? (((GSList *)(slist))->next) : NULL)
+
+G_END_DECLS
+
+#endif /* __G_SLIST_H__ */
+
index 4ae0536..57530cb 100644 (file)
  * Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GSPAWN_H__
-#define __GSPAWN_H__
+#ifndef __G_SPAWN_H__
+#define __G_SPAWN_H__
 
 #include <gerror.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 /* I'm not sure I remember our proposed naming convention here. */
 #define G_SPAWN_ERROR g_spawn_error_quark ()
@@ -123,10 +120,8 @@ gboolean g_spawn_command_line_async (const gchar          *command_line,
                                      GError              **error);
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GSPAWN_H__ */
+#endif /* __G_SPAWN_H__ */
 
 
diff --git a/glib/gstrfuncs.h b/glib/gstrfuncs.h
new file mode 100644 (file)
index 0000000..ffec17e
--- /dev/null
@@ -0,0 +1,128 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_STRFUNCS_H__
+#define __G_STRFUNCS_H__
+
+#include <stdarg.h>
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* String utility functions that modify a string argument or
+ * return a constant string that must not be freed.
+ */
+#define         G_STR_DELIMITERS       "_-|> <."
+gchar*  g_strdelimit           (gchar       *string,
+                                const gchar *delimiters,
+                                gchar        new_delimiter);
+gchar*  g_strcanon             (gchar       *string,
+                                const gchar *valid_chars,
+                                gchar        subsitutor);
+gdouble         g_strtod               (const gchar *nptr,
+                                gchar      **endptr);
+gchar*  g_strerror             (gint         errnum) G_GNUC_CONST;
+gchar*  g_strsignal            (gint         signum) G_GNUC_CONST;
+gint    g_strcasecmp           (const gchar *s1,
+                                const gchar *s2);
+gint    g_strncasecmp          (const gchar *s1,
+                                const gchar *s2,
+                                guint        n);
+gchar*  g_strdown              (gchar       *string);
+gchar*  g_strup                (gchar       *string);
+gchar*  g_strreverse           (gchar       *string);
+gsize   g_strlcpy              (gchar       *dest,
+                                const gchar *src,
+                                gsize        dest_size);
+gsize   g_strlcat              (gchar       *dest,
+                                const gchar *src,
+                                gsize        dest_size);
+/* removes leading spaces */
+gchar*   g_strchug              (gchar        *string);
+/* removes trailing spaces */
+gchar*  g_strchomp              (gchar        *string);
+/* removes leading & trailing spaces */
+#define g_strstrip( string )   g_strchomp (g_strchug (string))
+
+/* String utility functions that return a newly allocated string which
+ * ought to be freed with g_free from the caller at some point.
+ */
+gchar*  g_strdup               (const gchar *str);
+gchar*  g_strdup_printf        (const gchar *format,
+                                ...) G_GNUC_PRINTF (1, 2);
+gchar*  g_strdup_vprintf       (const gchar *format,
+                                va_list      args);
+gchar*  g_strndup              (const gchar *str,
+                                guint        n);
+gchar*  g_strnfill             (guint        length,
+                                gchar        fill_char);
+gchar*  g_strconcat            (const gchar *string1,
+                                ...); /* NULL terminated */
+gchar*   g_strjoin             (const gchar  *separator,
+                                ...); /* NULL terminated */
+/* Make a copy of a string interpreting C string -style escape
+ * sequences. Inverse of g_strescape. The recognized sequences are \b
+ * \f \n \r \t \\ \" and the octal format.
+ */
+gchar*   g_strcompress         (const gchar *source);
+
+/* Copy a string escaping nonprintable characters like in C strings.
+ * Inverse of g_strcompress. The exceptions parameter, if non-NULL, points
+ * to a string containing characters that are not to be escaped.
+ *
+ * Deprecated API: gchar* g_strescape (const gchar *source);
+ * Luckily this function wasn't used much, using NULL as second parameter
+ * provides mostly identical semantics.
+ */
+gchar*   g_strescape           (const gchar *source,
+                                const gchar *exceptions);
+
+gpointer g_memdup              (gconstpointer mem,
+                                guint         byte_size);
+
+/* Convert between the operating system (or C runtime)
+ * representation of file names and UTF-8.
+ */
+gchar*   g_filename_to_utf8 (const gchar *opsysstring);
+gchar*   g_filename_from_utf8 (const gchar *utf8string);
+
+/* NULL terminated string arrays.
+ * g_strsplit() splits up string into max_tokens tokens at delim and
+ * returns a newly allocated string array.
+ * g_strjoinv() concatenates all of str_array's strings, sliding in an
+ * optional separator, the returned string is newly allocated.
+ * g_strfreev() frees the array itself and all of its strings.
+ */
+gchar**         g_strsplit             (const gchar  *string,
+                                const gchar  *delimiter,
+                                gint          max_tokens);
+gchar*   g_strjoinv            (const gchar  *separator,
+                                gchar       **str_array);
+void     g_strfreev            (gchar       **str_array);
+
+G_END_DECLS
+
+#endif /* __G_STRFUNCS_H__ */
diff --git a/glib/gstring.h b/glib/gstring.h
new file mode 100644 (file)
index 0000000..4a95575
--- /dev/null
@@ -0,0 +1,105 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_STRING_H__
+#define __G_STRING_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GString                GString;
+typedef struct _GStringChunk   GStringChunk;
+
+struct _GString
+{
+  gchar *str;
+  gint len;
+};
+
+/* String Chunks
+ */
+GStringChunk* g_string_chunk_new          (gint size);
+void         g_string_chunk_free          (GStringChunk *chunk);
+gchar*       g_string_chunk_insert        (GStringChunk *chunk,
+                                           const gchar  *string);
+gchar*       g_string_chunk_insert_const  (GStringChunk *chunk,
+                                           const gchar  *string);
+
+
+/* Strings
+ */
+GString*     g_string_new              (const gchar     *init);
+GString*     g_string_sized_new         (guint           dfl_size);
+gchar*      g_string_free              (GString         *string,
+                                        gboolean         free_segment);
+gboolean     g_string_equal             (const GString  *v,
+                                        const GString   *v2);
+guint        g_string_hash              (const GString   *str);
+GString*     g_string_assign            (GString        *string,
+                                        const gchar     *rval);
+GString*     g_string_truncate          (GString        *string,
+                                        guint            len);
+GString*     g_string_insert_len        (GString         *string,
+                                         gint             pos,
+                                         const gchar     *val,
+                                         gint             len);
+GString*     g_string_append            (GString        *string,
+                                        const gchar     *val);
+GString*     g_string_append_len        (GString        *string,
+                                        const gchar     *val,
+                                         gint             len);
+GString*     g_string_append_c          (GString        *string,
+                                        gchar            c);
+GString*     g_string_prepend           (GString        *string,
+                                        const gchar     *val);
+GString*     g_string_prepend_c         (GString        *string,
+                                        gchar            c);
+GString*     g_string_prepend_len       (GString        *string,
+                                        const gchar     *val,
+                                         gint             len);
+GString*     g_string_insert            (GString        *string,
+                                        gint             pos,
+                                        const gchar     *val);
+GString*     g_string_insert_c          (GString        *string,
+                                        gint             pos,
+                                        gchar            c);
+GString*     g_string_erase            (GString         *string,
+                                        gint             pos,
+                                        gint             len);
+GString*     g_string_down              (GString        *string);
+GString*     g_string_up                (GString        *string);
+void         g_string_sprintf           (GString        *string,
+                                        const gchar     *format,
+                                        ...) G_GNUC_PRINTF (2, 3);
+void         g_string_sprintfa          (GString        *string,
+                                        const gchar     *format,
+                                        ...) G_GNUC_PRINTF (2, 3);
+
+G_END_DECLS
+
+#endif /* __G_STRING_H__ */
+
diff --git a/glib/gthread.h b/glib/gthread.h
new file mode 100644 (file)
index 0000000..68c638c
--- /dev/null
@@ -0,0 +1,331 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_THREAD_H__
+#define __G_THREAD_H__
+
+#include <gerror.h>
+#include <gmain.h>
+
+G_BEGIN_DECLS
+
+#ifndef GLIB_VAR
+#  ifdef G_OS_WIN32
+#    ifdef GLIB_COMPILATION
+#      define GLIB_VAR __declspec(dllexport)
+#    else /* !GLIB_COMPILATION */
+#      define GLIB_VAR extern __declspec(dllimport)
+#    endif /* !GLIB_COMPILATION */
+#  else /* !G_OS_WIN32 */
+#    define GLIB_VAR extern
+#  endif /* !G_OS_WIN32 */
+#endif /* GLIB_VAR */
+
+/* GLib Thread support
+ */
+
+extern GQuark g_thread_error_quark();
+#define G_THREAD_ERROR g_thread_error_quark()
+
+typedef enum
+{
+  G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */
+} GThreadError;
+
+typedef void            (*GThreadFunc)          (gpointer       value);
+
+typedef enum
+{
+  G_THREAD_PRIORITY_LOW,
+  G_THREAD_PRIORITY_NORMAL,
+  G_THREAD_PRIORITY_HIGH,
+  G_THREAD_PRIORITY_URGENT
+} GThreadPriority;
+
+typedef struct _GThread         GThread;
+struct  _GThread
+{
+  GThreadPriority priority;
+  gboolean bound;
+  gboolean joinable;
+};
+
+typedef struct _GMutex          GMutex;
+typedef struct _GCond           GCond;
+typedef struct _GPrivate        GPrivate;
+typedef struct _GStaticPrivate  GStaticPrivate;
+
+typedef struct _GThreadFunctions GThreadFunctions;
+struct _GThreadFunctions
+{
+  GMutex*  (*mutex_new)           (void);
+  void     (*mutex_lock)          (GMutex               *mutex);
+  gboolean (*mutex_trylock)       (GMutex               *mutex);
+  void     (*mutex_unlock)        (GMutex               *mutex);
+  void     (*mutex_free)          (GMutex               *mutex);
+  GCond*   (*cond_new)            (void);
+  void     (*cond_signal)         (GCond                *cond);
+  void     (*cond_broadcast)      (GCond                *cond);
+  void     (*cond_wait)           (GCond                *cond,
+                                   GMutex               *mutex);
+  gboolean (*cond_timed_wait)     (GCond                *cond,
+                                   GMutex               *mutex,
+                                   GTimeVal             *end_time);
+  void      (*cond_free)          (GCond                *cond);
+  GPrivate* (*private_new)        (GDestroyNotify        destructor);
+  gpointer  (*private_get)        (GPrivate             *private_key);
+  void      (*private_set)        (GPrivate             *private_key,
+                                   gpointer              data);
+  void      (*thread_create)      (GThreadFunc           thread_func,
+                                   gpointer              arg,
+                                   gulong                stack_size,
+                                   gboolean              joinable,
+                                   gboolean              bound,
+                                   GThreadPriority       priority,
+                                   gpointer              thread,
+                                   GError              **error);
+  void      (*thread_yield)       (void);
+  void      (*thread_join)        (gpointer              thread);
+  void      (*thread_exit)        (void);
+  void      (*thread_set_priority)(gpointer              thread,
+                                   GThreadPriority       priority);
+  void      (*thread_self)        (gpointer              thread);
+};
+
+GLIB_VAR GThreadFunctions       g_thread_functions_for_glib_use;
+GLIB_VAR gboolean               g_thread_use_default_impl;
+GLIB_VAR gboolean               g_threads_got_initialized;
+
+/* initializes the mutex/cond/private implementation for glib, might
+ * only be called once, and must not be called directly or indirectly
+ * from another glib-function, e.g. as a callback.
+ */
+void    g_thread_init   (GThreadFunctions       *vtable);
+
+/* Errorcheck mutexes. If you define G_ERRORCHECK_MUTEXES, then all
+ * mutexes will check for re-locking and re-unlocking */
+
+/* Initialize thread system with errorcheck mutexes. vtable must be
+ * NULL.Do not call directly. Use #define G_ERRORCHECK_MUTEXES
+ * instead.
+ */
+void    g_thread_init_with_errorcheck_mutexes (GThreadFunctions* vtable);
+
+/* A random number to recognize debug calls to g_mutex_... */
+#define G_MUTEX_DEBUG_MAGIC 0xf8e18ad7
+
+#ifdef G_ERRORCHECK_MUTEXES
+#define g_thread_init(vtable) g_thread_init_with_errorcheck_mutexes (vtable)
+#endif
+
+/* internal function for fallback static mutex implementation */
+GMutex* g_static_mutex_get_mutex_impl   (GMutex **mutex);
+
+/* shorthands for conditional and unconditional function calls */
+#define G_THREAD_UF(op, arglist) \
+    (*g_thread_functions_for_glib_use . op) arglist
+#define G_THREAD_CF(op, fail, arg) \
+    (g_thread_supported () ? G_THREAD_UF (op, arg) : (fail))
+#define G_THREAD_ECF(op, fail, mutex, name, type)                       \
+    (g_thread_supported () ?                                            \
+     ((type(*)(GMutex*, gulong, gchar*, gchar*))                        \
+      (*g_thread_functions_for_glib_use . op))                          \
+     (mutex, G_MUTEX_DEBUG_MAGIC, G_STRINGIFY (name),  G_STRLOC) : (fail))
+#ifndef G_ERRORCHECK_MUTEXES
+#define g_mutex_lock_with_debug_name(mutex, name)                       \
+  G_THREAD_CF (mutex_lock,     (void)0, (mutex))
+#define g_mutex_trylock_with_debug_name(mutex, name)                    \
+   G_THREAD_CF (mutex_trylock,  TRUE,    (mutex))
+#define g_mutex_unlock_with_debug_name(mutex, name)                     \
+   G_THREAD_CF (mutex_unlock,   (void)0, (mutex))
+#else /* G_ERRORCHECK_MUTEXES */
+#define g_mutex_lock_with_debug_name(mutex, name)                       \
+  G_THREAD_ECF (mutex_lock,    (void)0, mutex, name, void)
+#define g_mutex_trylock_with_debug_name(mutex, name)                    \
+  G_THREAD_ECF (mutex_trylock, TRUE,    mutex, name, gboolean)
+#define g_mutex_unlock_with_debug_name(mutex, name)                     \
+  G_THREAD_ECF (mutex_unlock,  (void)0, mutex, name, void)
+#endif /* G_ERRORCHECK_MUTEXES */
+
+#define g_thread_supported()    (g_threads_got_initialized)
+#define g_mutex_new()            G_THREAD_UF (mutex_new,      ())
+#define g_mutex_lock(mutex)      g_mutex_lock_with_debug_name(mutex, mutex)
+#define g_mutex_trylock(mutex)   g_mutex_trylock_with_debug_name(mutex, mutex)
+#define g_mutex_unlock(mutex)    g_mutex_unlock_with_debug_name(mutex, mutex)
+#define g_mutex_free(mutex)      G_THREAD_CF (mutex_free,     (void)0, (mutex))
+#define g_cond_new()             G_THREAD_UF (cond_new,       ())
+#define g_cond_signal(cond)      G_THREAD_CF (cond_signal,    (void)0, (cond))
+#define g_cond_broadcast(cond)   G_THREAD_CF (cond_broadcast, (void)0, (cond))
+#define g_cond_wait(cond, mutex) G_THREAD_CF (cond_wait,      (void)0, (cond, \
+                                                                        mutex))
+#define g_cond_free(cond)        G_THREAD_CF (cond_free,      (void)0, (cond))
+#define g_cond_timed_wait(cond, mutex, abs_time) G_THREAD_CF (cond_timed_wait, \
+                                                              TRUE, \
+                                                              (cond, mutex, \
+                                                               abs_time))
+#define g_private_new(destructor)         G_THREAD_UF (private_new, (destructor))
+#define g_private_get(private_key)        G_THREAD_CF (private_get, \
+                                                       ((gpointer)private_key), \
+                                                       (private_key))
+#define g_private_set(private_key, value) G_THREAD_CF (private_set, \
+                                                       (void) (private_key = \
+                                                        (GPrivate*) (value)), \
+                                                       (private_key, value))
+#define g_thread_yield()              G_THREAD_CF (thread_yield, (void)0, ())
+#define g_thread_exit()               G_THREAD_CF (thread_exit, (void)0, ())
+
+GThread* g_thread_create (GThreadFunc            thread_func,
+                          gpointer               arg,
+                          gulong                 stack_size,
+                          gboolean               joinable,
+                          gboolean               bound,
+                          GThreadPriority        priority,
+                          GError               **error);
+GThread* g_thread_self ();
+void g_thread_join (GThread *thread);
+void g_thread_set_priority (GThread         *thread,
+                            GThreadPriority  priority);
+
+/* GStaticMutexes can be statically initialized with the value
+ * G_STATIC_MUTEX_INIT, and then they can directly be used, that is
+ * much easier, than having to explicitly allocate the mutex before
+ * use
+ */
+#define g_static_mutex_lock(mutex) \
+    g_mutex_lock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+#define g_static_mutex_trylock(mutex) \
+    g_mutex_trylock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+#define g_static_mutex_unlock(mutex) \
+    g_mutex_unlock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+
+struct _GStaticPrivate
+{
+  guint index;
+};
+#define G_STATIC_PRIVATE_INIT { 0 }
+gpointer g_static_private_get (GStaticPrivate   *private_key);
+void     g_static_private_set (GStaticPrivate   *private_key,
+                               gpointer          data,
+                               GDestroyNotify    notify);
+gpointer g_static_private_get_for_thread (GStaticPrivate *private_key,
+                                          GThread        *thread);
+void g_static_private_set_for_thread (GStaticPrivate *private_key,
+                                      GThread        *thread,
+                                      gpointer        data,
+                                      GDestroyNotify  notify);
+
+typedef struct _GStaticRecMutex GStaticRecMutex;
+struct _GStaticRecMutex
+{
+  GStaticMutex mutex;
+  unsigned int depth;
+  GSystemThread owner;
+};
+
+#define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
+void     g_static_rec_mutex_lock        (GStaticRecMutex *mutex);
+gboolean g_static_rec_mutex_trylock     (GStaticRecMutex *mutex);
+void     g_static_rec_mutex_unlock      (GStaticRecMutex *mutex);
+void     g_static_rec_mutex_lock_full   (GStaticRecMutex *mutex,
+                                         guint            depth);
+guint    g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex);
+
+typedef struct _GStaticRWLock GStaticRWLock;
+struct _GStaticRWLock
+{
+  GStaticMutex mutex;
+  GCond *read_cond;
+  GCond *write_cond;
+  guint read_counter;
+  gboolean write;
+  guint want_to_write;
+};
+
+#define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, FALSE }
+
+void      g_static_rw_lock_reader_lock    (GStaticRWLock* lock);
+gboolean  g_static_rw_lock_reader_trylock (GStaticRWLock* lock);
+void      g_static_rw_lock_reader_unlock  (GStaticRWLock* lock);
+void      g_static_rw_lock_writer_lock    (GStaticRWLock* lock);
+gboolean  g_static_rw_lock_writer_trylock (GStaticRWLock* lock);
+void      g_static_rw_lock_writer_unlock  (GStaticRWLock* lock);
+void      g_static_rw_lock_free (GStaticRWLock* lock);
+
+/* these are some convenience macros that expand to nothing if GLib
+ * was configured with --disable-threads. for using StaticMutexes,
+ * you define them with G_LOCK_DEFINE_STATIC (name) or G_LOCK_DEFINE (name)
+ * if you need to export the mutex. With G_LOCK_EXTERN (name) you can
+ * declare such an globally defined lock. name is a unique identifier
+ * for the protected varibale or code portion. locking, testing and
+ * unlocking of such mutexes can be done with G_LOCK(), G_UNLOCK() and
+ * G_TRYLOCK() respectively.
+ */
+extern void glib_dummy_decl (void);
+#define G_LOCK_NAME(name)               g__ ## name ## _lock
+#ifdef  G_THREADS_ENABLED
+#  define G_LOCK_DEFINE_STATIC(name)    static G_LOCK_DEFINE (name)
+#  define G_LOCK_DEFINE(name)           \
+    GStaticMutex G_LOCK_NAME (name) = G_STATIC_MUTEX_INIT
+#  define G_LOCK_EXTERN(name)           extern GStaticMutex G_LOCK_NAME (name)
+
+#  ifdef G_DEBUG_LOCKS
+#    define G_LOCK(name)                G_STMT_START{             \
+        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                   \
+               "file %s: line %d (%s): locking: %s ",             \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name);                                            \
+        g_static_mutex_lock (&G_LOCK_NAME (name));                \
+     }G_STMT_END
+#    define G_UNLOCK(name)              G_STMT_START{             \
+        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                   \
+               "file %s: line %d (%s): unlocking: %s ",           \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name);                                            \
+       g_static_mutex_unlock (&G_LOCK_NAME (name));               \
+     }G_STMT_END
+#    define G_TRYLOCK(name)                                       \
+        (g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                  \
+               "file %s: line %d (%s): try locking: %s ",         \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name), g_static_mutex_trylock (&G_LOCK_NAME (name)))
+#  else  /* !G_DEBUG_LOCKS */
+#    define G_LOCK(name) g_static_mutex_lock       (&G_LOCK_NAME (name))
+#    define G_UNLOCK(name) g_static_mutex_unlock   (&G_LOCK_NAME (name))
+#    define G_TRYLOCK(name) g_static_mutex_trylock (&G_LOCK_NAME (name))
+#  endif /* !G_DEBUG_LOCKS */
+#else   /* !G_THREADS_ENABLED */
+#  define G_LOCK_DEFINE_STATIC(name)    extern void glib_dummy_decl (void)
+#  define G_LOCK_DEFINE(name)           extern void glib_dummy_decl (void)
+#  define G_LOCK_EXTERN(name)           extern void glib_dummy_decl (void)
+#  define G_LOCK(name)
+#  define G_UNLOCK(name)
+#  define G_TRYLOCK(name)               (TRUE)
+#endif  /* !G_THREADS_ENABLED */
+
+G_END_DECLS
+
+#endif /* __G_THREAD_H__ */
+
diff --git a/glib/gthreadpool.h b/glib/gthreadpool.h
new file mode 100644 (file)
index 0000000..d6fa87c
--- /dev/null
@@ -0,0 +1,108 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_THREADPOOL_H__
+#define __G_THREADPOOL_H__
+
+#include <gthread.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GThreadPool     GThreadPool;
+
+/* Thread Pools
+ */
+
+/* The real GThreadPool is bigger, so you may only create a thread
+ * pool with the constructor function */
+struct _GThreadPool
+{
+  GFunc thread_func;
+  gulong stack_size;
+  gboolean bound;
+  GThreadPriority priority;
+  gboolean exclusive;
+  gpointer user_data;
+};
+
+/* Get a thread pool with the function thread_func, at most max_threads may
+ * run at a time (max_threads == -1 means no limit), stack_size, bound,
+ * priority like in g_thread_create, exclusive == TRUE means, that the threads
+ * shouldn't be shared and that they will be prestarted (otherwise they are
+ * started, as needed) user_data is the 2nd argument to the thread_func */
+GThreadPool*    g_thread_pool_new             (GFunc            thread_func,
+                                               gint             max_threads,
+                                               gulong           stack_size,
+                                               gboolean         bound,
+                                               GThreadPriority  priority,
+                                               gboolean         exclusive,
+                                               gpointer         user_data,
+                                               GError         **error);
+
+/* Push new data into the thread pool. This task is assigned to a thread later
+ * (when the maximal number of threads is reached for that pool) or now
+ * (otherwise). If necessary a new thread will be started. The function
+ * returns immediatly */
+void            g_thread_pool_push            (GThreadPool     *pool,
+                                               gpointer         data,
+                                               GError         **error);
+
+/* Set the number of threads, which can run concurrently for that pool, -1
+ * means no limit. 0 means has the effect, that the pool won't process
+ * requests until the limit is set higher again */
+void            g_thread_pool_set_max_threads (GThreadPool     *pool,
+                                               gint             max_threads,
+                                               GError         **error);
+gint            g_thread_pool_get_max_threads (GThreadPool     *pool);
+
+/* Get the number of threads assigned to that pool. This number doesn't
+ * necessarily represent the number of working threads in that pool */
+guint           g_thread_pool_get_num_threads (GThreadPool     *pool);
+
+/* Get the number of unprocessed items in the pool */
+guint           g_thread_pool_unprocessed     (GThreadPool     *pool);
+
+/* Free the pool, immediate means, that all unprocessed items in the queue
+ * wont be processed, wait means, that the function doesn't return immediatly,
+ * but after all threads in the pool are ready processing items. immediate
+ * does however not mean, that threads are killed. */
+void            g_thread_pool_free            (GThreadPool     *pool,
+                                               gboolean         immediate,
+                                               gboolean         wait);
+
+/* Set the maximal number of unused threads before threads will be stopped by
+ * GLib, -1 means no limit */
+void            g_thread_pool_set_max_unused_threads (gint      max_threads);
+gint            g_thread_pool_get_max_unused_threads (void);
+guint           g_thread_pool_get_num_unused_threads (void);
+
+/* Stop all currently unused threads, but leave the limit untouched */
+void            g_thread_pool_stop_unused_threads    (void);
+
+G_END_DECLS
+
+#endif /* __G_THREADPOOL_H__ */
+
diff --git a/glib/gtimer.h b/glib/gtimer.h
new file mode 100644 (file)
index 0000000..533a778
--- /dev/null
@@ -0,0 +1,53 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TIMER_H__
+#define __G_TIMER_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Timer
+ */
+
+/* microseconds per second */
+typedef struct _GTimer         GTimer;
+
+#define G_USEC_PER_SEC 1000000
+
+GTimer* g_timer_new    (void);
+void   g_timer_destroy (GTimer  *timer);
+void   g_timer_start   (GTimer  *timer);
+void   g_timer_stop    (GTimer  *timer);
+void   g_timer_reset   (GTimer  *timer);
+gdouble g_timer_elapsed (GTimer         *timer,
+                        gulong  *microseconds);
+void    g_usleep        (gulong microseconds);
+
+G_END_DECLS
+
+#endif /* __G_TIMER_H__ */
diff --git a/glib/gtree.h b/glib/gtree.h
new file mode 100644 (file)
index 0000000..207d16c
--- /dev/null
@@ -0,0 +1,64 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TREE_H__
+#define __G_TREE_H__
+
+#include <gnode.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GTree          GTree;
+
+typedef gint           (*GTraverseFunc)        (gpointer       key,
+                                                gpointer       value,
+                                                gpointer       data);
+
+/* Balanced binary trees
+ */
+GTree*  g_tree_new      (GCompareFunc   key_compare_func);
+void    g_tree_destroy  (GTree         *tree);
+void    g_tree_insert   (GTree         *tree,
+                         gpointer       key,
+                         gpointer       value);
+void    g_tree_remove   (GTree         *tree,
+                         gconstpointer  key);
+gpointer g_tree_lookup  (GTree         *tree,
+                         gconstpointer  key);
+void    g_tree_traverse (GTree         *tree,
+                         GTraverseFunc  traverse_func,
+                         GTraverseType  traverse_type,
+                         gpointer       data);
+gpointer g_tree_search  (GTree         *tree,
+                         GCompareFunc   search_func,
+                         gconstpointer  data);
+gint    g_tree_height   (GTree         *tree);
+gint    g_tree_nnodes   (GTree         *tree);
+
+G_END_DECLS
+
+#endif /* __G_TREE_H__ */
+
diff --git a/glib/gtypes.h b/glib/gtypes.h
new file mode 100644 (file)
index 0000000..ac856a7
--- /dev/null
@@ -0,0 +1,314 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TYPES_H__
+#define __G_TYPES_H__
+
+#include <glibconfig.h>
+
+G_BEGIN_DECLS
+
+/* Provide type definitions for commonly used types.
+ *  These are useful because a "gint8" can be adjusted
+ *  to be 1 byte (8 bits) on all platforms. Similarly and
+ *  more importantly, "gint32" can be adjusted to be
+ *  4 bytes (32 bits) on all platforms.
+ */
+
+typedef char   gchar;
+typedef short  gshort;
+typedef long   glong;
+typedef int    gint;
+typedef gint   gboolean;
+typedef gchar* gstring;
+
+typedef unsigned char   guchar;
+typedef unsigned short  gushort;
+typedef unsigned long   gulong;
+typedef unsigned int    guint;
+
+typedef float   gfloat;
+typedef double  gdouble;
+
+/* HAVE_LONG_DOUBLE doesn't work correctly on all platforms.
+ * Since gldouble isn't used anywhere, just disable it for now */
+
+#if 0
+#ifdef HAVE_LONG_DOUBLE
+typedef long double gldouble;
+#else /* HAVE_LONG_DOUBLE */
+typedef double gldouble;
+#endif /* HAVE_LONG_DOUBLE */
+#endif /* 0 */
+
+typedef void* gpointer;
+typedef const void *gconstpointer;
+
+typedef gint            (*GCompareFunc)         (gconstpointer  a,
+                                                 gconstpointer  b);
+typedef void            (*GDestroyNotify)       (gpointer       data);
+typedef void            (*GFunc)                (gpointer       data,
+                                                 gpointer       user_data);
+typedef guint           (*GHashFunc)            (gconstpointer  key);
+typedef void            (*GHFunc)               (gpointer       key,
+                                                 gpointer       value,
+                                                 gpointer       user_data);
+
+/* Define some mathematical constants that aren't available
+ * symbolically in some strict ISO C implementations.
+ */
+#define G_E     2.7182818284590452354E0
+#define G_LN2   6.9314718055994530942E-1
+#define G_LN10  2.3025850929940456840E0
+#define G_PI    3.14159265358979323846E0
+#define G_PI_2  1.57079632679489661923E0
+#define G_PI_4  0.78539816339744830962E0
+#define G_SQRT2 1.4142135623730950488E0
+
+/* Portable endian checks and conversions
+ *
+ * glibconfig.h defines G_BYTE_ORDER which expands to one of
+ * the below macros.
+ */
+#define G_LITTLE_ENDIAN 1234
+#define G_BIG_ENDIAN    4321
+#define G_PDP_ENDIAN    3412           /* unused, need specific PDP check */   
+
+
+/* Basic bit swapping functions
+ */
+#define GUINT16_SWAP_LE_BE_CONSTANT(val)       ((guint16) ( \
+    (((guint16) (val) & (guint16) 0x00ffU) << 8) | \
+    (((guint16) (val) & (guint16) 0xff00U) >> 8)))
+#define GUINT32_SWAP_LE_BE_CONSTANT(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x000000ffU) << 24) | \
+    (((guint32) (val) & (guint32) 0x0000ff00U) <<  8) | \
+    (((guint32) (val) & (guint32) 0x00ff0000U) >>  8) | \
+    (((guint32) (val) & (guint32) 0xff000000U) >> 24)))
+
+/* Intel specific stuff for speed
+ */
+#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define GUINT16_SWAP_LE_BE_X86(val) \
+     (__extension__                                    \
+      ({ register guint16 __v;                         \
+        if (__builtin_constant_p (val))                \
+          __v = GUINT16_SWAP_LE_BE_CONSTANT (val);     \
+        else                                           \
+          __asm__ __const__ ("rorw $8, %w0"            \
+                             : "=r" (__v)              \
+                             : "0" ((guint16) (val))); \
+       __v; }))
+#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_X86 (val))
+#  if !defined(__i486__) && !defined(__i586__) \
+      && !defined(__pentium__) && !defined(__i686__) && !defined(__pentiumpro__)
+#     define GUINT32_SWAP_LE_BE_X86(val) \
+        (__extension__                                         \
+         ({ register guint32 __v;                              \
+           if (__builtin_constant_p (val))                     \
+             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
+         else                                                  \
+           __asm__ __const__ ("rorw $8, %w0\n\t"               \
+                              "rorl $16, %0\n\t"               \
+                              "rorw $8, %w0"                   \
+                              : "=r" (__v)                     \
+                              : "0" ((guint32) (val)));        \
+       __v; }))
+#  else /* 486 and higher has bswap */
+#     define GUINT32_SWAP_LE_BE_X86(val) \
+        (__extension__                                         \
+         ({ register guint32 __v;                              \
+           if (__builtin_constant_p (val))                     \
+             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
+         else                                                  \
+           __asm__ __const__ ("bswap %0"                       \
+                              : "=r" (__v)                     \
+                              : "0" ((guint32) (val)));        \
+       __v; }))
+#  endif /* processor specific 32-bit stuff */
+#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_X86 (val))
+#else /* !__i386__ */
+#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val))
+#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val))
+#endif /* __i386__ */
+
+#ifdef G_HAVE_GINT64
+#  define GUINT64_SWAP_LE_BE_CONSTANT(val)     ((guint64) ( \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00000000000000ffU)) << 56) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x000000000000ff00U)) << 40) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x0000000000ff0000U)) << 24) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00000000ff000000U)) <<  8) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x000000ff00000000U)) >>  8) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x0000ff0000000000U)) >> 24) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00ff000000000000U)) >> 40) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0xff00000000000000U)) >> 56)))
+#  if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#    define GUINT64_SWAP_LE_BE_X86(val) \
+       (__extension__                                          \
+        ({ union { guint64 __ll;                               \
+                   guint32 __l[2]; } __r;                      \
+           if (__builtin_constant_p (val))                     \
+             __r.__ll = GUINT64_SWAP_LE_BE_CONSTANT (val);     \
+           else                                                \
+             {                                                 \
+               union { guint64 __ll;                           \
+                       guint32 __l[2]; } __w;                  \
+               __w.__ll = ((guint64) val);                     \
+               __r.__l[0] = GUINT32_SWAP_LE_BE (__w.__l[1]);   \
+               __r.__l[1] = GUINT32_SWAP_LE_BE (__w.__l[0]);   \
+             }                                                 \
+         __r.__ll; }))
+#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_X86 (val))
+#  else /* !__i386__ */
+#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT(val))
+#  endif
+#endif
+
+#define GUINT16_SWAP_LE_PDP(val)       ((guint16) (val))
+#define GUINT16_SWAP_BE_PDP(val)       (GUINT16_SWAP_LE_BE (val))
+#define GUINT32_SWAP_LE_PDP(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x0000ffffU) << 16) | \
+    (((guint32) (val) & (guint32) 0xffff0000U) >> 16)))
+#define GUINT32_SWAP_BE_PDP(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x00ff00ffU) << 8) | \
+    (((guint32) (val) & (guint32) 0xff00ff00U) >> 8)))
+
+/* The G*_TO_?E() macros are defined in glibconfig.h.
+ * The transformation is symmetric, so the FROM just maps to the TO.
+ */
+#define GINT16_FROM_LE(val)    (GINT16_TO_LE (val))
+#define GUINT16_FROM_LE(val)   (GUINT16_TO_LE (val))
+#define GINT16_FROM_BE(val)    (GINT16_TO_BE (val))
+#define GUINT16_FROM_BE(val)   (GUINT16_TO_BE (val))
+#define GINT32_FROM_LE(val)    (GINT32_TO_LE (val))
+#define GUINT32_FROM_LE(val)   (GUINT32_TO_LE (val))
+#define GINT32_FROM_BE(val)    (GINT32_TO_BE (val))
+#define GUINT32_FROM_BE(val)   (GUINT32_TO_BE (val))
+
+#ifdef G_HAVE_GINT64
+#define GINT64_FROM_LE(val)    (GINT64_TO_LE (val))
+#define GUINT64_FROM_LE(val)   (GUINT64_TO_LE (val))
+#define GINT64_FROM_BE(val)    (GINT64_TO_BE (val))
+#define GUINT64_FROM_BE(val)   (GUINT64_TO_BE (val))
+#endif
+
+#define GLONG_FROM_LE(val)     (GLONG_TO_LE (val))
+#define GULONG_FROM_LE(val)    (GULONG_TO_LE (val))
+#define GLONG_FROM_BE(val)     (GLONG_TO_BE (val))
+#define GULONG_FROM_BE(val)    (GULONG_TO_BE (val))
+
+#define GINT_FROM_LE(val)      (GINT_TO_LE (val))
+#define GUINT_FROM_LE(val)     (GUINT_TO_LE (val))
+#define GINT_FROM_BE(val)      (GINT_TO_BE (val))
+#define GUINT_FROM_BE(val)     (GUINT_TO_BE (val))
+
+
+/* Portable versions of host-network order stuff
+ */
+#define g_ntohl(val) (GUINT32_FROM_BE (val))
+#define g_ntohs(val) (GUINT16_FROM_BE (val))
+#define g_htonl(val) (GUINT32_TO_BE (val))
+#define g_htons(val) (GUINT16_TO_BE (val))
+
+/* IEEE Standard 754 Single Precision Storage Format (gfloat):
+ *
+ *        31 30           23 22            0
+ * +--------+---------------+---------------+
+ * | s 1bit | e[30:23] 8bit | f[22:0] 23bit |
+ * +--------+---------------+---------------+
+ * B0------------------->B1------->B2-->B3-->
+ *
+ * IEEE Standard 754 Double Precision Storage Format (gdouble):
+ *
+ *        63 62            52 51            32   31            0
+ * +--------+----------------+----------------+ +---------------+
+ * | s 1bit | e[62:52] 11bit | f[51:32] 20bit | | f[31:0] 32bit |
+ * +--------+----------------+----------------+ +---------------+
+ * B0--------------->B1---------->B2--->B3---->  B4->B5->B6->B7->
+ */
+/* subtract from biased_exponent to form base2 exponent (normal numbers) */
+typedef union  _GDoubleIEEE754 GDoubleIEEE754;
+typedef union  _GFloatIEEE754  GFloatIEEE754;
+#define G_IEEE754_FLOAT_BIAS   (127)
+#define G_IEEE754_DOUBLE_BIAS  (1023)
+/* multiply with base2 exponent to get base10 exponent (nomal numbers) */
+#define G_LOG_2_BASE_10                (0.30102999566398119521)
+#if G_BYTE_ORDER == G_LITTLE_ENDIAN
+union _GFloatIEEE754
+{
+  gfloat v_float;
+  struct {
+    guint mantissa : 23;
+    guint biased_exponent : 8;
+    guint sign : 1;
+  } mpn;
+};
+union _GDoubleIEEE754
+{
+  gdouble v_double;
+  struct {
+    guint mantissa_low : 32;
+    guint mantissa_high : 20;
+    guint biased_exponent : 11;
+    guint sign : 1;
+  } mpn;
+};
+#elif G_BYTE_ORDER == G_BIG_ENDIAN
+union _GFloatIEEE754
+{
+  gfloat v_float;
+  struct {
+    guint sign : 1;
+    guint biased_exponent : 8;
+    guint mantissa : 23;
+  } mpn;
+};
+union _GDoubleIEEE754
+{
+  gdouble v_double;
+  struct {
+    guint sign : 1;
+    guint biased_exponent : 11;
+    guint mantissa_high : 20;
+    guint mantissa_low : 32;
+  } mpn;
+};
+#else /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
+#error unknown ENDIAN type
+#endif /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
+
+G_END_DECLS
+
+#endif /* __G_TYPES_H__ */
+
index 396c6bc..442784c 100644 (file)
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GUNICODE_H__
-#define __GUNICODE_H__
+#ifndef __G_UNICODE_H__
+#define __G_UNICODE_H__
 
 #include <stddef.h>      /* For size_t */
+#include <gtypes.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 typedef guint32 gunichar;
 typedef guint16 gunichar2;
@@ -193,8 +191,6 @@ gboolean g_utf8_validate (const gchar  *str,
                           gint          len,
                           const gchar **end);
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* GUNICODE_H */
+#endif /* __G_UNICODE_H__ */
diff --git a/glib/gutils.h b/glib/gutils.h
new file mode 100644 (file)
index 0000000..62cc215
--- /dev/null
@@ -0,0 +1,333 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_UTILS_H__
+#define __G_UTILS_H__
+
+#include <gtypes.h>
+#include <stdarg.h>
+
+G_BEGIN_DECLS
+
+#ifdef G_OS_WIN32
+
+/* On native Win32, directory separator is the backslash, and search path
+ * separator is the semicolon.
+ */
+#define G_DIR_SEPARATOR '\\'
+#define G_DIR_SEPARATOR_S "\\"
+#define G_SEARCHPATH_SEPARATOR ';'
+#define G_SEARCHPATH_SEPARATOR_S ";"
+
+#else  /* !G_OS_WIN32 */
+
+/* Unix */
+
+#define G_DIR_SEPARATOR '/'
+#define G_DIR_SEPARATOR_S "/"
+#define G_SEARCHPATH_SEPARATOR ':'
+#define G_SEARCHPATH_SEPARATOR_S ":"
+
+#endif /* !G_OS_WIN32 */
+
+/* Define G_VA_COPY() to do the right thing for copying va_list variables.
+ * glibconfig.h may have already defined G_VA_COPY as va_copy or __va_copy.
+ */
+#if !defined (G_VA_COPY)
+#  if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
+#    define G_VA_COPY(ap1, ap2)          (*(ap1) = *(ap2))
+#  elif defined (G_VA_COPY_AS_ARRAY)
+#    define G_VA_COPY(ap1, ap2)          g_memmove ((ap1), (ap2), sizeof (va_list))
+#  else /* va_list is a pointer */
+#    define G_VA_COPY(ap1, ap2)          ((ap1) = (ap2))
+#  endif /* va_list is a pointer */
+#endif /* !G_VA_COPY */
+
+/* inlining hassle. for compilers that don't allow the `inline' keyword,
+ * mostly because of strict ANSI C compliance or dumbness, we try to fall
+ * back to either `__inline__' or `__inline'.
+ * we define G_CAN_INLINE, if the compiler seems to be actually
+ * *capable* to do function inlining, in which case inline function bodys
+ * do make sense. we also define G_INLINE_FUNC to properly export the
+ * function prototypes if no inlining can be performed.
+ * inline function bodies have to be special cased with G_CAN_INLINE and a
+ * .c file specific macro to allow one compiled instance with extern linkage
+ * of the functions by defining G_IMPLEMENT_INLINES and the .c file macro.
+ */
+#ifdef G_IMPLEMENT_INLINES
+#  define G_INLINE_FUNC extern
+#  undef  G_CAN_INLINE
+#endif
+#ifndef G_INLINE_FUNC
+#  define G_CAN_INLINE 1
+#endif
+#if defined (G_HAVE_INLINE) && defined (__GNUC__) && defined (__STRICT_ANSI__)
+#  undef inline
+#  define inline __inline__
+#elif !defined (G_HAVE_INLINE)
+#  undef inline
+#  if defined (G_HAVE___INLINE__)
+#    define inline __inline__
+#  elif defined (G_HAVE___INLINE)
+#    define inline __inline
+#  else /* !inline && !__inline__ && !__inline */
+#    define inline  /* don't inline, then */
+#    ifndef G_INLINE_FUNC
+#      undef G_CAN_INLINE
+#    endif
+#  endif
+#endif
+#ifndef G_INLINE_FUNC
+#  if defined (__GNUC__) && (__OPTIMIZE__)
+#    define G_INLINE_FUNC extern inline
+#  elif defined (G_CAN_INLINE) && !defined (__GNUC__)
+#    define G_INLINE_FUNC static inline
+#  else /* can't inline */
+#    define G_INLINE_FUNC extern
+#    undef G_CAN_INLINE
+#  endif
+#endif /* !G_INLINE_FUNC */
+
+/* Retrive static string info
+ */
+gchar* g_get_user_name         (void);
+gchar* g_get_real_name         (void);
+gchar* g_get_home_dir          (void);
+gchar* g_get_tmp_dir           (void);
+gchar* g_get_prgname           (void);
+void   g_set_prgname           (const gchar *prgname);
+
+
+typedef struct _GDebugKey      GDebugKey;
+struct _GDebugKey
+{
+  gchar *key;
+  guint         value;
+};
+
+/* Miscellaneous utility functions
+ */
+guint  g_parse_debug_string    (const gchar *string,
+                                GDebugKey   *keys,
+                                guint        nkeys);
+gint   g_snprintf              (gchar       *string,
+                                gulong       n,
+                                gchar const *format,
+                                ...) G_GNUC_PRINTF (3, 4);
+gint   g_vsnprintf             (gchar       *string,
+                                gulong       n,
+                                gchar const *format,
+                                va_list      args);
+/* Check if a file name is an absolute path */
+gboolean g_path_is_absolute    (const gchar *file_name);
+/* In case of absolute paths, skip the root part */
+gchar*  g_path_skip_root       (gchar       *file_name);
+
+/* These two functions are deprecated and will be removed in the next
+ * major release of GLib. Use g_path_get_dirname/g_path_get_basename
+ * instead. Whatch out! The string returned by g_path_get_basename
+ * must be g_freed, while the string returned by g_basename must not.*/
+gchar* g_basename              (const gchar *file_name);
+gchar* g_dirname               (const gchar *file_name);
+
+/* The returned strings are newly allocated with g_malloc() */
+gchar* g_get_current_dir       (void);
+gchar* g_path_get_basename     (const gchar *file_name);
+gchar* g_path_get_dirname      (const gchar *file_name);
+
+/* Get the codeset for the current locale */
+/* gchar * g_get_codeset    (void); */
+
+/* return the environment string for the variable. The returned memory
+ * must not be freed. */
+gchar*  g_getenv               (const gchar *variable);
+
+
+/* we try to provide a usefull equivalent for ATEXIT if it is
+ * not defined, but use is actually abandoned. people should
+ * use g_atexit() instead.
+ */
+typedef        void            (*GVoidFunc)            (void);
+#ifndef ATEXIT
+# define ATEXIT(proc)  g_ATEXIT(proc)
+#else
+# define G_NATIVE_ATEXIT
+#endif /* ATEXIT */
+/* we use a GLib function as a replacement for ATEXIT, so
+ * the programmer is not required to check the return value
+ * (if there is any in the implementation) and doesn't encounter
+ * missing include files.
+ */
+void   g_atexit                (GVoidFunc    func);
+
+
+/* Bit tests
+ */
+G_INLINE_FUNC gint     g_bit_nth_lsf (guint32 mask,
+                                      gint    nth_bit);
+G_INLINE_FUNC gint     g_bit_nth_msf (guint32 mask,
+                                      gint    nth_bit);
+G_INLINE_FUNC guint    g_bit_storage (guint number);
+
+/* Trash Stacks
+ * elements need to be >= sizeof (gpointer)
+ */
+typedef struct _GTrashStack     GTrashStack;
+struct _GTrashStack
+{
+  GTrashStack *next;
+};
+
+G_INLINE_FUNC void     g_trash_stack_push      (GTrashStack **stack_p,
+                                                gpointer      data_p);
+G_INLINE_FUNC gpointer g_trash_stack_pop       (GTrashStack **stack_p);
+G_INLINE_FUNC gpointer g_trash_stack_peek      (GTrashStack **stack_p);
+G_INLINE_FUNC guint    g_trash_stack_height    (GTrashStack **stack_p);
+
+/* inline function implementations
+ */
+#if defined (G_CAN_INLINE) || defined (__G_UTILS_C__)
+G_INLINE_FUNC gint
+g_bit_nth_lsf (guint32 mask,
+              gint    nth_bit)
+{
+  do
+    {
+      nth_bit++;
+      if (mask & (1 << (guint) nth_bit))
+       return nth_bit;
+    }
+  while (nth_bit < 32);
+  return -1;
+}
+G_INLINE_FUNC gint
+g_bit_nth_msf (guint32 mask,
+              gint    nth_bit)
+{
+  if (nth_bit < 0)
+    nth_bit = 32;
+  do
+    {
+      nth_bit--;
+      if (mask & (1 << (guint) nth_bit))
+       return nth_bit;
+    }
+  while (nth_bit > 0);
+  return -1;
+}
+G_INLINE_FUNC guint
+g_bit_storage (guint number)
+{
+  register guint n_bits = 0;
+  
+  do
+    {
+      n_bits++;
+      number >>= 1;
+    }
+  while (number);
+  return n_bits;
+}
+G_INLINE_FUNC void
+g_trash_stack_push (GTrashStack **stack_p,
+                   gpointer      data_p)
+{
+  GTrashStack *data = (GTrashStack *) data_p;
+
+  data->next = *stack_p;
+  *stack_p = data;
+}
+G_INLINE_FUNC gpointer
+g_trash_stack_pop (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+
+  data = *stack_p;
+  if (data)
+    {
+      *stack_p = data->next;
+      /* NULLify private pointer here, most platforms store NULL as
+       * subsequent 0 bytes
+       */
+      data->next = NULL;
+    }
+
+  return data;
+}
+G_INLINE_FUNC gpointer
+g_trash_stack_peek (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+
+  data = *stack_p;
+
+  return data;
+}
+G_INLINE_FUNC guint
+g_trash_stack_height (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+  guint i = 0;
+
+  for (data = *stack_p; data; data = data->next)
+    i++;
+
+  return i;
+}
+#endif  /* G_CAN_INLINE || __G_UTILS_C__ */
+
+/* Glib version.
+ * we prefix variable declarations so they can
+ * properly get exported in windows dlls.
+ */
+#ifdef G_OS_WIN32
+#  ifdef GLIB_COMPILATION
+#    define GLIB_VAR __declspec(dllexport)
+#  else /* !GLIB_COMPILATION */
+#    define GLIB_VAR extern __declspec(dllimport)
+#  endif /* !GLIB_COMPILATION */
+#else /* !G_OS_WIN32 */
+#  define GLIB_VAR extern
+#endif /* !G_OS_WIN32 */
+
+GLIB_VAR const guint glib_major_version;
+GLIB_VAR const guint glib_minor_version;
+GLIB_VAR const guint glib_micro_version;
+GLIB_VAR const guint glib_interface_age;
+GLIB_VAR const guint glib_binary_age;
+
+#define GLIB_CHECK_VERSION(major,minor,micro)    \
+    (GLIB_MAJOR_VERSION > (major) || \
+     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \
+     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION == (minor) && \
+      GLIB_MICRO_VERSION >= (micro)))
+
+G_END_DECLS
+
+#endif /* __G_UTILS_H__ */
+
+
+
diff --git a/glist.h b/glist.h
new file mode 100644 (file)
index 0000000..ec160c8
--- /dev/null
+++ b/glist.h
@@ -0,0 +1,97 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_LIST_H__
+#define __G_LIST_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GList          GList;
+
+struct _GList
+{
+  gpointer data;
+  GList *next;
+  GList *prev;
+};
+
+/* Doubly linked lists
+ */
+void   g_list_push_allocator    (GAllocator     *allocator);
+void   g_list_pop_allocator     (void);
+GList* g_list_alloc            (void);
+void   g_list_free             (GList          *list);
+void   g_list_free_1           (GList          *list);
+GList* g_list_append           (GList          *list,
+                                gpointer        data);
+GList* g_list_prepend          (GList          *list,
+                                gpointer        data);
+GList* g_list_insert           (GList          *list,
+                                gpointer        data,
+                                gint            position);
+GList* g_list_insert_sorted    (GList          *list,
+                                gpointer        data,
+                                GCompareFunc    func);
+GList* g_list_concat           (GList          *list1,
+                                GList          *list2);
+GList* g_list_remove           (GList          *list,
+                                gconstpointer   data);
+GList* g_list_remove_link      (GList          *list,
+                                GList          *llink);
+GList* g_list_delete_link      (GList          *list,
+                                GList          *link);
+GList* g_list_reverse          (GList          *list);
+GList* g_list_copy             (GList          *list);
+GList* g_list_nth              (GList          *list,
+                                guint           n);
+GList* g_list_find             (GList          *list,
+                                gconstpointer   data);
+GList* g_list_find_custom      (GList          *list,
+                                gconstpointer   data,
+                                GCompareFunc    func);
+gint   g_list_position         (GList          *list,
+                                GList          *llink);
+gint   g_list_index            (GList          *list,
+                                gconstpointer   data);
+GList* g_list_last             (GList          *list);
+GList* g_list_first            (GList          *list);
+guint  g_list_length           (GList          *list);
+void   g_list_foreach          (GList          *list,
+                                GFunc           func,
+                                gpointer        user_data);
+GList* g_list_sort              (GList          *list,
+                                GCompareFunc    compare_func);
+gpointer g_list_nth_data       (GList          *list,
+                                guint           n);
+#define g_list_previous(list)  ((list) ? (((GList *)(list))->prev) : NULL)
+#define g_list_next(list)      ((list) ? (((GList *)(list))->next) : NULL)
+
+G_END_DECLS
+
+#endif /* __G_LIST_H__ */
+
diff --git a/gmacros.h b/gmacros.h
new file mode 100644 (file)
index 0000000..7033766
--- /dev/null
+++ b/gmacros.h
@@ -0,0 +1,178 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+/* This file must not include any other glib header file and must thus
+ * not refer to variables from glibconfig.h 
+ */
+
+#ifndef __G_MACROS_H__
+#define __G_MACROS_H__
+
+/* Here we provide G_GNUC_EXTENSION as an alias for __extension__,
+ * where this is valid. This allows for warningless compilation of
+ * "long long" types even in the presence of '-ansi -pedantic'. 
+ */
+#if     __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8)
+#  define G_GNUC_EXTENSION __extension__
+#else
+#  define G_GNUC_EXTENSION
+#endif
+
+/* Provide macros to feature the GCC function attribute.
+ */
+#if    __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
+#define G_GNUC_PURE                            \
+  __attribute__((pure))
+#else
+#define G_GNUC_PURE
+#endif
+
+#if     __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
+#define G_GNUC_PRINTF( format_idx, arg_idx )    \
+  __attribute__((format (printf, format_idx, arg_idx)))
+#define G_GNUC_SCANF( format_idx, arg_idx )     \
+  __attribute__((format (scanf, format_idx, arg_idx)))
+#define G_GNUC_FORMAT( arg_idx )                \
+  __attribute__((format_arg (arg_idx)))
+#define G_GNUC_NORETURN                         \
+  __attribute__((noreturn))
+#define G_GNUC_CONST                            \
+  __attribute__((const))
+#define G_GNUC_UNUSED                           \
+  __attribute__((unused))
+#else   /* !__GNUC__ */
+#define G_GNUC_PRINTF( format_idx, arg_idx )
+#define G_GNUC_SCANF( format_idx, arg_idx )
+#define G_GNUC_FORMAT( arg_idx )
+#define G_GNUC_NORETURN
+#define G_GNUC_CONST
+#define G_GNUC_UNUSED
+#endif  /* !__GNUC__ */
+
+/* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with
+ * macros, so we can refer to them as strings unconditionally.
+ */
+#ifdef  __GNUC__
+#define G_GNUC_FUNCTION         __FUNCTION__
+#define G_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__
+#else   /* !__GNUC__ */
+#define G_GNUC_FUNCTION         ""
+#define G_GNUC_PRETTY_FUNCTION  ""
+#endif  /* !__GNUC__ */
+
+#define G_STRINGIFY(macro_or_string)   G_STRINGIFY_ARG (macro_or_string)
+#define        G_STRINGIFY_ARG(contents)       #contents
+
+/* Provide a string identifying the current code position */
+#ifdef  __GNUC__
+#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()"
+#else
+#  define G_STRLOC     __FILE__ ":" G_STRINGIFY (__LINE__)
+#endif
+
+/* Guard C code in headers, while including them from C++ */
+#ifdef  __cplusplus
+# define G_BEGIN_DECLS  extern "C" {
+# define G_END_DECLS    }
+#else
+# define G_BEGIN_DECLS
+# define G_END_DECLS
+#endif
+
+/* Provide definitions for some commonly used macros.
+ *  Some of them are only provided if they haven't already
+ *  been defined. It is assumed that if they are already
+ *  defined then the current definition is correct.
+ */
+#ifndef NULL
+#  ifdef __cplusplus
+#    define NULL        (0L)
+#  else /* !__cplusplus */
+#    define NULL        ((void*) 0)
+#  endif /* !__cplusplus */
+#endif
+
+#ifndef        FALSE
+#define        FALSE   (0)
+#endif
+
+#ifndef        TRUE
+#define        TRUE    (!FALSE)
+#endif
+
+#undef MAX
+#define MAX(a, b)  (((a) > (b)) ? (a) : (b))
+
+#undef MIN
+#define MIN(a, b)  (((a) < (b)) ? (a) : (b))
+
+#undef ABS
+#define ABS(a)    (((a) < 0) ? -(a) : (a))
+
+#undef CLAMP
+#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
+
+/* Count the number of elements in an array. The array must be defined
+ * as such; using this with a dynamically allocated array will give
+ * incorrect results.
+ */
+#define G_N_ELEMENTS(arr)              (sizeof (arr) / sizeof ((arr)[0]))
+
+/* Provide convenience macros for handling structure
+ * fields through their offsets.
+ */
+#define G_STRUCT_OFFSET(struct_type, member)   \
+    ((glong) ((guint8*) &((struct_type*) 0)->member))
+#define G_STRUCT_MEMBER_P(struct_p, struct_offset)   \
+    ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset)))
+#define G_STRUCT_MEMBER(member_type, struct_p, struct_offset)   \
+    (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset)))
+
+/* Provide simple macro statement wrappers (adapted from Perl):
+ *  G_STMT_START { statements; } G_STMT_END;
+ *  can be used as a single statement, as in
+ *  if (x) G_STMT_START { ... } G_STMT_END; else ...
+ *
+ *  For gcc we will wrap the statements within `({' and `})' braces.
+ *  For SunOS they will be wrapped within `if (1)' and `else (void) 0',
+ *  and otherwise within `do' and `while (0)'.
+ */
+#if !(defined (G_STMT_START) && defined (G_STMT_END))
+#  if defined (__GNUC__) && !defined (__STRICT_ANSI__) && !defined (__cplusplus)
+#    define G_STMT_START       (void)(
+#    define G_STMT_END         )
+#  else
+#    if (defined (sun) || defined (__sun__))
+#      define G_STMT_START     if (1)
+#      define G_STMT_END       else (void)0
+#    else
+#      define G_STMT_START     do
+#      define G_STMT_END       while (0)
+#    endif
+#  endif
+#endif
+
+#endif /* __G_MACROS_H__ */
diff --git a/gmain.h b/gmain.h
new file mode 100644 (file)
index 0000000..7f08c3d
--- /dev/null
+++ b/gmain.h
@@ -0,0 +1,168 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MAIN_H__
+#define __G_MAIN_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Main loop
+ */
+typedef struct _GTimeVal        GTimeVal;
+typedef struct _GSourceFuncs    GSourceFuncs;
+typedef struct _GMainLoop       GMainLoop;      /* Opaque */
+
+struct _GTimeVal
+{
+  glong tv_sec;
+  glong tv_usec;
+};
+struct _GSourceFuncs
+{
+  gboolean (*prepare)  (gpointer  source_data,
+                        GTimeVal *current_time,
+                        gint     *timeout,
+                        gpointer  user_data);
+  gboolean (*check)    (gpointer  source_data,
+                        GTimeVal *current_time,
+                        gpointer  user_data);
+  gboolean (*dispatch) (gpointer  source_data,
+                        GTimeVal *dispatch_time,
+                        gpointer  user_data);
+  GDestroyNotify destroy;
+};
+
+/* Standard priorities */
+
+#define G_PRIORITY_HIGH            -100
+#define G_PRIORITY_DEFAULT          0
+#define G_PRIORITY_HIGH_IDLE        100
+#define G_PRIORITY_DEFAULT_IDLE     200
+#define G_PRIORITY_LOW              300
+
+typedef gboolean (*GSourceFunc) (gpointer data);
+
+/* Hooks for adding to the main loop */
+guint    g_source_add                        (gint           priority,
+                                              gboolean       can_recurse,
+                                              GSourceFuncs  *funcs,
+                                              gpointer       source_data,
+                                              gpointer       user_data,
+                                              GDestroyNotify notify);
+gboolean g_source_remove                     (guint          tag);
+gboolean g_source_remove_by_user_data        (gpointer       user_data);
+gboolean g_source_remove_by_source_data      (gpointer       source_data);
+gboolean g_source_remove_by_funcs_user_data  (GSourceFuncs  *funcs,
+                                              gpointer       user_data);
+
+void g_get_current_time                 (GTimeVal       *result);
+
+/* Running the main loop */
+GMainLoop*      g_main_new              (gboolean        is_running);
+void            g_main_run              (GMainLoop      *loop);
+void            g_main_quit             (GMainLoop      *loop);
+void            g_main_destroy          (GMainLoop      *loop);
+gboolean        g_main_is_running       (GMainLoop      *loop);
+
+/* Run a single iteration of the mainloop. If block is FALSE,
+ * will never block
+ */
+gboolean        g_main_iteration        (gboolean       may_block);
+
+/* See if any events are pending */
+gboolean        g_main_pending          (void);
+
+/* Idles and timeouts */
+guint           g_timeout_add_full      (gint           priority,
+                                         guint          interval,
+                                         GSourceFunc    function,
+                                         gpointer       data,
+                                         GDestroyNotify notify);
+guint           g_timeout_add           (guint          interval,
+                                         GSourceFunc    function,
+                                         gpointer       data);
+guint           g_idle_add              (GSourceFunc    function,
+                                         gpointer       data);
+guint           g_idle_add_full         (gint           priority,
+                                         GSourceFunc    function,
+                                         gpointer       data,
+                                         GDestroyNotify destroy);
+gboolean        g_idle_remove_by_data   (gpointer       data);
+
+/* GPollFD
+ *
+ * System-specific IO and main loop calls
+ *
+ * On Win32, the fd in a GPollFD should be Win32 HANDLE (*not* a file
+ * descriptor as provided by the C runtime) that can be used by
+ * MsgWaitForMultipleObjects. This does *not* include file handles
+ * from CreateFile, SOCKETs, nor pipe handles. (But you can use
+ * WSAEventSelect to signal events when a SOCKET is readable).
+ *
+ * On Win32, fd can also be the special value G_WIN32_MSG_HANDLE to
+ * indicate polling for messages. These message queue GPollFDs should
+ * be added with the g_main_poll_win32_msg_add function.
+ *
+ * But note that G_WIN32_MSG_HANDLE GPollFDs should not be used by GDK
+ * (GTK) programs, as GDK itself wants to read messages and convert them
+ * to GDK events.
+ *
+ * So, unless you really know what you are doing, it's best not to try
+ * to use the main loop polling stuff for your own needs on
+ * Win32. It's really only written for the GIMP's needs so
+ * far.
+ */
+
+typedef struct _GPollFD GPollFD;
+typedef gint    (*GPollFunc)    (GPollFD *ufds,
+                                 guint    nfsd,
+                                 gint     timeout);
+struct _GPollFD
+{
+  gint          fd;
+  gushort       events;
+  gushort       revents;
+};
+
+void        g_main_add_poll          (GPollFD    *fd,
+                                      gint        priority);
+void        g_main_remove_poll       (GPollFD    *fd);
+void        g_main_set_poll_func     (GPollFunc   func);
+
+#ifdef G_OS_WIN32
+
+/* Useful on other platforms, too? */
+
+GPollFunc   g_main_win32_get_poll_func (void);
+
+#endif
+
+G_END_DECLS
+
+#endif /* __G_MAIN_H__ */
+
diff --git a/gmem.h b/gmem.h
new file mode 100644 (file)
index 0000000..72e7b28
--- /dev/null
+++ b/gmem.h
@@ -0,0 +1,158 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MEM_H__
+#define __G_MEM_H__
+
+#include <gtypes.h>
+
+/* optionally feature DMALLOC memory allocation debugger
+ */
+#ifdef USE_DMALLOC
+#include "dmalloc.h"
+#endif
+
+G_BEGIN_DECLS
+
+typedef struct _GAllocator      GAllocator;
+typedef struct _GMemChunk       GMemChunk;
+
+/* Provide macros for easily allocating memory. The macros
+ *  will cast the allocated memory to the specified type
+ *  in order to avoid compiler warnings. (Makes the code neater).
+ */
+
+#ifdef __DMALLOC_H__
+#  define g_new(type, count)           (ALLOC (type, count))
+#  define g_new0(type, count)          (CALLOC (type, count))
+#  define g_renew(type, mem, count)    (REALLOC (mem, type, count))
+#else /* __DMALLOC_H__ */
+#  define g_new(type, count)     \
+      ((type *) g_malloc ((unsigned) sizeof (type) * (count)))
+#  define g_new0(type, count)    \
+      ((type *) g_malloc0 ((unsigned) sizeof (type) * (count)))
+#  define g_renew(type, mem, count)      \
+      ((type *) g_realloc (mem, (unsigned) sizeof (type) * (count)))
+#endif /* __DMALLOC_H__ */
+
+#define g_mem_chunk_create(type, pre_alloc, alloc_type)        ( \
+  g_mem_chunk_new (#type " mem chunks (" #pre_alloc ")", \
+                  sizeof (type), \
+                  sizeof (type) * (pre_alloc), \
+                  (alloc_type)) \
+)
+#define g_chunk_new(type, chunk)       ( \
+  (type *) g_mem_chunk_alloc (chunk) \
+)
+#define g_chunk_new0(type, chunk)      ( \
+  (type *) g_mem_chunk_alloc0 (chunk) \
+)
+#define g_chunk_free(mem, mem_chunk)   G_STMT_START { \
+  g_mem_chunk_free ((mem_chunk), (mem)); \
+} G_STMT_END
+
+/* Memory allocation and debugging
+ */
+#ifdef USE_DMALLOC
+
+#define g_malloc(size)      ((gpointer) MALLOC (size))
+#define g_malloc0(size)             ((gpointer) CALLOC (char, size))
+#define g_realloc(mem,size)  ((gpointer) REALLOC (mem, char, size))
+#define g_free(mem)         FREE (mem)
+
+#else /* !USE_DMALLOC */
+
+gpointer g_malloc      (gulong   size);
+gpointer g_malloc0     (gulong   size);
+gpointer g_realloc     (gpointer  mem,
+                       gulong    size);
+void    g_free        (gpointer  mem);
+
+#endif /* !USE_DMALLOC */
+
+void    g_mem_profile (void);
+void    g_mem_check   (gpointer  mem);
+
+/* Generic allocators
+ */
+GAllocator* g_allocator_new   (const gchar  *name,
+                              guint         n_preallocs);
+void        g_allocator_free  (GAllocator   *allocator);
+
+#define        G_ALLOCATOR_LIST        (1)
+#define        G_ALLOCATOR_SLIST       (2)
+#define        G_ALLOCATOR_NODE        (3)
+
+/* "g_mem_chunk_new" creates a new memory chunk.
+ * Memory chunks are used to allocate pieces of memory which are
+ *  always the same size. Lists are a good example of such a data type.
+ * The memory chunk allocates and frees blocks of memory as needed.
+ *  Just be sure to call "g_mem_chunk_free" and not "g_free" on data
+ *  allocated in a mem chunk. ("g_free" will most likely cause a seg
+ *  fault...somewhere).
+ *
+ * Oh yeah, GMemChunk is an opaque data type. (You don't really
+ *  want to know what's going on inside do you?)
+ */
+
+/* ALLOC_ONLY MemChunk's can only allocate memory. The free operation
+ *  is interpreted as a no op. ALLOC_ONLY MemChunk's save 4 bytes per
+ *  atom. (They are also useful for lists which use MemChunk to allocate
+ *  memory but are also part of the MemChunk implementation).
+ * ALLOC_AND_FREE MemChunk's can allocate and free memory.
+ */
+
+#define G_ALLOC_ONLY     1
+#define G_ALLOC_AND_FREE  2
+
+GMemChunk* g_mem_chunk_new     (gchar    *name,
+                               gint       atom_size,
+                               gulong     area_size,
+                               gint       type);
+void      g_mem_chunk_destroy (GMemChunk *mem_chunk);
+gpointer   g_mem_chunk_alloc   (GMemChunk *mem_chunk);
+gpointer   g_mem_chunk_alloc0  (GMemChunk *mem_chunk);
+void      g_mem_chunk_free    (GMemChunk *mem_chunk,
+                               gpointer   mem);
+void      g_mem_chunk_clean   (GMemChunk *mem_chunk);
+void      g_mem_chunk_reset   (GMemChunk *mem_chunk);
+void      g_mem_chunk_print   (GMemChunk *mem_chunk);
+void      g_mem_chunk_info    (void);
+
+/* Ah yes...we have a "g_blow_chunks" function.
+ * "g_blow_chunks" simply compresses all the chunks. This operation
+ *  consists of freeing every memory area that should be freed (but
+ *  which we haven't gotten around to doing yet). And, no,
+ *  "g_blow_chunks" doesn't follow the naming scheme, but it is a
+ *  much better name than "g_mem_chunk_clean_all" or something
+ *  similar.
+ */
+void g_blow_chunks (void);
+
+G_END_DECLS
+
+#endif /* __G_MEM_H__ */
+
diff --git a/gmessages.h b/gmessages.h
new file mode 100644 (file)
index 0000000..a33657f
--- /dev/null
@@ -0,0 +1,341 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_MESSAGES_H__
+#define __G_MESSAGES_H__
+
+#include <stdarg.h>
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* calculate a string size, guarranteed to fit format + args.
+ */
+guint  g_printf_string_upper_bound (const gchar* format,
+                                    va_list      args);
+
+/* Log level shift offset for user defined
+ * log levels (0-7 are used by GLib).
+ */
+#define G_LOG_LEVEL_USER_SHIFT  (8)
+
+/* Glib log levels and flags.
+ */
+typedef enum
+{
+  /* log flags */
+  G_LOG_FLAG_RECURSION          = 1 << 0,
+  G_LOG_FLAG_FATAL              = 1 << 1,
+
+  /* GLib log levels */
+  G_LOG_LEVEL_ERROR             = 1 << 2,       /* always fatal */
+  G_LOG_LEVEL_CRITICAL          = 1 << 3,
+  G_LOG_LEVEL_WARNING           = 1 << 4,
+  G_LOG_LEVEL_MESSAGE           = 1 << 5,
+  G_LOG_LEVEL_INFO              = 1 << 6,
+  G_LOG_LEVEL_DEBUG             = 1 << 7,
+
+  G_LOG_LEVEL_MASK              = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
+} GLogLevelFlags;
+
+/* GLib log levels that are considered fatal by default */
+#define G_LOG_FATAL_MASK        (G_LOG_FLAG_RECURSION | G_LOG_LEVEL_ERROR)
+
+typedef void            (*GLogFunc)             (const gchar   *log_domain,
+                                                 GLogLevelFlags log_level,
+                                                 const gchar   *message,
+                                                 gpointer       user_data);
+
+/* Logging mechanism
+ */
+extern          const gchar             *g_log_domain_glib;
+guint           g_log_set_handler       (const gchar    *log_domain,
+                                         GLogLevelFlags  log_levels,
+                                         GLogFunc        log_func,
+                                         gpointer        user_data);
+void            g_log_remove_handler    (const gchar    *log_domain,
+                                         guint           handler_id);
+void            g_log_default_handler   (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *message,
+                                         gpointer        unused_data);
+void            g_log                   (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *format,
+                                         ...) G_GNUC_PRINTF (3, 4);
+void            g_logv                  (const gchar    *log_domain,
+                                         GLogLevelFlags  log_level,
+                                         const gchar    *format,
+                                         va_list         args);
+GLogLevelFlags  g_log_set_fatal_mask    (const gchar    *log_domain,
+                                         GLogLevelFlags  fatal_mask);
+GLogLevelFlags  g_log_set_always_fatal  (GLogLevelFlags  fatal_mask);
+
+#ifndef G_LOG_DOMAIN
+#define G_LOG_DOMAIN    ((gchar*) 0)
+#endif  /* G_LOG_DOMAIN */
+#if defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
+#define g_error(...)    g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_ERROR,    \
+                               __VA_ARGS__)
+#define g_message(...)  g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_MESSAGE,  \
+                               __VA_ARGS__)
+#define g_critical(...) g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_CRITICAL, \
+                               __VA_ARGS__)
+#define g_warning(...)  g_log (G_LOG_DOMAIN,         \
+                               G_LOG_LEVEL_WARNING,  \
+                               __VA_ARGS__)
+#elif __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4)
+#define g_error(format...)      g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_ERROR,    \
+                                       format)
+#define g_message(format...)    g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_MESSAGE,  \
+                                       format)
+#define g_critical(format...)   g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_CRITICAL, \
+                                       format)
+#define g_warning(format...)    g_log (G_LOG_DOMAIN,         \
+                                       G_LOG_LEVEL_WARNING,  \
+                                       format)
+#else   /* !__GNUC__ */
+static void
+g_error (const gchar *format,
+         ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, args);
+  va_end (args);
+}
+static void
+g_message (const gchar *format,
+           ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, args);
+  va_end (args);
+}
+static void
+g_critical (const gchar *format,
+            ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, args);
+  va_end (args);
+}
+static void
+g_warning (const gchar *format,
+           ...)
+{
+  va_list args;
+  va_start (args, format);
+  g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, args);
+  va_end (args);
+}
+#endif  /* !__GNUC__ */
+
+typedef void    (*GPrintFunc)           (const gchar    *string);
+void            g_print                 (const gchar    *format,
+                                         ...) G_GNUC_PRINTF (1, 2);
+GPrintFunc      g_set_print_handler     (GPrintFunc      func);
+void            g_printerr              (const gchar    *format,
+                                         ...) G_GNUC_PRINTF (1, 2);
+GPrintFunc      g_set_printerr_handler  (GPrintFunc      func);
+
+/* deprecated compatibility functions, use g_log_set_handler() instead */
+typedef void            (*GErrorFunc)           (const gchar *str);
+typedef void            (*GWarningFunc)         (const gchar *str);
+GErrorFunc   g_set_error_handler   (GErrorFunc   func);
+GWarningFunc g_set_warning_handler (GWarningFunc func);
+GPrintFunc   g_set_message_handler (GPrintFunc func);
+
+/* Provide macros for error handling. The "assert" macros will
+ *  exit on failure. The "return" macros will exit the current
+ *  function. Two different definitions are given for the macros
+ *  if G_DISABLE_ASSERT is not defined, in order to support gcc's
+ *  __PRETTY_FUNCTION__ capability.
+ */
+
+#ifdef G_DISABLE_ASSERT
+
+#define g_assert(expr)
+#define g_assert_not_reached()
+
+#else /* !G_DISABLE_ASSERT */
+
+#ifdef __GNUC__
+
+#define g_assert(expr)                 G_STMT_START{           \
+     if (!(expr))                                              \
+       g_log (G_LOG_DOMAIN,                                    \
+             G_LOG_LEVEL_ERROR,                                \
+             "file %s: line %d (%s): assertion failed: (%s)",  \
+             __FILE__,                                         \
+             __LINE__,                                         \
+             __PRETTY_FUNCTION__,                              \
+             #expr);                   }G_STMT_END
+
+#define g_assert_not_reached()         G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_ERROR,                                  \
+           "file %s: line %d (%s): should not be reached",     \
+           __FILE__,                                           \
+           __LINE__,                                           \
+           __PRETTY_FUNCTION__);       }G_STMT_END
+
+#else /* !__GNUC__ */
+
+#define g_assert(expr)                 G_STMT_START{           \
+     if (!(expr))                                              \
+       g_log (G_LOG_DOMAIN,                                    \
+             G_LOG_LEVEL_ERROR,                                \
+             "file %s: line %d: assertion failed: (%s)",       \
+             __FILE__,                                         \
+             __LINE__,                                         \
+             #expr);                   }G_STMT_END
+
+#define g_assert_not_reached()         G_STMT_START{   \
+     g_log (G_LOG_DOMAIN,                              \
+           G_LOG_LEVEL_ERROR,                          \
+           "file %s: line %d: should not be reached",  \
+           __FILE__,                                   \
+           __LINE__);          }G_STMT_END
+
+#endif /* __GNUC__ */
+
+#endif /* !G_DISABLE_ASSERT */
+
+
+#ifdef G_DISABLE_CHECKS
+
+#define g_return_if_fail(expr)
+#define g_return_val_if_fail(expr,val)
+#define g_return_if_reached() return
+#define g_return_val_if_reached(val) return (val)
+
+#else /* !G_DISABLE_CHECKS */
+
+#ifdef __GNUC__
+
+#define g_return_if_fail(expr)         G_STMT_START{                   \
+     if (!(expr))                                                      \
+       {                                                               \
+        g_log (G_LOG_DOMAIN,                                           \
+               G_LOG_LEVEL_CRITICAL,                                   \
+               "file %s: line %d (%s): assertion `%s' failed",         \
+               __FILE__,                                               \
+               __LINE__,                                               \
+               __PRETTY_FUNCTION__,                                    \
+               #expr);                                                 \
+        return;                                                        \
+       };                              }G_STMT_END
+
+#define g_return_val_if_fail(expr,val) G_STMT_START{                   \
+     if (!(expr))                                                      \
+       {                                                               \
+        g_log (G_LOG_DOMAIN,                                           \
+               G_LOG_LEVEL_CRITICAL,                                   \
+               "file %s: line %d (%s): assertion `%s' failed",         \
+               __FILE__,                                               \
+               __LINE__,                                               \
+               __PRETTY_FUNCTION__,                                    \
+               #expr);                                                 \
+        return (val);                                                  \
+       };                              }G_STMT_END
+
+#define g_return_if_reached()          G_STMT_START{                   \
+     g_log (G_LOG_DOMAIN,                                              \
+           G_LOG_LEVEL_CRITICAL,                                       \
+           "file %s: line %d (%s): should not be reached",             \
+           __FILE__,                                                   \
+           __LINE__,                                                   \
+           __PRETTY_FUNCTION__);                                       \
+     return;                           }G_STMT_END
+
+#define g_return_val_if_reached(val)   G_STMT_START{                   \
+     g_log (G_LOG_DOMAIN,                                              \
+           G_LOG_LEVEL_CRITICAL,                                       \
+           "file %s: line %d (%s): should not be reached",             \
+           __FILE__,                                                   \
+           __LINE__,                                                   \
+           __PRETTY_FUNCTION__);                                       \
+     return (val);                     }G_STMT_END
+
+#else /* !__GNUC__ */
+
+#define g_return_if_fail(expr)         G_STMT_START{           \
+     if (!(expr))                                              \
+       {                                                       \
+        g_log (G_LOG_DOMAIN,                                   \
+               G_LOG_LEVEL_CRITICAL,                           \
+               "file %s: line %d: assertion `%s' failed",      \
+               __FILE__,                                       \
+               __LINE__,                                       \
+               #expr);                                         \
+        return;                                                \
+       };                              }G_STMT_END
+
+#define g_return_val_if_fail(expr, val)        G_STMT_START{           \
+     if (!(expr))                                              \
+       {                                                       \
+        g_log (G_LOG_DOMAIN,                                   \
+               G_LOG_LEVEL_CRITICAL,                           \
+               "file %s: line %d: assertion `%s' failed",      \
+               __FILE__,                                       \
+               __LINE__,                                       \
+               #expr);                                         \
+        return (val);                                          \
+       };                              }G_STMT_END
+
+#define g_return_if_reached()          G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_CRITICAL,                               \
+           "file %s: line %d: should not be reached",          \
+           __FILE__,                                           \
+           __LINE__);                                          \
+     return;                           }G_STMT_END
+
+#define g_return_val_if_reached(val)   G_STMT_START{           \
+     g_log (G_LOG_DOMAIN,                                      \
+           G_LOG_LEVEL_CRITICAL,                               \
+           "file %s: line %d: should not be reached",          \
+           __FILE__,                                           \
+           __LINE__);                                          \
+     return (val);                     }G_STMT_END
+
+#endif /* !__GNUC__ */
+
+#endif /* !G_DISABLE_CHECKS */
+
+G_END_DECLS
+
+#endif /* __G_MESSAGES_H__ */
+
diff --git a/gnode.h b/gnode.h
new file mode 100644 (file)
index 0000000..2b9b21d
--- /dev/null
+++ b/gnode.h
@@ -0,0 +1,160 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_NODE_H__
+#define __G_NODE_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GNode          GNode;
+
+/* Tree traverse flags */
+typedef enum
+{
+  G_TRAVERSE_LEAFS      = 1 << 0,
+  G_TRAVERSE_NON_LEAFS  = 1 << 1,
+  G_TRAVERSE_ALL        = G_TRAVERSE_LEAFS | G_TRAVERSE_NON_LEAFS,
+  G_TRAVERSE_MASK       = 0x03
+} GTraverseFlags;
+
+/* Tree traverse orders */
+typedef enum
+{
+  G_IN_ORDER,
+  G_PRE_ORDER,
+  G_POST_ORDER,
+  G_LEVEL_ORDER
+} GTraverseType;
+
+typedef gboolean       (*GNodeTraverseFunc)    (GNode         *node,
+                                                gpointer       data);
+typedef void           (*GNodeForeachFunc)     (GNode         *node,
+                                                gpointer       data);
+
+/* N-way tree implementation
+ */
+struct _GNode
+{
+  gpointer data;
+  GNode          *next;
+  GNode          *prev;
+  GNode          *parent;
+  GNode          *children;
+};
+
+#define         G_NODE_IS_ROOT(node)   (((GNode*) (node))->parent == NULL && \
+                                ((GNode*) (node))->prev == NULL && \
+                                ((GNode*) (node))->next == NULL)
+#define         G_NODE_IS_LEAF(node)   (((GNode*) (node))->children == NULL)
+
+void     g_node_push_allocator  (GAllocator       *allocator);
+void     g_node_pop_allocator   (void);
+GNode*  g_node_new             (gpointer          data);
+void    g_node_destroy         (GNode            *root);
+void    g_node_unlink          (GNode            *node);
+GNode*   g_node_copy            (GNode            *node);
+GNode*  g_node_insert          (GNode            *parent,
+                                gint              position,
+                                GNode            *node);
+GNode*  g_node_insert_before   (GNode            *parent,
+                                GNode            *sibling,
+                                GNode            *node);
+GNode*  g_node_prepend         (GNode            *parent,
+                                GNode            *node);
+guint   g_node_n_nodes         (GNode            *root,
+                                GTraverseFlags    flags);
+GNode*  g_node_get_root        (GNode            *node);
+gboolean g_node_is_ancestor    (GNode            *node,
+                                GNode            *descendant);
+guint   g_node_depth           (GNode            *node);
+GNode*  g_node_find            (GNode            *root,
+                                GTraverseType     order,
+                                GTraverseFlags    flags,
+                                gpointer          data);
+
+/* convenience macros */
+#define g_node_append(parent, node)                            \
+     g_node_insert_before ((parent), NULL, (node))
+#define        g_node_insert_data(parent, position, data)              \
+     g_node_insert ((parent), (position), g_node_new (data))
+#define        g_node_insert_data_before(parent, sibling, data)        \
+     g_node_insert_before ((parent), (sibling), g_node_new (data))
+#define        g_node_prepend_data(parent, data)                       \
+     g_node_prepend ((parent), g_node_new (data))
+#define        g_node_append_data(parent, data)                        \
+     g_node_insert_before ((parent), NULL, g_node_new (data))
+
+/* traversal function, assumes that `node' is root
+ * (only traverses `node' and its subtree).
+ * this function is just a high level interface to
+ * low level traversal functions, optimized for speed.
+ */
+void    g_node_traverse        (GNode            *root,
+                                GTraverseType     order,
+                                GTraverseFlags    flags,
+                                gint              max_depth,
+                                GNodeTraverseFunc func,
+                                gpointer          data);
+
+/* return the maximum tree height starting with `node', this is an expensive
+ * operation, since we need to visit all nodes. this could be shortened by
+ * adding `guint height' to struct _GNode, but then again, this is not very
+ * often needed, and would make g_node_insert() more time consuming.
+ */
+guint   g_node_max_height       (GNode *root);
+
+void    g_node_children_foreach (GNode           *node,
+                                 GTraverseFlags   flags,
+                                 GNodeForeachFunc func,
+                                 gpointer         data);
+void    g_node_reverse_children (GNode           *node);
+guint   g_node_n_children       (GNode           *node);
+GNode*  g_node_nth_child        (GNode           *node,
+                                 guint            n);
+GNode*  g_node_last_child       (GNode           *node);
+GNode*  g_node_find_child       (GNode           *node,
+                                 GTraverseFlags   flags,
+                                 gpointer         data);
+gint    g_node_child_position   (GNode           *node,
+                                 GNode           *child);
+gint    g_node_child_index      (GNode           *node,
+                                 gpointer         data);
+
+GNode*  g_node_first_sibling    (GNode           *node);
+GNode*  g_node_last_sibling     (GNode           *node);
+
+#define         g_node_prev_sibling(node)      ((node) ? \
+                                        ((GNode*) (node))->prev : NULL)
+#define         g_node_next_sibling(node)      ((node) ? \
+                                        ((GNode*) (node))->next : NULL)
+#define         g_node_first_child(node)       ((node) ? \
+                                        ((GNode*) (node))->children : NULL)
+
+G_END_DECLS
+
+#endif /* __G_NODE_H__ */
diff --git a/gprimes.h b/gprimes.h
new file mode 100644 (file)
index 0000000..daa1598
--- /dev/null
+++ b/gprimes.h
@@ -0,0 +1,47 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_PRIMES_H__
+#define __G_PRIMES_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Prime numbers.
+ */
+
+/* This function returns prime numbers spaced by approximately 1.5-2.0
+ * and is for use in resizing data structures which prefer
+ * prime-valued sizes. The closest spaced prime function returns the
+ * next largest prime, or the highest it knows about which is about
+ * MAXINT/4.
+ */
+guint     g_spaced_primes_closest (guint num) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_PRIMES_H__ */
diff --git a/gquark.h b/gquark.h
new file mode 100644 (file)
index 0000000..08dd9e4
--- /dev/null
+++ b/gquark.h
@@ -0,0 +1,46 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_QUARK_H__
+#define __G_QUARK_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef guint32 GQuark;
+
+/* Quarks (string<->id association)
+ */
+GQuark    g_quark_try_string            (const gchar    *string);
+GQuark    g_quark_from_static_string    (const gchar    *string);
+GQuark    g_quark_from_string           (const gchar    *string);
+gchar*    g_quark_to_string             (GQuark          quark) G_GNUC_CONST;
+
+G_END_DECLS
+
+#endif /* __G_QUARK_H__ */
+
diff --git a/gqueue.h b/gqueue.h
new file mode 100644 (file)
index 0000000..b71b6d6
--- /dev/null
+++ b/gqueue.h
@@ -0,0 +1,65 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_QUEUE_H__
+#define __G_QUEUE_H__
+
+#include <glist.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GQueue         GQueue;
+
+struct _GQueue
+{
+  GList *head;
+  GList *tail;
+  guint  length;
+};
+
+/* Queues
+ */
+GQueue*  g_queue_new            (void);
+void     g_queue_free           (GQueue  *queue);
+void     g_queue_push_head      (GQueue  *queue,
+                                gpointer data);
+void     g_queue_push_tail      (GQueue  *queue,
+                                gpointer data);
+gpointer g_queue_pop_head       (GQueue  *queue);
+gpointer g_queue_pop_tail       (GQueue  *queue);
+gboolean g_queue_is_empty       (GQueue  *queue);
+gpointer g_queue_peek_head      (GQueue  *queue);
+gpointer g_queue_peek_tail      (GQueue  *queue);
+void     g_queue_push_head_link (GQueue  *queue,
+                                GList   *link);
+void     g_queue_push_tail_link (GQueue  *queue,
+                                GList   *link);
+GList*   g_queue_pop_head_link  (GQueue  *queue);
+GList*   g_queue_pop_tail_link  (GQueue  *queue);
+
+G_END_DECLS
+
+#endif /* __G_QUEUE_H__ */
diff --git a/grand.h b/grand.h
new file mode 100644 (file)
index 0000000..38f4e5e
--- /dev/null
+++ b/grand.h
@@ -0,0 +1,76 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_RAND_H__
+#define __G_RAND_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GRand           GRand;
+
+/* GRand - a good and fast random number generator: Mersenne Twister
+ * see http://www.math.keio.ac.jp/~matumoto/emt.html for more info.
+ * The range functions return a value in the intervall [min,max).
+ * int          -> [0..2^32-1]
+ * int_range    -> [min..max-1]
+ * double       -> [0..1)
+ * double_range -> [min..max)
+ */
+
+GRand*  g_rand_new_with_seed   (guint32     seed);
+GRand*  g_rand_new             (void);
+void    g_rand_free            (GRand      *rand);
+
+void    g_rand_set_seed        (GRand      *rand,
+                                guint32     seed);
+guint32 g_rand_int             (GRand      *rand);
+gint32  g_rand_int_range       (GRand      *rand,
+                                gint32      min,
+                                gint32      max);
+gdouble g_rand_double          (GRand      *rand);
+gdouble g_rand_double_range    (GRand      *rand,
+                                gdouble     min,
+                                gdouble     max);
+
+void    g_random_set_seed      (guint32     seed);
+guint32 g_random_int           (void);
+gint32  g_random_int_range     (gint32      min,
+                                gint32      max);
+gdouble g_random_double        (void);
+gdouble g_random_double_range  (gdouble     min,
+                                gdouble     max);
+
+G_END_DECLS
+
+#endif /* __G_RAND_H__ */
+
+
+
+
+
+
diff --git a/grel.h b/grel.h
new file mode 100644 (file)
index 0000000..09b2e23
--- /dev/null
+++ b/grel.h
@@ -0,0 +1,94 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_REL_H__
+#define __G_REL_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GRelation       GRelation;
+typedef struct _GTuples         GTuples;
+
+struct _GTuples
+{
+  guint len;
+};
+
+/* GRelation
+ *
+ * Indexed Relations.  Imagine a really simple table in a
+ * database.  Relations are not ordered.  This data type is meant for
+ * maintaining a N-way mapping.
+ *
+ * g_relation_new() creates a relation with FIELDS fields
+ *
+ * g_relation_destroy() frees all resources
+ * g_tuples_destroy() frees the result of g_relation_select()
+ *
+ * g_relation_index() indexes relation FIELD with the provided
+ *   equality and hash functions.  this must be done before any
+ *   calls to insert are made.
+ *
+ * g_relation_insert() inserts a new tuple.  you are expected to
+ *   provide the right number of fields.
+ *
+ * g_relation_delete() deletes all relations with KEY in FIELD
+ * g_relation_select() returns ...
+ * g_relation_count() counts ...
+ */
+
+GRelation* g_relation_new     (gint         fields);
+void       g_relation_destroy (GRelation   *relation);
+void       g_relation_index   (GRelation   *relation,
+                               gint         field,
+                               GHashFunc    hash_func,
+                               GCompareFunc key_compare_func);
+void       g_relation_insert  (GRelation   *relation,
+                               ...);
+gint       g_relation_delete  (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+GTuples*   g_relation_select  (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+gint       g_relation_count   (GRelation   *relation,
+                               gconstpointer  key,
+                               gint         field);
+gboolean   g_relation_exists  (GRelation   *relation,
+                               ...);
+void       g_relation_print   (GRelation   *relation);
+
+void       g_tuples_destroy   (GTuples     *tuples);
+gpointer   g_tuples_index     (GTuples     *tuples,
+                               gint         index,
+                               gint         field);
+
+G_END_DECLS
+
+#endif /* __G_REL_H__ */
+
diff --git a/gscanner.h b/gscanner.h
new file mode 100644 (file)
index 0000000..8cee79b
--- /dev/null
@@ -0,0 +1,267 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_SCANNER_H__
+#define __G_SCANNER_H__
+
+#include <ghash.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GScanner       GScanner;
+typedef struct _GScannerConfig GScannerConfig;
+typedef union  _GTokenValue     GTokenValue;
+
+typedef void           (*GScannerMsgFunc)      (GScanner      *scanner,
+                                                gchar         *message,
+                                                gint           error);
+
+/* GScanner: Flexible lexical scanner for general purpose.
+ */
+
+/* Character sets */
+#define G_CSET_A_2_Z   "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+#define G_CSET_a_2_z   "abcdefghijklmnopqrstuvwxyz"
+#define G_CSET_DIGITS  "0123456789"
+#define G_CSET_LATINC  "\300\301\302\303\304\305\306"\
+                       "\307\310\311\312\313\314\315\316\317\320"\
+                       "\321\322\323\324\325\326"\
+                       "\330\331\332\333\334\335\336"
+#define G_CSET_LATINS  "\337\340\341\342\343\344\345\346"\
+                       "\347\350\351\352\353\354\355\356\357\360"\
+                       "\361\362\363\364\365\366"\
+                       "\370\371\372\373\374\375\376\377"
+
+/* Error types */
+typedef enum
+{
+  G_ERR_UNKNOWN,
+  G_ERR_UNEXP_EOF,
+  G_ERR_UNEXP_EOF_IN_STRING,
+  G_ERR_UNEXP_EOF_IN_COMMENT,
+  G_ERR_NON_DIGIT_IN_CONST,
+  G_ERR_DIGIT_RADIX,
+  G_ERR_FLOAT_RADIX,
+  G_ERR_FLOAT_MALFORMED
+} GErrorType;
+
+/* Token types */
+typedef enum
+{
+  G_TOKEN_EOF                  =   0,
+  
+  G_TOKEN_LEFT_PAREN           = '(',
+  G_TOKEN_RIGHT_PAREN          = ')',
+  G_TOKEN_LEFT_CURLY           = '{',
+  G_TOKEN_RIGHT_CURLY          = '}',
+  G_TOKEN_LEFT_BRACE           = '[',
+  G_TOKEN_RIGHT_BRACE          = ']',
+  G_TOKEN_EQUAL_SIGN           = '=',
+  G_TOKEN_COMMA                        = ',',
+  
+  G_TOKEN_NONE                 = 256,
+  
+  G_TOKEN_ERROR,
+  
+  G_TOKEN_CHAR,
+  G_TOKEN_BINARY,
+  G_TOKEN_OCTAL,
+  G_TOKEN_INT,
+  G_TOKEN_HEX,
+  G_TOKEN_FLOAT,
+  G_TOKEN_STRING,
+  
+  G_TOKEN_SYMBOL,
+  G_TOKEN_IDENTIFIER,
+  G_TOKEN_IDENTIFIER_NULL,
+  
+  G_TOKEN_COMMENT_SINGLE,
+  G_TOKEN_COMMENT_MULTI,
+  G_TOKEN_LAST
+} GTokenType;
+
+union  _GTokenValue
+{
+  gpointer     v_symbol;
+  gchar                *v_identifier;
+  gulong       v_binary;
+  gulong       v_octal;
+  gulong       v_int;
+  gdouble      v_float;
+  gulong       v_hex;
+  gchar                *v_string;
+  gchar                *v_comment;
+  guchar       v_char;
+  guint                v_error;
+};
+
+struct _GScannerConfig
+{
+  /* Character sets
+   */
+  gchar                *cset_skip_characters;          /* default: " \t\n" */
+  gchar                *cset_identifier_first;
+  gchar                *cset_identifier_nth;
+  gchar                *cpair_comment_single;          /* default: "#\n" */
+  
+  /* Should symbol lookup work case sensitive?
+   */
+  guint                case_sensitive : 1;
+  
+  /* Boolean values to be adjusted "on the fly"
+   * to configure scanning behaviour.
+   */
+  guint                skip_comment_multi : 1;         /* C like comment */
+  guint                skip_comment_single : 1;        /* single line comment */
+  guint                scan_comment_multi : 1;         /* scan multi line comments? */
+  guint                scan_identifier : 1;
+  guint                scan_identifier_1char : 1;
+  guint                scan_identifier_NULL : 1;
+  guint                scan_symbols : 1;
+  guint                scan_binary : 1;
+  guint                scan_octal : 1;
+  guint                scan_float : 1;
+  guint                scan_hex : 1;                   /* `0x0ff0' */
+  guint                scan_hex_dollar : 1;            /* `$0ff0' */
+  guint                scan_string_sq : 1;             /* string: 'anything' */
+  guint                scan_string_dq : 1;             /* string: "\\-escapes!\n" */
+  guint                numbers_2_int : 1;              /* bin, octal, hex => int */
+  guint                int_2_float : 1;                /* int => G_TOKEN_FLOAT? */
+  guint                identifier_2_string : 1;
+  guint                char_2_token : 1;               /* return G_TOKEN_CHAR? */
+  guint                symbol_2_token : 1;
+  guint                scope_0_fallback : 1;           /* try scope 0 on lookups? */
+};
+
+struct _GScanner
+{
+  /* unused fields */
+  gpointer             user_data;
+  guint                        max_parse_errors;
+  
+  /* g_scanner_error() increments this field */
+  guint                        parse_errors;
+  
+  /* name of input stream, featured by the default message handler */
+  const gchar          *input_name;
+  
+  /* data pointer for derived structures */
+  gpointer             derived_data;
+  
+  /* link into the scanner configuration */
+  GScannerConfig       *config;
+  
+  /* fields filled in after g_scanner_get_next_token() */
+  GTokenType           token;
+  GTokenValue          value;
+  guint                        line;
+  guint                        position;
+  
+  /* fields filled in after g_scanner_peek_next_token() */
+  GTokenType           next_token;
+  GTokenValue          next_value;
+  guint                        next_line;
+  guint                        next_position;
+  
+  /* to be considered private */
+  GHashTable           *symbol_table;
+  gint                 input_fd;
+  const gchar          *text;
+  const gchar          *text_end;
+  gchar                        *buffer;
+  guint                        scope_id;
+  
+  /* handler function for _warn and _error */
+  GScannerMsgFunc      msg_handler;
+};
+
+GScanner*      g_scanner_new                   (GScannerConfig *config_templ);
+void           g_scanner_destroy               (GScanner       *scanner);
+void           g_scanner_input_file            (GScanner       *scanner,
+                                                gint           input_fd);
+void           g_scanner_sync_file_offset      (GScanner       *scanner);
+void           g_scanner_input_text            (GScanner       *scanner,
+                                                const  gchar   *text,
+                                                guint          text_len);
+GTokenType     g_scanner_get_next_token        (GScanner       *scanner);
+GTokenType     g_scanner_peek_next_token       (GScanner       *scanner);
+GTokenType     g_scanner_cur_token             (GScanner       *scanner);
+GTokenValue    g_scanner_cur_value             (GScanner       *scanner);
+guint          g_scanner_cur_line              (GScanner       *scanner);
+guint          g_scanner_cur_position          (GScanner       *scanner);
+gboolean       g_scanner_eof                   (GScanner       *scanner);
+guint          g_scanner_set_scope             (GScanner       *scanner,
+                                                guint           scope_id);
+void           g_scanner_scope_add_symbol      (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol,
+                                                gpointer       value);
+void           g_scanner_scope_remove_symbol   (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol);
+gpointer       g_scanner_scope_lookup_symbol   (GScanner       *scanner,
+                                                guint           scope_id,
+                                                const gchar    *symbol);
+void           g_scanner_scope_foreach_symbol  (GScanner       *scanner,
+                                                guint           scope_id,
+                                                GHFunc          func,
+                                                gpointer        user_data);
+gpointer       g_scanner_lookup_symbol         (GScanner       *scanner,
+                                                const gchar    *symbol);
+void           g_scanner_unexp_token           (GScanner       *scanner,
+                                                GTokenType     expected_token,
+                                                const gchar    *identifier_spec,
+                                                const gchar    *symbol_spec,
+                                                const gchar    *symbol_name,
+                                                const gchar    *message,
+                                                gint            is_error);
+void           g_scanner_error                 (GScanner       *scanner,
+                                                const gchar    *format,
+                                                ...) G_GNUC_PRINTF (2,3);
+void           g_scanner_warn                  (GScanner       *scanner,
+                                                const gchar    *format,
+                                                ...) G_GNUC_PRINTF (2,3);
+gint           g_scanner_stat_mode             (const gchar    *filename);
+/* keep downward source compatibility */
+#define                g_scanner_add_symbol( scanner, symbol, value )  G_STMT_START { \
+  g_scanner_scope_add_symbol ((scanner), 0, (symbol), (value)); \
+} G_STMT_END
+#define                g_scanner_remove_symbol( scanner, symbol )      G_STMT_START { \
+  g_scanner_scope_remove_symbol ((scanner), 0, (symbol)); \
+} G_STMT_END
+#define                g_scanner_foreach_symbol( scanner, func, data ) G_STMT_START { \
+  g_scanner_scope_foreach_symbol ((scanner), 0, (func), (data)); \
+} G_STMT_END
+
+/* The following two functions are deprecated and will be removed in
+ * the next major release. They do no good. */
+void           g_scanner_freeze_symbol_table   (GScanner       *scanner);
+void           g_scanner_thaw_symbol_table     (GScanner       *scanner);
+
+G_END_DECLS
+
+#endif /* __G_SCANNER_H__ */
+
index 0f7fd1f..4f08c24 100644 (file)
--- a/gshell.h
+++ b/gshell.h
  * Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GSHELL_H__
-#define __GSHELL_H__
+#ifndef __G_SHELL_H__
+#define __G_SHELL_H__
 
 #include <gerror.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 #define G_SHELL_ERROR g_shell_error_quark ()
 
@@ -49,11 +46,8 @@ gboolean g_shell_parse_argv (const gchar   *command_line,
                              gchar       ***argv,
                              GError       **error);
 
+G_END_DECLS
 
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* __GSHELL_H__ */
+#endif /* __G_SHELL_H__ */
 
 
diff --git a/gslist.h b/gslist.h
new file mode 100644 (file)
index 0000000..904f044
--- /dev/null
+++ b/gslist.h
@@ -0,0 +1,97 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_SLIST_H__
+#define __G_SLIST_H__
+
+#include <gmem.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GSList         GSList;
+
+struct _GSList
+{
+  gpointer data;
+  GSList *next;
+};
+
+/* Singly linked lists
+ */
+void    g_slist_push_allocator  (GAllocator     *allocator);
+void    g_slist_pop_allocator   (void);
+GSList* g_slist_alloc          (void);
+void   g_slist_free            (GSList         *list);
+void   g_slist_free_1          (GSList         *list);
+GSList* g_slist_append         (GSList         *list,
+                                gpointer        data);
+GSList* g_slist_prepend                (GSList         *list,
+                                gpointer        data);
+GSList* g_slist_insert         (GSList         *list,
+                                gpointer        data,
+                                gint            position);
+GSList* g_slist_insert_sorted  (GSList         *list,
+                                gpointer        data,
+                                GCompareFunc    func);
+GSList* g_slist_insert_before   (GSList         *slist,
+                                GSList         *sibling,
+                                gpointer        data);
+GSList* g_slist_concat         (GSList         *list1,
+                                GSList         *list2);
+GSList* g_slist_remove         (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_remove_link    (GSList         *list,
+                                GSList         *link);
+GSList* g_slist_delete_link     (GSList         *list,
+                                GSList         *link);
+GSList* g_slist_reverse                (GSList         *list);
+GSList*        g_slist_copy            (GSList         *list);
+GSList* g_slist_nth            (GSList         *list,
+                                guint           n);
+GSList* g_slist_find           (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_find_custom    (GSList         *list,
+                                gconstpointer   data,
+                                GCompareFunc    func);
+gint   g_slist_position        (GSList         *list,
+                                GSList         *llink);
+gint   g_slist_index           (GSList         *list,
+                                gconstpointer   data);
+GSList* g_slist_last           (GSList         *list);
+guint  g_slist_length          (GSList         *list);
+void   g_slist_foreach         (GSList         *list,
+                                GFunc           func,
+                                gpointer        user_data);
+GSList*  g_slist_sort           (GSList          *list,
+                                GCompareFunc    compare_func);
+gpointer g_slist_nth_data      (GSList         *list,
+                                guint           n);
+#define  g_slist_next(slist)   ((slist) ? (((GSList *)(slist))->next) : NULL)
+
+G_END_DECLS
+
+#endif /* __G_SLIST_H__ */
+
index 4ae0536..57530cb 100644 (file)
--- a/gspawn.h
+++ b/gspawn.h
  * Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GSPAWN_H__
-#define __GSPAWN_H__
+#ifndef __G_SPAWN_H__
+#define __G_SPAWN_H__
 
 #include <gerror.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 /* I'm not sure I remember our proposed naming convention here. */
 #define G_SPAWN_ERROR g_spawn_error_quark ()
@@ -123,10 +120,8 @@ gboolean g_spawn_command_line_async (const gchar          *command_line,
                                      GError              **error);
 
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* __GSPAWN_H__ */
+#endif /* __G_SPAWN_H__ */
 
 
diff --git a/gstrfuncs.h b/gstrfuncs.h
new file mode 100644 (file)
index 0000000..ffec17e
--- /dev/null
@@ -0,0 +1,128 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_STRFUNCS_H__
+#define __G_STRFUNCS_H__
+
+#include <stdarg.h>
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* String utility functions that modify a string argument or
+ * return a constant string that must not be freed.
+ */
+#define         G_STR_DELIMITERS       "_-|> <."
+gchar*  g_strdelimit           (gchar       *string,
+                                const gchar *delimiters,
+                                gchar        new_delimiter);
+gchar*  g_strcanon             (gchar       *string,
+                                const gchar *valid_chars,
+                                gchar        subsitutor);
+gdouble         g_strtod               (const gchar *nptr,
+                                gchar      **endptr);
+gchar*  g_strerror             (gint         errnum) G_GNUC_CONST;
+gchar*  g_strsignal            (gint         signum) G_GNUC_CONST;
+gint    g_strcasecmp           (const gchar *s1,
+                                const gchar *s2);
+gint    g_strncasecmp          (const gchar *s1,
+                                const gchar *s2,
+                                guint        n);
+gchar*  g_strdown              (gchar       *string);
+gchar*  g_strup                (gchar       *string);
+gchar*  g_strreverse           (gchar       *string);
+gsize   g_strlcpy              (gchar       *dest,
+                                const gchar *src,
+                                gsize        dest_size);
+gsize   g_strlcat              (gchar       *dest,
+                                const gchar *src,
+                                gsize        dest_size);
+/* removes leading spaces */
+gchar*   g_strchug              (gchar        *string);
+/* removes trailing spaces */
+gchar*  g_strchomp              (gchar        *string);
+/* removes leading & trailing spaces */
+#define g_strstrip( string )   g_strchomp (g_strchug (string))
+
+/* String utility functions that return a newly allocated string which
+ * ought to be freed with g_free from the caller at some point.
+ */
+gchar*  g_strdup               (const gchar *str);
+gchar*  g_strdup_printf        (const gchar *format,
+                                ...) G_GNUC_PRINTF (1, 2);
+gchar*  g_strdup_vprintf       (const gchar *format,
+                                va_list      args);
+gchar*  g_strndup              (const gchar *str,
+                                guint        n);
+gchar*  g_strnfill             (guint        length,
+                                gchar        fill_char);
+gchar*  g_strconcat            (const gchar *string1,
+                                ...); /* NULL terminated */
+gchar*   g_strjoin             (const gchar  *separator,
+                                ...); /* NULL terminated */
+/* Make a copy of a string interpreting C string -style escape
+ * sequences. Inverse of g_strescape. The recognized sequences are \b
+ * \f \n \r \t \\ \" and the octal format.
+ */
+gchar*   g_strcompress         (const gchar *source);
+
+/* Copy a string escaping nonprintable characters like in C strings.
+ * Inverse of g_strcompress. The exceptions parameter, if non-NULL, points
+ * to a string containing characters that are not to be escaped.
+ *
+ * Deprecated API: gchar* g_strescape (const gchar *source);
+ * Luckily this function wasn't used much, using NULL as second parameter
+ * provides mostly identical semantics.
+ */
+gchar*   g_strescape           (const gchar *source,
+                                const gchar *exceptions);
+
+gpointer g_memdup              (gconstpointer mem,
+                                guint         byte_size);
+
+/* Convert between the operating system (or C runtime)
+ * representation of file names and UTF-8.
+ */
+gchar*   g_filename_to_utf8 (const gchar *opsysstring);
+gchar*   g_filename_from_utf8 (const gchar *utf8string);
+
+/* NULL terminated string arrays.
+ * g_strsplit() splits up string into max_tokens tokens at delim and
+ * returns a newly allocated string array.
+ * g_strjoinv() concatenates all of str_array's strings, sliding in an
+ * optional separator, the returned string is newly allocated.
+ * g_strfreev() frees the array itself and all of its strings.
+ */
+gchar**         g_strsplit             (const gchar  *string,
+                                const gchar  *delimiter,
+                                gint          max_tokens);
+gchar*   g_strjoinv            (const gchar  *separator,
+                                gchar       **str_array);
+void     g_strfreev            (gchar       **str_array);
+
+G_END_DECLS
+
+#endif /* __G_STRFUNCS_H__ */
diff --git a/gstring.h b/gstring.h
new file mode 100644 (file)
index 0000000..4a95575
--- /dev/null
+++ b/gstring.h
@@ -0,0 +1,105 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_STRING_H__
+#define __G_STRING_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GString                GString;
+typedef struct _GStringChunk   GStringChunk;
+
+struct _GString
+{
+  gchar *str;
+  gint len;
+};
+
+/* String Chunks
+ */
+GStringChunk* g_string_chunk_new          (gint size);
+void         g_string_chunk_free          (GStringChunk *chunk);
+gchar*       g_string_chunk_insert        (GStringChunk *chunk,
+                                           const gchar  *string);
+gchar*       g_string_chunk_insert_const  (GStringChunk *chunk,
+                                           const gchar  *string);
+
+
+/* Strings
+ */
+GString*     g_string_new              (const gchar     *init);
+GString*     g_string_sized_new         (guint           dfl_size);
+gchar*      g_string_free              (GString         *string,
+                                        gboolean         free_segment);
+gboolean     g_string_equal             (const GString  *v,
+                                        const GString   *v2);
+guint        g_string_hash              (const GString   *str);
+GString*     g_string_assign            (GString        *string,
+                                        const gchar     *rval);
+GString*     g_string_truncate          (GString        *string,
+                                        guint            len);
+GString*     g_string_insert_len        (GString         *string,
+                                         gint             pos,
+                                         const gchar     *val,
+                                         gint             len);
+GString*     g_string_append            (GString        *string,
+                                        const gchar     *val);
+GString*     g_string_append_len        (GString        *string,
+                                        const gchar     *val,
+                                         gint             len);
+GString*     g_string_append_c          (GString        *string,
+                                        gchar            c);
+GString*     g_string_prepend           (GString        *string,
+                                        const gchar     *val);
+GString*     g_string_prepend_c         (GString        *string,
+                                        gchar            c);
+GString*     g_string_prepend_len       (GString        *string,
+                                        const gchar     *val,
+                                         gint             len);
+GString*     g_string_insert            (GString        *string,
+                                        gint             pos,
+                                        const gchar     *val);
+GString*     g_string_insert_c          (GString        *string,
+                                        gint             pos,
+                                        gchar            c);
+GString*     g_string_erase            (GString         *string,
+                                        gint             pos,
+                                        gint             len);
+GString*     g_string_down              (GString        *string);
+GString*     g_string_up                (GString        *string);
+void         g_string_sprintf           (GString        *string,
+                                        const gchar     *format,
+                                        ...) G_GNUC_PRINTF (2, 3);
+void         g_string_sprintfa          (GString        *string,
+                                        const gchar     *format,
+                                        ...) G_GNUC_PRINTF (2, 3);
+
+G_END_DECLS
+
+#endif /* __G_STRING_H__ */
+
diff --git a/gthread.h b/gthread.h
new file mode 100644 (file)
index 0000000..68c638c
--- /dev/null
+++ b/gthread.h
@@ -0,0 +1,331 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_THREAD_H__
+#define __G_THREAD_H__
+
+#include <gerror.h>
+#include <gmain.h>
+
+G_BEGIN_DECLS
+
+#ifndef GLIB_VAR
+#  ifdef G_OS_WIN32
+#    ifdef GLIB_COMPILATION
+#      define GLIB_VAR __declspec(dllexport)
+#    else /* !GLIB_COMPILATION */
+#      define GLIB_VAR extern __declspec(dllimport)
+#    endif /* !GLIB_COMPILATION */
+#  else /* !G_OS_WIN32 */
+#    define GLIB_VAR extern
+#  endif /* !G_OS_WIN32 */
+#endif /* GLIB_VAR */
+
+/* GLib Thread support
+ */
+
+extern GQuark g_thread_error_quark();
+#define G_THREAD_ERROR g_thread_error_quark()
+
+typedef enum
+{
+  G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */
+} GThreadError;
+
+typedef void            (*GThreadFunc)          (gpointer       value);
+
+typedef enum
+{
+  G_THREAD_PRIORITY_LOW,
+  G_THREAD_PRIORITY_NORMAL,
+  G_THREAD_PRIORITY_HIGH,
+  G_THREAD_PRIORITY_URGENT
+} GThreadPriority;
+
+typedef struct _GThread         GThread;
+struct  _GThread
+{
+  GThreadPriority priority;
+  gboolean bound;
+  gboolean joinable;
+};
+
+typedef struct _GMutex          GMutex;
+typedef struct _GCond           GCond;
+typedef struct _GPrivate        GPrivate;
+typedef struct _GStaticPrivate  GStaticPrivate;
+
+typedef struct _GThreadFunctions GThreadFunctions;
+struct _GThreadFunctions
+{
+  GMutex*  (*mutex_new)           (void);
+  void     (*mutex_lock)          (GMutex               *mutex);
+  gboolean (*mutex_trylock)       (GMutex               *mutex);
+  void     (*mutex_unlock)        (GMutex               *mutex);
+  void     (*mutex_free)          (GMutex               *mutex);
+  GCond*   (*cond_new)            (void);
+  void     (*cond_signal)         (GCond                *cond);
+  void     (*cond_broadcast)      (GCond                *cond);
+  void     (*cond_wait)           (GCond                *cond,
+                                   GMutex               *mutex);
+  gboolean (*cond_timed_wait)     (GCond                *cond,
+                                   GMutex               *mutex,
+                                   GTimeVal             *end_time);
+  void      (*cond_free)          (GCond                *cond);
+  GPrivate* (*private_new)        (GDestroyNotify        destructor);
+  gpointer  (*private_get)        (GPrivate             *private_key);
+  void      (*private_set)        (GPrivate             *private_key,
+                                   gpointer              data);
+  void      (*thread_create)      (GThreadFunc           thread_func,
+                                   gpointer              arg,
+                                   gulong                stack_size,
+                                   gboolean              joinable,
+                                   gboolean              bound,
+                                   GThreadPriority       priority,
+                                   gpointer              thread,
+                                   GError              **error);
+  void      (*thread_yield)       (void);
+  void      (*thread_join)        (gpointer              thread);
+  void      (*thread_exit)        (void);
+  void      (*thread_set_priority)(gpointer              thread,
+                                   GThreadPriority       priority);
+  void      (*thread_self)        (gpointer              thread);
+};
+
+GLIB_VAR GThreadFunctions       g_thread_functions_for_glib_use;
+GLIB_VAR gboolean               g_thread_use_default_impl;
+GLIB_VAR gboolean               g_threads_got_initialized;
+
+/* initializes the mutex/cond/private implementation for glib, might
+ * only be called once, and must not be called directly or indirectly
+ * from another glib-function, e.g. as a callback.
+ */
+void    g_thread_init   (GThreadFunctions       *vtable);
+
+/* Errorcheck mutexes. If you define G_ERRORCHECK_MUTEXES, then all
+ * mutexes will check for re-locking and re-unlocking */
+
+/* Initialize thread system with errorcheck mutexes. vtable must be
+ * NULL.Do not call directly. Use #define G_ERRORCHECK_MUTEXES
+ * instead.
+ */
+void    g_thread_init_with_errorcheck_mutexes (GThreadFunctions* vtable);
+
+/* A random number to recognize debug calls to g_mutex_... */
+#define G_MUTEX_DEBUG_MAGIC 0xf8e18ad7
+
+#ifdef G_ERRORCHECK_MUTEXES
+#define g_thread_init(vtable) g_thread_init_with_errorcheck_mutexes (vtable)
+#endif
+
+/* internal function for fallback static mutex implementation */
+GMutex* g_static_mutex_get_mutex_impl   (GMutex **mutex);
+
+/* shorthands for conditional and unconditional function calls */
+#define G_THREAD_UF(op, arglist) \
+    (*g_thread_functions_for_glib_use . op) arglist
+#define G_THREAD_CF(op, fail, arg) \
+    (g_thread_supported () ? G_THREAD_UF (op, arg) : (fail))
+#define G_THREAD_ECF(op, fail, mutex, name, type)                       \
+    (g_thread_supported () ?                                            \
+     ((type(*)(GMutex*, gulong, gchar*, gchar*))                        \
+      (*g_thread_functions_for_glib_use . op))                          \
+     (mutex, G_MUTEX_DEBUG_MAGIC, G_STRINGIFY (name),  G_STRLOC) : (fail))
+#ifndef G_ERRORCHECK_MUTEXES
+#define g_mutex_lock_with_debug_name(mutex, name)                       \
+  G_THREAD_CF (mutex_lock,     (void)0, (mutex))
+#define g_mutex_trylock_with_debug_name(mutex, name)                    \
+   G_THREAD_CF (mutex_trylock,  TRUE,    (mutex))
+#define g_mutex_unlock_with_debug_name(mutex, name)                     \
+   G_THREAD_CF (mutex_unlock,   (void)0, (mutex))
+#else /* G_ERRORCHECK_MUTEXES */
+#define g_mutex_lock_with_debug_name(mutex, name)                       \
+  G_THREAD_ECF (mutex_lock,    (void)0, mutex, name, void)
+#define g_mutex_trylock_with_debug_name(mutex, name)                    \
+  G_THREAD_ECF (mutex_trylock, TRUE,    mutex, name, gboolean)
+#define g_mutex_unlock_with_debug_name(mutex, name)                     \
+  G_THREAD_ECF (mutex_unlock,  (void)0, mutex, name, void)
+#endif /* G_ERRORCHECK_MUTEXES */
+
+#define g_thread_supported()    (g_threads_got_initialized)
+#define g_mutex_new()            G_THREAD_UF (mutex_new,      ())
+#define g_mutex_lock(mutex)      g_mutex_lock_with_debug_name(mutex, mutex)
+#define g_mutex_trylock(mutex)   g_mutex_trylock_with_debug_name(mutex, mutex)
+#define g_mutex_unlock(mutex)    g_mutex_unlock_with_debug_name(mutex, mutex)
+#define g_mutex_free(mutex)      G_THREAD_CF (mutex_free,     (void)0, (mutex))
+#define g_cond_new()             G_THREAD_UF (cond_new,       ())
+#define g_cond_signal(cond)      G_THREAD_CF (cond_signal,    (void)0, (cond))
+#define g_cond_broadcast(cond)   G_THREAD_CF (cond_broadcast, (void)0, (cond))
+#define g_cond_wait(cond, mutex) G_THREAD_CF (cond_wait,      (void)0, (cond, \
+                                                                        mutex))
+#define g_cond_free(cond)        G_THREAD_CF (cond_free,      (void)0, (cond))
+#define g_cond_timed_wait(cond, mutex, abs_time) G_THREAD_CF (cond_timed_wait, \
+                                                              TRUE, \
+                                                              (cond, mutex, \
+                                                               abs_time))
+#define g_private_new(destructor)         G_THREAD_UF (private_new, (destructor))
+#define g_private_get(private_key)        G_THREAD_CF (private_get, \
+                                                       ((gpointer)private_key), \
+                                                       (private_key))
+#define g_private_set(private_key, value) G_THREAD_CF (private_set, \
+                                                       (void) (private_key = \
+                                                        (GPrivate*) (value)), \
+                                                       (private_key, value))
+#define g_thread_yield()              G_THREAD_CF (thread_yield, (void)0, ())
+#define g_thread_exit()               G_THREAD_CF (thread_exit, (void)0, ())
+
+GThread* g_thread_create (GThreadFunc            thread_func,
+                          gpointer               arg,
+                          gulong                 stack_size,
+                          gboolean               joinable,
+                          gboolean               bound,
+                          GThreadPriority        priority,
+                          GError               **error);
+GThread* g_thread_self ();
+void g_thread_join (GThread *thread);
+void g_thread_set_priority (GThread         *thread,
+                            GThreadPriority  priority);
+
+/* GStaticMutexes can be statically initialized with the value
+ * G_STATIC_MUTEX_INIT, and then they can directly be used, that is
+ * much easier, than having to explicitly allocate the mutex before
+ * use
+ */
+#define g_static_mutex_lock(mutex) \
+    g_mutex_lock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+#define g_static_mutex_trylock(mutex) \
+    g_mutex_trylock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+#define g_static_mutex_unlock(mutex) \
+    g_mutex_unlock_with_debug_name (g_static_mutex_get_mutex (mutex), mutex)
+
+struct _GStaticPrivate
+{
+  guint index;
+};
+#define G_STATIC_PRIVATE_INIT { 0 }
+gpointer g_static_private_get (GStaticPrivate   *private_key);
+void     g_static_private_set (GStaticPrivate   *private_key,
+                               gpointer          data,
+                               GDestroyNotify    notify);
+gpointer g_static_private_get_for_thread (GStaticPrivate *private_key,
+                                          GThread        *thread);
+void g_static_private_set_for_thread (GStaticPrivate *private_key,
+                                      GThread        *thread,
+                                      gpointer        data,
+                                      GDestroyNotify  notify);
+
+typedef struct _GStaticRecMutex GStaticRecMutex;
+struct _GStaticRecMutex
+{
+  GStaticMutex mutex;
+  unsigned int depth;
+  GSystemThread owner;
+};
+
+#define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
+void     g_static_rec_mutex_lock        (GStaticRecMutex *mutex);
+gboolean g_static_rec_mutex_trylock     (GStaticRecMutex *mutex);
+void     g_static_rec_mutex_unlock      (GStaticRecMutex *mutex);
+void     g_static_rec_mutex_lock_full   (GStaticRecMutex *mutex,
+                                         guint            depth);
+guint    g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex);
+
+typedef struct _GStaticRWLock GStaticRWLock;
+struct _GStaticRWLock
+{
+  GStaticMutex mutex;
+  GCond *read_cond;
+  GCond *write_cond;
+  guint read_counter;
+  gboolean write;
+  guint want_to_write;
+};
+
+#define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, FALSE }
+
+void      g_static_rw_lock_reader_lock    (GStaticRWLock* lock);
+gboolean  g_static_rw_lock_reader_trylock (GStaticRWLock* lock);
+void      g_static_rw_lock_reader_unlock  (GStaticRWLock* lock);
+void      g_static_rw_lock_writer_lock    (GStaticRWLock* lock);
+gboolean  g_static_rw_lock_writer_trylock (GStaticRWLock* lock);
+void      g_static_rw_lock_writer_unlock  (GStaticRWLock* lock);
+void      g_static_rw_lock_free (GStaticRWLock* lock);
+
+/* these are some convenience macros that expand to nothing if GLib
+ * was configured with --disable-threads. for using StaticMutexes,
+ * you define them with G_LOCK_DEFINE_STATIC (name) or G_LOCK_DEFINE (name)
+ * if you need to export the mutex. With G_LOCK_EXTERN (name) you can
+ * declare such an globally defined lock. name is a unique identifier
+ * for the protected varibale or code portion. locking, testing and
+ * unlocking of such mutexes can be done with G_LOCK(), G_UNLOCK() and
+ * G_TRYLOCK() respectively.
+ */
+extern void glib_dummy_decl (void);
+#define G_LOCK_NAME(name)               g__ ## name ## _lock
+#ifdef  G_THREADS_ENABLED
+#  define G_LOCK_DEFINE_STATIC(name)    static G_LOCK_DEFINE (name)
+#  define G_LOCK_DEFINE(name)           \
+    GStaticMutex G_LOCK_NAME (name) = G_STATIC_MUTEX_INIT
+#  define G_LOCK_EXTERN(name)           extern GStaticMutex G_LOCK_NAME (name)
+
+#  ifdef G_DEBUG_LOCKS
+#    define G_LOCK(name)                G_STMT_START{             \
+        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                   \
+               "file %s: line %d (%s): locking: %s ",             \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name);                                            \
+        g_static_mutex_lock (&G_LOCK_NAME (name));                \
+     }G_STMT_END
+#    define G_UNLOCK(name)              G_STMT_START{             \
+        g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                   \
+               "file %s: line %d (%s): unlocking: %s ",           \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name);                                            \
+       g_static_mutex_unlock (&G_LOCK_NAME (name));               \
+     }G_STMT_END
+#    define G_TRYLOCK(name)                                       \
+        (g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,                  \
+               "file %s: line %d (%s): try locking: %s ",         \
+               __FILE__,        __LINE__, G_GNUC_PRETTY_FUNCTION, \
+               #name), g_static_mutex_trylock (&G_LOCK_NAME (name)))
+#  else  /* !G_DEBUG_LOCKS */
+#    define G_LOCK(name) g_static_mutex_lock       (&G_LOCK_NAME (name))
+#    define G_UNLOCK(name) g_static_mutex_unlock   (&G_LOCK_NAME (name))
+#    define G_TRYLOCK(name) g_static_mutex_trylock (&G_LOCK_NAME (name))
+#  endif /* !G_DEBUG_LOCKS */
+#else   /* !G_THREADS_ENABLED */
+#  define G_LOCK_DEFINE_STATIC(name)    extern void glib_dummy_decl (void)
+#  define G_LOCK_DEFINE(name)           extern void glib_dummy_decl (void)
+#  define G_LOCK_EXTERN(name)           extern void glib_dummy_decl (void)
+#  define G_LOCK(name)
+#  define G_UNLOCK(name)
+#  define G_TRYLOCK(name)               (TRUE)
+#endif  /* !G_THREADS_ENABLED */
+
+G_END_DECLS
+
+#endif /* __G_THREAD_H__ */
+
diff --git a/gthreadpool.h b/gthreadpool.h
new file mode 100644 (file)
index 0000000..d6fa87c
--- /dev/null
@@ -0,0 +1,108 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_THREADPOOL_H__
+#define __G_THREADPOOL_H__
+
+#include <gthread.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GThreadPool     GThreadPool;
+
+/* Thread Pools
+ */
+
+/* The real GThreadPool is bigger, so you may only create a thread
+ * pool with the constructor function */
+struct _GThreadPool
+{
+  GFunc thread_func;
+  gulong stack_size;
+  gboolean bound;
+  GThreadPriority priority;
+  gboolean exclusive;
+  gpointer user_data;
+};
+
+/* Get a thread pool with the function thread_func, at most max_threads may
+ * run at a time (max_threads == -1 means no limit), stack_size, bound,
+ * priority like in g_thread_create, exclusive == TRUE means, that the threads
+ * shouldn't be shared and that they will be prestarted (otherwise they are
+ * started, as needed) user_data is the 2nd argument to the thread_func */
+GThreadPool*    g_thread_pool_new             (GFunc            thread_func,
+                                               gint             max_threads,
+                                               gulong           stack_size,
+                                               gboolean         bound,
+                                               GThreadPriority  priority,
+                                               gboolean         exclusive,
+                                               gpointer         user_data,
+                                               GError         **error);
+
+/* Push new data into the thread pool. This task is assigned to a thread later
+ * (when the maximal number of threads is reached for that pool) or now
+ * (otherwise). If necessary a new thread will be started. The function
+ * returns immediatly */
+void            g_thread_pool_push            (GThreadPool     *pool,
+                                               gpointer         data,
+                                               GError         **error);
+
+/* Set the number of threads, which can run concurrently for that pool, -1
+ * means no limit. 0 means has the effect, that the pool won't process
+ * requests until the limit is set higher again */
+void            g_thread_pool_set_max_threads (GThreadPool     *pool,
+                                               gint             max_threads,
+                                               GError         **error);
+gint            g_thread_pool_get_max_threads (GThreadPool     *pool);
+
+/* Get the number of threads assigned to that pool. This number doesn't
+ * necessarily represent the number of working threads in that pool */
+guint           g_thread_pool_get_num_threads (GThreadPool     *pool);
+
+/* Get the number of unprocessed items in the pool */
+guint           g_thread_pool_unprocessed     (GThreadPool     *pool);
+
+/* Free the pool, immediate means, that all unprocessed items in the queue
+ * wont be processed, wait means, that the function doesn't return immediatly,
+ * but after all threads in the pool are ready processing items. immediate
+ * does however not mean, that threads are killed. */
+void            g_thread_pool_free            (GThreadPool     *pool,
+                                               gboolean         immediate,
+                                               gboolean         wait);
+
+/* Set the maximal number of unused threads before threads will be stopped by
+ * GLib, -1 means no limit */
+void            g_thread_pool_set_max_unused_threads (gint      max_threads);
+gint            g_thread_pool_get_max_unused_threads (void);
+guint           g_thread_pool_get_num_unused_threads (void);
+
+/* Stop all currently unused threads, but leave the limit untouched */
+void            g_thread_pool_stop_unused_threads    (void);
+
+G_END_DECLS
+
+#endif /* __G_THREADPOOL_H__ */
+
diff --git a/gtimer.h b/gtimer.h
new file mode 100644 (file)
index 0000000..533a778
--- /dev/null
+++ b/gtimer.h
@@ -0,0 +1,53 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TIMER_H__
+#define __G_TIMER_H__
+
+#include <gtypes.h>
+
+G_BEGIN_DECLS
+
+/* Timer
+ */
+
+/* microseconds per second */
+typedef struct _GTimer         GTimer;
+
+#define G_USEC_PER_SEC 1000000
+
+GTimer* g_timer_new    (void);
+void   g_timer_destroy (GTimer  *timer);
+void   g_timer_start   (GTimer  *timer);
+void   g_timer_stop    (GTimer  *timer);
+void   g_timer_reset   (GTimer  *timer);
+gdouble g_timer_elapsed (GTimer         *timer,
+                        gulong  *microseconds);
+void    g_usleep        (gulong microseconds);
+
+G_END_DECLS
+
+#endif /* __G_TIMER_H__ */
diff --git a/gtree.h b/gtree.h
new file mode 100644 (file)
index 0000000..207d16c
--- /dev/null
+++ b/gtree.h
@@ -0,0 +1,64 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TREE_H__
+#define __G_TREE_H__
+
+#include <gnode.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GTree          GTree;
+
+typedef gint           (*GTraverseFunc)        (gpointer       key,
+                                                gpointer       value,
+                                                gpointer       data);
+
+/* Balanced binary trees
+ */
+GTree*  g_tree_new      (GCompareFunc   key_compare_func);
+void    g_tree_destroy  (GTree         *tree);
+void    g_tree_insert   (GTree         *tree,
+                         gpointer       key,
+                         gpointer       value);
+void    g_tree_remove   (GTree         *tree,
+                         gconstpointer  key);
+gpointer g_tree_lookup  (GTree         *tree,
+                         gconstpointer  key);
+void    g_tree_traverse (GTree         *tree,
+                         GTraverseFunc  traverse_func,
+                         GTraverseType  traverse_type,
+                         gpointer       data);
+gpointer g_tree_search  (GTree         *tree,
+                         GCompareFunc   search_func,
+                         gconstpointer  data);
+gint    g_tree_height   (GTree         *tree);
+gint    g_tree_nnodes   (GTree         *tree);
+
+G_END_DECLS
+
+#endif /* __G_TREE_H__ */
+
diff --git a/gtypes.h b/gtypes.h
new file mode 100644 (file)
index 0000000..ac856a7
--- /dev/null
+++ b/gtypes.h
@@ -0,0 +1,314 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.         See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_TYPES_H__
+#define __G_TYPES_H__
+
+#include <glibconfig.h>
+
+G_BEGIN_DECLS
+
+/* Provide type definitions for commonly used types.
+ *  These are useful because a "gint8" can be adjusted
+ *  to be 1 byte (8 bits) on all platforms. Similarly and
+ *  more importantly, "gint32" can be adjusted to be
+ *  4 bytes (32 bits) on all platforms.
+ */
+
+typedef char   gchar;
+typedef short  gshort;
+typedef long   glong;
+typedef int    gint;
+typedef gint   gboolean;
+typedef gchar* gstring;
+
+typedef unsigned char   guchar;
+typedef unsigned short  gushort;
+typedef unsigned long   gulong;
+typedef unsigned int    guint;
+
+typedef float   gfloat;
+typedef double  gdouble;
+
+/* HAVE_LONG_DOUBLE doesn't work correctly on all platforms.
+ * Since gldouble isn't used anywhere, just disable it for now */
+
+#if 0
+#ifdef HAVE_LONG_DOUBLE
+typedef long double gldouble;
+#else /* HAVE_LONG_DOUBLE */
+typedef double gldouble;
+#endif /* HAVE_LONG_DOUBLE */
+#endif /* 0 */
+
+typedef void* gpointer;
+typedef const void *gconstpointer;
+
+typedef gint            (*GCompareFunc)         (gconstpointer  a,
+                                                 gconstpointer  b);
+typedef void            (*GDestroyNotify)       (gpointer       data);
+typedef void            (*GFunc)                (gpointer       data,
+                                                 gpointer       user_data);
+typedef guint           (*GHashFunc)            (gconstpointer  key);
+typedef void            (*GHFunc)               (gpointer       key,
+                                                 gpointer       value,
+                                                 gpointer       user_data);
+
+/* Define some mathematical constants that aren't available
+ * symbolically in some strict ISO C implementations.
+ */
+#define G_E     2.7182818284590452354E0
+#define G_LN2   6.9314718055994530942E-1
+#define G_LN10  2.3025850929940456840E0
+#define G_PI    3.14159265358979323846E0
+#define G_PI_2  1.57079632679489661923E0
+#define G_PI_4  0.78539816339744830962E0
+#define G_SQRT2 1.4142135623730950488E0
+
+/* Portable endian checks and conversions
+ *
+ * glibconfig.h defines G_BYTE_ORDER which expands to one of
+ * the below macros.
+ */
+#define G_LITTLE_ENDIAN 1234
+#define G_BIG_ENDIAN    4321
+#define G_PDP_ENDIAN    3412           /* unused, need specific PDP check */   
+
+
+/* Basic bit swapping functions
+ */
+#define GUINT16_SWAP_LE_BE_CONSTANT(val)       ((guint16) ( \
+    (((guint16) (val) & (guint16) 0x00ffU) << 8) | \
+    (((guint16) (val) & (guint16) 0xff00U) >> 8)))
+#define GUINT32_SWAP_LE_BE_CONSTANT(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x000000ffU) << 24) | \
+    (((guint32) (val) & (guint32) 0x0000ff00U) <<  8) | \
+    (((guint32) (val) & (guint32) 0x00ff0000U) >>  8) | \
+    (((guint32) (val) & (guint32) 0xff000000U) >> 24)))
+
+/* Intel specific stuff for speed
+ */
+#if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#  define GUINT16_SWAP_LE_BE_X86(val) \
+     (__extension__                                    \
+      ({ register guint16 __v;                         \
+        if (__builtin_constant_p (val))                \
+          __v = GUINT16_SWAP_LE_BE_CONSTANT (val);     \
+        else                                           \
+          __asm__ __const__ ("rorw $8, %w0"            \
+                             : "=r" (__v)              \
+                             : "0" ((guint16) (val))); \
+       __v; }))
+#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_X86 (val))
+#  if !defined(__i486__) && !defined(__i586__) \
+      && !defined(__pentium__) && !defined(__i686__) && !defined(__pentiumpro__)
+#     define GUINT32_SWAP_LE_BE_X86(val) \
+        (__extension__                                         \
+         ({ register guint32 __v;                              \
+           if (__builtin_constant_p (val))                     \
+             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
+         else                                                  \
+           __asm__ __const__ ("rorw $8, %w0\n\t"               \
+                              "rorl $16, %0\n\t"               \
+                              "rorw $8, %w0"                   \
+                              : "=r" (__v)                     \
+                              : "0" ((guint32) (val)));        \
+       __v; }))
+#  else /* 486 and higher has bswap */
+#     define GUINT32_SWAP_LE_BE_X86(val) \
+        (__extension__                                         \
+         ({ register guint32 __v;                              \
+           if (__builtin_constant_p (val))                     \
+             __v = GUINT32_SWAP_LE_BE_CONSTANT (val);          \
+         else                                                  \
+           __asm__ __const__ ("bswap %0"                       \
+                              : "=r" (__v)                     \
+                              : "0" ((guint32) (val)));        \
+       __v; }))
+#  endif /* processor specific 32-bit stuff */
+#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_X86 (val))
+#else /* !__i386__ */
+#  define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val))
+#  define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val))
+#endif /* __i386__ */
+
+#ifdef G_HAVE_GINT64
+#  define GUINT64_SWAP_LE_BE_CONSTANT(val)     ((guint64) ( \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00000000000000ffU)) << 56) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x000000000000ff00U)) << 40) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x0000000000ff0000U)) << 24) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00000000ff000000U)) <<  8) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x000000ff00000000U)) >>  8) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x0000ff0000000000U)) >> 24) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0x00ff000000000000U)) >> 40) |      \
+      (((guint64) (val) &                                              \
+       (guint64) G_GINT64_CONSTANT(0xff00000000000000U)) >> 56)))
+#  if defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
+#    define GUINT64_SWAP_LE_BE_X86(val) \
+       (__extension__                                          \
+        ({ union { guint64 __ll;                               \
+                   guint32 __l[2]; } __r;                      \
+           if (__builtin_constant_p (val))                     \
+             __r.__ll = GUINT64_SWAP_LE_BE_CONSTANT (val);     \
+           else                                                \
+             {                                                 \
+               union { guint64 __ll;                           \
+                       guint32 __l[2]; } __w;                  \
+               __w.__ll = ((guint64) val);                     \
+               __r.__l[0] = GUINT32_SWAP_LE_BE (__w.__l[1]);   \
+               __r.__l[1] = GUINT32_SWAP_LE_BE (__w.__l[0]);   \
+             }                                                 \
+         __r.__ll; }))
+#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_X86 (val))
+#  else /* !__i386__ */
+#    define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT(val))
+#  endif
+#endif
+
+#define GUINT16_SWAP_LE_PDP(val)       ((guint16) (val))
+#define GUINT16_SWAP_BE_PDP(val)       (GUINT16_SWAP_LE_BE (val))
+#define GUINT32_SWAP_LE_PDP(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x0000ffffU) << 16) | \
+    (((guint32) (val) & (guint32) 0xffff0000U) >> 16)))
+#define GUINT32_SWAP_BE_PDP(val)       ((guint32) ( \
+    (((guint32) (val) & (guint32) 0x00ff00ffU) << 8) | \
+    (((guint32) (val) & (guint32) 0xff00ff00U) >> 8)))
+
+/* The G*_TO_?E() macros are defined in glibconfig.h.
+ * The transformation is symmetric, so the FROM just maps to the TO.
+ */
+#define GINT16_FROM_LE(val)    (GINT16_TO_LE (val))
+#define GUINT16_FROM_LE(val)   (GUINT16_TO_LE (val))
+#define GINT16_FROM_BE(val)    (GINT16_TO_BE (val))
+#define GUINT16_FROM_BE(val)   (GUINT16_TO_BE (val))
+#define GINT32_FROM_LE(val)    (GINT32_TO_LE (val))
+#define GUINT32_FROM_LE(val)   (GUINT32_TO_LE (val))
+#define GINT32_FROM_BE(val)    (GINT32_TO_BE (val))
+#define GUINT32_FROM_BE(val)   (GUINT32_TO_BE (val))
+
+#ifdef G_HAVE_GINT64
+#define GINT64_FROM_LE(val)    (GINT64_TO_LE (val))
+#define GUINT64_FROM_LE(val)   (GUINT64_TO_LE (val))
+#define GINT64_FROM_BE(val)    (GINT64_TO_BE (val))
+#define GUINT64_FROM_BE(val)   (GUINT64_TO_BE (val))
+#endif
+
+#define GLONG_FROM_LE(val)     (GLONG_TO_LE (val))
+#define GULONG_FROM_LE(val)    (GULONG_TO_LE (val))
+#define GLONG_FROM_BE(val)     (GLONG_TO_BE (val))
+#define GULONG_FROM_BE(val)    (GULONG_TO_BE (val))
+
+#define GINT_FROM_LE(val)      (GINT_TO_LE (val))
+#define GUINT_FROM_LE(val)     (GUINT_TO_LE (val))
+#define GINT_FROM_BE(val)      (GINT_TO_BE (val))
+#define GUINT_FROM_BE(val)     (GUINT_TO_BE (val))
+
+
+/* Portable versions of host-network order stuff
+ */
+#define g_ntohl(val) (GUINT32_FROM_BE (val))
+#define g_ntohs(val) (GUINT16_FROM_BE (val))
+#define g_htonl(val) (GUINT32_TO_BE (val))
+#define g_htons(val) (GUINT16_TO_BE (val))
+
+/* IEEE Standard 754 Single Precision Storage Format (gfloat):
+ *
+ *        31 30           23 22            0
+ * +--------+---------------+---------------+
+ * | s 1bit | e[30:23] 8bit | f[22:0] 23bit |
+ * +--------+---------------+---------------+
+ * B0------------------->B1------->B2-->B3-->
+ *
+ * IEEE Standard 754 Double Precision Storage Format (gdouble):
+ *
+ *        63 62            52 51            32   31            0
+ * +--------+----------------+----------------+ +---------------+
+ * | s 1bit | e[62:52] 11bit | f[51:32] 20bit | | f[31:0] 32bit |
+ * +--------+----------------+----------------+ +---------------+
+ * B0--------------->B1---------->B2--->B3---->  B4->B5->B6->B7->
+ */
+/* subtract from biased_exponent to form base2 exponent (normal numbers) */
+typedef union  _GDoubleIEEE754 GDoubleIEEE754;
+typedef union  _GFloatIEEE754  GFloatIEEE754;
+#define G_IEEE754_FLOAT_BIAS   (127)
+#define G_IEEE754_DOUBLE_BIAS  (1023)
+/* multiply with base2 exponent to get base10 exponent (nomal numbers) */
+#define G_LOG_2_BASE_10                (0.30102999566398119521)
+#if G_BYTE_ORDER == G_LITTLE_ENDIAN
+union _GFloatIEEE754
+{
+  gfloat v_float;
+  struct {
+    guint mantissa : 23;
+    guint biased_exponent : 8;
+    guint sign : 1;
+  } mpn;
+};
+union _GDoubleIEEE754
+{
+  gdouble v_double;
+  struct {
+    guint mantissa_low : 32;
+    guint mantissa_high : 20;
+    guint biased_exponent : 11;
+    guint sign : 1;
+  } mpn;
+};
+#elif G_BYTE_ORDER == G_BIG_ENDIAN
+union _GFloatIEEE754
+{
+  gfloat v_float;
+  struct {
+    guint sign : 1;
+    guint biased_exponent : 8;
+    guint mantissa : 23;
+  } mpn;
+};
+union _GDoubleIEEE754
+{
+  gdouble v_double;
+  struct {
+    guint sign : 1;
+    guint biased_exponent : 11;
+    guint mantissa_high : 20;
+    guint mantissa_low : 32;
+  } mpn;
+};
+#else /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
+#error unknown ENDIAN type
+#endif /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */
+
+G_END_DECLS
+
+#endif /* __G_TYPES_H__ */
+
index 396c6bc..442784c 100644 (file)
  *   Boston, MA 02111-1307, USA.
  */
 
-#ifndef __GUNICODE_H__
-#define __GUNICODE_H__
+#ifndef __G_UNICODE_H__
+#define __G_UNICODE_H__
 
 #include <stddef.h>      /* For size_t */
+#include <gtypes.h>
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif
+G_BEGIN_DECLS
 
 typedef guint32 gunichar;
 typedef guint16 gunichar2;
@@ -193,8 +191,6 @@ gboolean g_utf8_validate (const gchar  *str,
                           gint          len,
                           const gchar **end);
 
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
 
-#endif /* GUNICODE_H */
+#endif /* __G_UNICODE_H__ */
diff --git a/gutils.h b/gutils.h
new file mode 100644 (file)
index 0000000..62cc215
--- /dev/null
+++ b/gutils.h
@@ -0,0 +1,333 @@
+/* GLIB - Library of useful routines for C programming
+ * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GLib Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GLib at ftp://ftp.gtk.org/pub/gtk/. 
+ */
+
+#ifndef __G_UTILS_H__
+#define __G_UTILS_H__
+
+#include <gtypes.h>
+#include <stdarg.h>
+
+G_BEGIN_DECLS
+
+#ifdef G_OS_WIN32
+
+/* On native Win32, directory separator is the backslash, and search path
+ * separator is the semicolon.
+ */
+#define G_DIR_SEPARATOR '\\'
+#define G_DIR_SEPARATOR_S "\\"
+#define G_SEARCHPATH_SEPARATOR ';'
+#define G_SEARCHPATH_SEPARATOR_S ";"
+
+#else  /* !G_OS_WIN32 */
+
+/* Unix */
+
+#define G_DIR_SEPARATOR '/'
+#define G_DIR_SEPARATOR_S "/"
+#define G_SEARCHPATH_SEPARATOR ':'
+#define G_SEARCHPATH_SEPARATOR_S ":"
+
+#endif /* !G_OS_WIN32 */
+
+/* Define G_VA_COPY() to do the right thing for copying va_list variables.
+ * glibconfig.h may have already defined G_VA_COPY as va_copy or __va_copy.
+ */
+#if !defined (G_VA_COPY)
+#  if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
+#    define G_VA_COPY(ap1, ap2)          (*(ap1) = *(ap2))
+#  elif defined (G_VA_COPY_AS_ARRAY)
+#    define G_VA_COPY(ap1, ap2)          g_memmove ((ap1), (ap2), sizeof (va_list))
+#  else /* va_list is a pointer */
+#    define G_VA_COPY(ap1, ap2)          ((ap1) = (ap2))
+#  endif /* va_list is a pointer */
+#endif /* !G_VA_COPY */
+
+/* inlining hassle. for compilers that don't allow the `inline' keyword,
+ * mostly because of strict ANSI C compliance or dumbness, we try to fall
+ * back to either `__inline__' or `__inline'.
+ * we define G_CAN_INLINE, if the compiler seems to be actually
+ * *capable* to do function inlining, in which case inline function bodys
+ * do make sense. we also define G_INLINE_FUNC to properly export the
+ * function prototypes if no inlining can be performed.
+ * inline function bodies have to be special cased with G_CAN_INLINE and a
+ * .c file specific macro to allow one compiled instance with extern linkage
+ * of the functions by defining G_IMPLEMENT_INLINES and the .c file macro.
+ */
+#ifdef G_IMPLEMENT_INLINES
+#  define G_INLINE_FUNC extern
+#  undef  G_CAN_INLINE
+#endif
+#ifndef G_INLINE_FUNC
+#  define G_CAN_INLINE 1
+#endif
+#if defined (G_HAVE_INLINE) && defined (__GNUC__) && defined (__STRICT_ANSI__)
+#  undef inline
+#  define inline __inline__
+#elif !defined (G_HAVE_INLINE)
+#  undef inline
+#  if defined (G_HAVE___INLINE__)
+#    define inline __inline__
+#  elif defined (G_HAVE___INLINE)
+#    define inline __inline
+#  else /* !inline && !__inline__ && !__inline */
+#    define inline  /* don't inline, then */
+#    ifndef G_INLINE_FUNC
+#      undef G_CAN_INLINE
+#    endif
+#  endif
+#endif
+#ifndef G_INLINE_FUNC
+#  if defined (__GNUC__) && (__OPTIMIZE__)
+#    define G_INLINE_FUNC extern inline
+#  elif defined (G_CAN_INLINE) && !defined (__GNUC__)
+#    define G_INLINE_FUNC static inline
+#  else /* can't inline */
+#    define G_INLINE_FUNC extern
+#    undef G_CAN_INLINE
+#  endif
+#endif /* !G_INLINE_FUNC */
+
+/* Retrive static string info
+ */
+gchar* g_get_user_name         (void);
+gchar* g_get_real_name         (void);
+gchar* g_get_home_dir          (void);
+gchar* g_get_tmp_dir           (void);
+gchar* g_get_prgname           (void);
+void   g_set_prgname           (const gchar *prgname);
+
+
+typedef struct _GDebugKey      GDebugKey;
+struct _GDebugKey
+{
+  gchar *key;
+  guint         value;
+};
+
+/* Miscellaneous utility functions
+ */
+guint  g_parse_debug_string    (const gchar *string,
+                                GDebugKey   *keys,
+                                guint        nkeys);
+gint   g_snprintf              (gchar       *string,
+                                gulong       n,
+                                gchar const *format,
+                                ...) G_GNUC_PRINTF (3, 4);
+gint   g_vsnprintf             (gchar       *string,
+                                gulong       n,
+                                gchar const *format,
+                                va_list      args);
+/* Check if a file name is an absolute path */
+gboolean g_path_is_absolute    (const gchar *file_name);
+/* In case of absolute paths, skip the root part */
+gchar*  g_path_skip_root       (gchar       *file_name);
+
+/* These two functions are deprecated and will be removed in the next
+ * major release of GLib. Use g_path_get_dirname/g_path_get_basename
+ * instead. Whatch out! The string returned by g_path_get_basename
+ * must be g_freed, while the string returned by g_basename must not.*/
+gchar* g_basename              (const gchar *file_name);
+gchar* g_dirname               (const gchar *file_name);
+
+/* The returned strings are newly allocated with g_malloc() */
+gchar* g_get_current_dir       (void);
+gchar* g_path_get_basename     (const gchar *file_name);
+gchar* g_path_get_dirname      (const gchar *file_name);
+
+/* Get the codeset for the current locale */
+/* gchar * g_get_codeset    (void); */
+
+/* return the environment string for the variable. The returned memory
+ * must not be freed. */
+gchar*  g_getenv               (const gchar *variable);
+
+
+/* we try to provide a usefull equivalent for ATEXIT if it is
+ * not defined, but use is actually abandoned. people should
+ * use g_atexit() instead.
+ */
+typedef        void            (*GVoidFunc)            (void);
+#ifndef ATEXIT
+# define ATEXIT(proc)  g_ATEXIT(proc)
+#else
+# define G_NATIVE_ATEXIT
+#endif /* ATEXIT */
+/* we use a GLib function as a replacement for ATEXIT, so
+ * the programmer is not required to check the return value
+ * (if there is any in the implementation) and doesn't encounter
+ * missing include files.
+ */
+void   g_atexit                (GVoidFunc    func);
+
+
+/* Bit tests
+ */
+G_INLINE_FUNC gint     g_bit_nth_lsf (guint32 mask,
+                                      gint    nth_bit);
+G_INLINE_FUNC gint     g_bit_nth_msf (guint32 mask,
+                                      gint    nth_bit);
+G_INLINE_FUNC guint    g_bit_storage (guint number);
+
+/* Trash Stacks
+ * elements need to be >= sizeof (gpointer)
+ */
+typedef struct _GTrashStack     GTrashStack;
+struct _GTrashStack
+{
+  GTrashStack *next;
+};
+
+G_INLINE_FUNC void     g_trash_stack_push      (GTrashStack **stack_p,
+                                                gpointer      data_p);
+G_INLINE_FUNC gpointer g_trash_stack_pop       (GTrashStack **stack_p);
+G_INLINE_FUNC gpointer g_trash_stack_peek      (GTrashStack **stack_p);
+G_INLINE_FUNC guint    g_trash_stack_height    (GTrashStack **stack_p);
+
+/* inline function implementations
+ */
+#if defined (G_CAN_INLINE) || defined (__G_UTILS_C__)
+G_INLINE_FUNC gint
+g_bit_nth_lsf (guint32 mask,
+              gint    nth_bit)
+{
+  do
+    {
+      nth_bit++;
+      if (mask & (1 << (guint) nth_bit))
+       return nth_bit;
+    }
+  while (nth_bit < 32);
+  return -1;
+}
+G_INLINE_FUNC gint
+g_bit_nth_msf (guint32 mask,
+              gint    nth_bit)
+{
+  if (nth_bit < 0)
+    nth_bit = 32;
+  do
+    {
+      nth_bit--;
+      if (mask & (1 << (guint) nth_bit))
+       return nth_bit;
+    }
+  while (nth_bit > 0);
+  return -1;
+}
+G_INLINE_FUNC guint
+g_bit_storage (guint number)
+{
+  register guint n_bits = 0;
+  
+  do
+    {
+      n_bits++;
+      number >>= 1;
+    }
+  while (number);
+  return n_bits;
+}
+G_INLINE_FUNC void
+g_trash_stack_push (GTrashStack **stack_p,
+                   gpointer      data_p)
+{
+  GTrashStack *data = (GTrashStack *) data_p;
+
+  data->next = *stack_p;
+  *stack_p = data;
+}
+G_INLINE_FUNC gpointer
+g_trash_stack_pop (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+
+  data = *stack_p;
+  if (data)
+    {
+      *stack_p = data->next;
+      /* NULLify private pointer here, most platforms store NULL as
+       * subsequent 0 bytes
+       */
+      data->next = NULL;
+    }
+
+  return data;
+}
+G_INLINE_FUNC gpointer
+g_trash_stack_peek (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+
+  data = *stack_p;
+
+  return data;
+}
+G_INLINE_FUNC guint
+g_trash_stack_height (GTrashStack **stack_p)
+{
+  GTrashStack *data;
+  guint i = 0;
+
+  for (data = *stack_p; data; data = data->next)
+    i++;
+
+  return i;
+}
+#endif  /* G_CAN_INLINE || __G_UTILS_C__ */
+
+/* Glib version.
+ * we prefix variable declarations so they can
+ * properly get exported in windows dlls.
+ */
+#ifdef G_OS_WIN32
+#  ifdef GLIB_COMPILATION
+#    define GLIB_VAR __declspec(dllexport)
+#  else /* !GLIB_COMPILATION */
+#    define GLIB_VAR extern __declspec(dllimport)
+#  endif /* !GLIB_COMPILATION */
+#else /* !G_OS_WIN32 */
+#  define GLIB_VAR extern
+#endif /* !G_OS_WIN32 */
+
+GLIB_VAR const guint glib_major_version;
+GLIB_VAR const guint glib_minor_version;
+GLIB_VAR const guint glib_micro_version;
+GLIB_VAR const guint glib_interface_age;
+GLIB_VAR const guint glib_binary_age;
+
+#define GLIB_CHECK_VERSION(major,minor,micro)    \
+    (GLIB_MAJOR_VERSION > (major) || \
+     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \
+     (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION == (minor) && \
+      GLIB_MICRO_VERSION >= (micro)))
+
+G_END_DECLS
+
+#endif /* __G_UTILS_H__ */
+
+
+