Released GLib 1.1.4GLIB_1_1_4

Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>

        * Released GLib 1.1.4

        * docs/Makefile.am:
        * docs/.cvsignore
        * docs/glib-config.1:
        * docs/glib.texi: Moved docs from gtk and created glib-config.1
        from gtk-config.1 in gtk

        * configure.in:
        * Makefile.am:
        * sanity_check: added in docs directory, change rule 'release'
        to 'snapshot' and created a new 'release' rule for doing the
        distribution.  Added in a 'sanity' rule.

        * NEWS:
        * README:
        * INSTALL: Updated for the release

19 files changed, 786 insertions, 13 deletions

diff --git a/ChangeLog b/ChangeLog
index d506fd927..5bc38f602 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-0
+++ b/ChangeLog.pre-2-0
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-12 b/ChangeLog.pre-2-12
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-12
+++ b/ChangeLog.pre-2-12
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-2
+++ b/ChangeLog.pre-2-2
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index d506fd927..5bc38f602 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,23 @@
+Sun Oct 25 01:24:01 CST 1998 Shawn T. Amundson <amundson@gtk.org>
+
+	* Released GLib 1.1.4
+
+	* docs/Makefile.am:
+	* docs/.cvsignore
+	* docs/glib-config.1: 
+	* docs/glib.texi: Moved docs from gtk and created glib-config.1 
+	from gtk-config.1 in gtk
+
+	* configure.in:
+	* Makefile.am:
+	* sanity_check: added in docs directory, change rule 'release'
+	to 'snapshot' and created a new 'release' rule for doing the
+	distribution.  Added in a 'sanity' rule.
+
+	* NEWS:
+	* README: 
+	* INSTALL: Updated for the release
+
 Sun Oct 25 07:30:10 1998  Tim Janik  <timj@gtk.org>
 
 	* gscanner.c:
diff --git a/INSTALL b/INSTALL
index d9f95ac58..41ecedd3c 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,8 +1,8 @@
 Simple install procedure
 ========================
 
-  % gzip -cd glib-1.1.3.tar.gz | tar xvf - # unpack the sources
-  % cd glib-1.1.3                          # change to the toplevel directory
+  % gzip -cd glib-1.1.4.tar.gz | tar xvf - # unpack the sources
+  % cd glib-1.1.4                          # change to the toplevel directory
   % ./configure                            # run the `configure' script
   % make                                   # build GLIB
   [ Become root if necessary ]
diff --git a/Makefile.am b/Makefile.am
index 25b3fa8b1..829a7c793 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,6 +1,6 @@
 ## Process this file with automake to produce Makefile.in
 
-SUBDIRS = gmodule
+SUBDIRS = gmodule docs
 
 configincludedir = $(pkglibdir)/include
 
@@ -10,9 +10,10 @@ glib-config: glib-config.in
 
 DEFS += -DG_LOG_DOMAIN=g_log_domain_glib
 
-EXTRA_DIST =	\
-		glib.m4 \
-		glib.spec
+EXTRA_DIST =			\
+		glib.m4		\
+		glib.spec	\
+		sanity_check
 
 # build . first, then SUBDIRS
 all-recursive-am: all-am
@@ -57,7 +58,7 @@ testglib_LDADD = libglib.la
 m4datadir = $(datadir)/aclocal
 m4data_DATA = glib.m4
 
-.PHONY: files release
+.PHONY: files release sanity snapshot
 
 files:
 	@files=`ls $(DISTFILES) 2> /dev/null `; for p in $$files; do \
@@ -65,4 +66,12 @@ files:
 	done
 
 release:
+	rm -rf .deps */.deps
+	cd docs && make glib.html
+	$(MAKE) distcheck
+
+sanity:
+	./sanity_check $(VERSION)
+
+snapshot:
 	$(MAKE) dist distdir=$(PACKAGE)`date +"%y%m%d"`
diff --git a/NEWS b/NEWS
index 9449005de..67f453efb 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,10 @@
+Overview of Changes in GLib 1.1.4:
+
+* Added generic callback maintenance functions (ghook)
+* New endian defines (G_*_ENDIAN)
+* New string join/split/free routines 
+* Fixes
+
 Overview of Changes in GLib 1.1.3:
 
 * New GModule mechanism (implemented in an extra library) which wraps dynamic
diff --git a/README b/README
index c706a0978..ad43cbf64 100644
--- a/README
+++ b/README
@@ -1,7 +1,7 @@
 General Information
 ===================
 
-This is GLib version 1.1.3. GLib, is a library which includes support
+This is GLib version 1.1.4. GLib, is a library which includes support
 routines for C such as lists, trees, hashes, memory allocation, and
 many other things.
 
diff --git a/configure.in b/configure.in
index e840ba28a..b259e54f8 100644
--- a/configure.in
+++ b/configure.in
@@ -479,4 +479,5 @@ Makefile
 glib-config
 gmodule/gmoduleconf.h
 gmodule/Makefile
+docs/Makefile
 ],[chmod +x glib-config])
diff --git a/docs/.cvsignore b/docs/.cvsignore
new file mode 100644
index 000000000..61df8a423
--- /dev/null
+++ b/docs/.cvsignore
@@ -0,0 +1,18 @@
+Makefile
+Makefile.in
+*.html
+*.info*
+*.dvi
+*.ps
+*.pg
+*.ky
+*.cp
+*.fn
+*.tp
+*.vr
+*.log
+*.aux
+*.toc
+*.cps
+*.fns
+*.vrs
diff --git a/docs/Makefile.am b/docs/Makefile.am
new file mode 100644
index 000000000..94c43be76
--- /dev/null
+++ b/docs/Makefile.am
@@ -0,0 +1,20 @@
+## Process this file with automake to produce Makefile.in
+
+info_TEXINFOS = glib.texi
+
+man_MANS = glib-config.1
+
+EXTRA_DIST = glib-config.1	\
+	     glib.html 		\
+	     glib_toc.html
+
+glib.html:
+	texi2html glib.texi
+
+glib_toc.html:
+	texi2html glib.texi
+
+files:
+	@files=`ls $(DISTFILES) 2> /dev/null `; for p in $$files; do \
+	  echo $$p; \
+	done
diff --git a/docs/glib-config.1 b/docs/glib-config.1
new file mode 100644
index 000000000..03fd2be01
--- /dev/null
+++ b/docs/glib-config.1
@@ -0,0 +1,53 @@
+.TH GLIB 1 "24 October 1998" Version 1.1.4
+.SH NAME
+glib-config - script to get information about the installed version of GLib
+.SH SYNOPSIS
+.B  glib-config [\-\-prefix\fI[=DIR]\fP] [\-\-exec\-prefix\fI[=DIR]\fP] [\-\-version] [\-\-libs] [\-\-cflags] [LIBRARIES]
+.SH DESCRIPTION
+.PP
+\fIglib-config\fP is a tool that is used to configure to determine
+the compiler and linker flags that should be used to compile
+and link programs that use \fIGLib\fP. It is also used internally
+to the .m4 macros for GNU autoconf that are included with \fIGLib\fP.
+.
+.SH OPTIONS
+.l
+\fIglib-config\fP accepts the following options:
+.TP 8
+.B  LIBRARIES
+\fIGLib\fP has two libraries 'glib' and 'gmodule'.  If you specify one of
+them, only the appropriate things for that library will be printed.
+.TP 8
+.B  \-\-version
+Print the currently installed version of \fIGLib\fP on the standard output.
+.TP 8
+.B  \-\-libs
+Print the linker flags that are necessary to link a \fIGLib\fP program.
+.TP 8
+.B  \-\-cflags
+Print the compiler flags that are necessary to compile a \fIGLib\fP program.
+.TP 8
+.B  \-\-prefix=PREFIX
+If specified, use PREFIX instead of the installation prefix that \fIGLib\fP
+was built with when computing the output for the \-\-cflags and
+\-\-libs options. This option is also used for the exec prefix
+if \-\-exec\-prefix was not specified. This option must be specified
+before any \-\-libs or \-\-cflags options.
+.TP 8
+.B  \-\-exec\-prefix=PREFIX
+If specified, use PREFIX instead of the installation exec prefix that
+\fIGLib\fP was built with when computing the output for the \-\-cflags
+and \-\-libs options.  This option must be specified before any
+\-\-libs or \-\-cflags options.
+.SH SEE ALSO
+.BR gtk-config (1),
+.BR gimp (1),
+.BR gimptool (1)
+.SH COPYRIGHT
+Copyright \(co  1998 Owen Taylor
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation.
diff --git a/docs/glib.texi b/docs/glib.texi
new file mode 100644
index 000000000..1bf23e191
--- /dev/null
+++ b/docs/glib.texi
@@ -0,0 +1,455 @@
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename glib.info
+@settitle GLIB
+@setchapternewpage odd
+
+@set edition 1.0
+@set update-date 3 Feburary 1998
+@set update-month Feburary 1998
+@c %**end of header
+
+@ifinfo
+This file documents GLIB, A library of useful routines for C programming
+
+Copyright (C) 1998 Gregory A McLean
+
+Permission is granted to make and distributed verbatim copies of this
+manual, provided the copyright notice and this permission notice are
+preserved on all copies. 
+
+@ignore
+Permission is granted to process this file throught TeX and print the 
+results, provided the printed document carries copying permission notice 
+identical to this one except for the removal of this paragraph (this 
+paragraph not being relevant to the printed manual).
+
+@end ignore
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions,
+except that this permission notice may be stated in a translation
+approved by Gregory McLean.
+@end ifinfo
+
+@titlepage
+@title GLIB, Useful routines for C programming 
+@subtitle Version 1.0
+@subtitle @value{update-month}
+@author by Gregory McLean
+
+@page
+@vskip 0pt plus 1filll
+Copyright @copyright{} 1998 Gregory McLean
+
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions,
+except that this permission notice may be stated in a translation
+approved by Gregory McLean.
+@end titlepage
+
+@dircategory Library of useful routines for 'C' programing
+@direntry
+* GLIB: (glib).        useful routines for 'C' programming
+@end direntry
+
+@node Top, Copying, (dir), (dir)
+@top useful routines for 'C' programming
+@ifinfo
+This is edition @value{edition} of the GLIB documentation,
+@w{@value{update-date}}.
+@end ifinfo
+
+@menu
+* Copying::                     Your rights.
+* Overview::                    What is GLIB?
+* Doubly linked lists::         Doubly linked lists
+* Signly linked lists::         Singly linked lists
+* List allocators::             List Allocators
+* Hash tables::                 Hash tables
+* Caches::                      Cache handling
+* Trees::                       Tree handling
+* Memory::                      Memory handling
+* Timers::                      Timer functions
+* Output::                      Output handling
+* Utilities::                   Utilitiy functions
+* Errors::                      Error handling
+* String Chunks::               String Chunks
+* Strings::                     String handling
+* Resizable arrays::            Resizeable arrays
+* GScanner::                    Flexible lexical scanner
+* Miscellany::                  Other stuff
+* Function Index::              Index of functions
+* Concept Index::               Index of concepts
+@end menu
+
+@node Copying, Overview, Top, Top
+@comment node-name, next, previous, up
+@chapter Copying
+
+@node Overview, Doubly linked lists, Copying, Top
+@comment node-name, next, previous, up
+@chapter What is GLIB
+
+@node Doubly linked lists, Signly linked lists, Overview, Top
+@comment node-name, next, previous, up
+@chapter Doubly linked lists
+
+@subsection Functions
+
+@deftypefun GList* g_list_alloc (void)
+@end deftypefun
+
+@deftypefun void g_list_free (GList *@var{list})
+@end deftypefun
+
+@deftypefun void g_list_free_1 (GList *@var{list})
+@end deftypefun
+
+@deftypefun GList* g_list_append (GList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GList* g_list_prepend (GList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GList* g_list_insert (GList *@var{list}, gpointer @var{data}, gint @var{position})
+@end deftypefun
+
+@deftypefun GList* g_list_insert_sorted (GList *@var{list}, gpointer @var{data}, GCompareFunc @var{func})
+@end deftypefun
+
+@deftypefun GList* g_list_concat (GList *@var{list1}, GList *@var{list2})
+@end deftypefun
+
+@deftypefun GList* g_list_remove (GList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GList* g_list_remove_link (GList *@var{list}, GList *@var{link})
+@end deftypefun
+
+@deftypefun GList* g_list_reverse (GList *@var{list})
+@end deftypefun
+
+@deftypefun GList* g_list_nth (GList *@var{list}, gint @var{n})
+@end deftypefun
+
+@deftypefun GList* g_list_find (GList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GList* g_list_last (GList *@var{list})
+@end deftypefun
+
+@deftypefun GList* g_list_first (GList *@var{list})
+@end deftypefun
+
+@deftypefun gint g_list_length (GList *@var{list})
+@end deftypefun
+
+@deftypefun void g_list_foreach (GList *@var{list}, GFunc @var{func}, gpointer @var{user_data})
+@end deftypefun
+
+@node Signly linked lists, List allocators, Doubly linked lists, Top
+@comment node-name, next, previous, up
+@chapter Signly linked lists
+
+@subsection Functions
+@deftypefun GSList* g_slist_alloc (void)
+@end deftypefun
+
+@deftypefun void g_slist_free (GSList *@var{list})
+@end deftypefun
+
+@deftypefun void g_slist_free_1 (GSList *@var{list})
+@end deftypefun
+
+@deftypefun GSList* g_slist_append (GSList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GSList* g_slist_prepend (GSList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GSList* g_slist_insert (GSList *@var{list}, gpointer @var{data}, gint @var{position})
+@end deftypefun
+
+@deftypefun GSList* g_slist_insert_sorted (GSList *@var{list}, gpointer @var{data}, GCompareFunc @var{func})
+@end deftypefun
+
+@deftypefun GSList* g_slist_concat (GSList *@var{list1}, GSList *@var{list2})
+@end deftypefun
+
+@deftypefun GSList* g_slist_remove (GSList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GSList* g_slist_remove_link (GSList *@var{list}, GSList *@var{link})
+@end deftypefun
+
+@deftypefun GSList* g_slist_reverse (GSList *@var{list})
+@end deftypefun
+
+@deftypefun GSList* g_slist_nth (GSList *@var{list}, gint @var{n})
+@end deftypefun
+
+@deftypefun GSList* g_slist_find (GSList *@var{list}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun GSList* g_slist_last (GSList *@var{list})
+@end deftypefun
+
+@deftypefun gint g_slist_length (GSList *@var{list})
+@end deftypefun
+
+@deftypefun void g_slist_foreach (GSList *@var{list}, GFunc @var{func}, gpointer @var{user_data})
+@end deftypefun
+
+@node List allocators, Hash tables, Signly linked lists, Top
+@comment node-name, next, previous, up
+@chapter List allocators
+
+@subsection Functions
+
+@deftypefun GListAllocator* g_list_allocator_new (void)
+@end deftypefun
+
+@deftypefun void g_list_allocator_free (GListAllocator *@var{allocator})
+@end deftypefun
+
+@deftypefun GListAllocator* g_slist_set_allocator (GListAllocator *@var{allocator})
+@end deftypefun
+
+@deftypefun GListAllocator* g_list_set_allocator (GListAllocator *@var{allocator})
+@end deftypefun
+
+@node Hash tables, Caches, List allocators, Top
+@comment node-name, next, previous, up
+@chapter Hash tables
+
+@subsection Functions
+
+@deftypefun GHashTable* g_hash_table_new (GHashFunc @var{hash_func}, GCompareFunc @var{key_compare_func})
+@end deftypefun
+
+@deftypefun void g_hash_table_destroy (GHashTable *@var{hash_table})
+@end deftypefun
+
+@deftypefun void g_hash_table_insert (GHashTable *@var{hash_table}, gpointer @var{key}, gpointer @var{value})
+@end deftypefun
+
+@deftypefun void g_hash_table_remove (GHashTable *@var{hash_table}, gpointer @var{key})
+@end deftypefun
+
+@deftypefun gpointer g_hash_table_lookup (GHashTable *@var{hash_table}, gpointer @var{key})
+@end deftypefun
+
+@deftypefun void g_hash_table_freeze (GHashTable *@var{hash_table})
+@end deftypefun
+
+@deftypefun void g_hash_table_thaw (GHashTable *@var{hash_table})
+@end deftypefun
+
+@deftypefun void g_hash_table_foreach (GHashTable *@var{hash_table}, GHFunc @var{func}, gpointer @var{user_data})
+@end deftypefun
+
+@node Caches, Trees, Hash tables, Top
+@comment node-name, next, previous, up
+@chapter Cache handling
+
+@subsection Functions
+
+@deftypefun GCache* g_cache_new (GCacheNewFunc @var{value_new_func}, GCacheDestroyFunc @var{value_destroy_func}, GCacheDupFunc @var{key_dup_func}, GCacheDestroyFunc @var{key_destroy_func}, GHashFunc @var{hash_key_func}, GHashFunc @var{hash_value_func}, GCompareFunc @var{key_compare_func})
+@end deftypefun
+
+@deftypefun void g_cache_destroy (GCache *@var{cache})
+@end deftypefun
+
+@deftypefun gpointer g_cache_insert (GCache *@var{cache}, gpointer @var{key})
+@end deftypefun
+
+@deftypefun void g_cache_remove (GCache *@var{cache}, gpointer @var{key})
+@end deftypefun
+
+@deftypefun void g_cache_key_foreach (GCache *@var{cache}, GHFunc @var{func}, gpointer @var{user_data})
+@end deftypefun
+
+@deftypefun void g_cache_value_foreach (GCache *@var{cache}, GHFunc @var{func}, gpointer @var{user_data})
+@end deftypefun
+
+@node Trees, Memory, Caches, Top
+@comment node-name, next, previous, up
+@chapter Tree handling
+
+@subsection Functions
+
+@deftypefun GTree* g_tree_new (GCompareFunc @var{key_compare_func})
+@end deftypefun
+
+@deftypefun void g_tree_destroy (GTree *@var{tree})
+@end deftypefun
+
+@deftypefun void g_tree_remove (GTree *@var{tree}, gpointer @var{key}, gpointer @var{value})
+@end deftypefun
+
+@deftypefun gpointer g_tree_lookup (GTree *@var{tree}, gpointer @var{key})
+@end deftypefun
+
+@deftypefun void g_tree_traverse (GTree *@var{tree}, GTraverseFunc @var{traverse_func}, GTraverseType @var{traverse_type}, gpointer @var{data}
+@end deftypefun
+
+@deftypefun gpointer g_tree_search (GTree *@var{tree}, GSearchFunc @var{search_func}, gpointer @var{data})
+@end deftypefun
+
+@deftypefun gint g_tree_height (GTree *@var{tree})
+@end deftypefun
+
+@deftypefun gint g_tree_nnodes (GTree *@var{tree})
+@end deftypefun
+
+@node Memory, Timers, Trees, Top
+@comment node-name, next, previous, up
+@chapter Memory handling
+
+@subsection Functions
+
+@deftypefun gpointer g_malloc (gulong @var{size})
+@end deftypefun
+
+@deftypefun gpointer g_malloc0 (gulong @var{size})
+@end deftypefun
+
+@deftypefun gpointer g_realloc (gpointer @var{mem}, gulong @var{size})
+@end deftypefun
+
+@deftypefun void g_mem_profile (void)
+@end deftypefun
+
+@deftypefun void g_mem_check (gpointer @var{mem})
+@end deftypefun
+
+@deftypefun GMemChunk* g_mem_chunk_new (gchar *@var{name}, gint @var{atom_size}, gulong @var{area_size}, gint @var{type})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_destroy (GMemChunk *@var{mem_chunk})
+@end deftypefun
+
+@deftypefun gpointer g_mem_chunk_alloc (GMemChunk *@var{mem_chunk})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_free (GMemChunk *@var{mem_chunk}, gpointer @var{mem})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_clean (GMemChunk *@var{mem_chunk})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_reset (GMemChunk *@var{mem_chunk})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_print (GMemChunk *@var{mem_chunk})
+@end deftypefun
+
+@deftypefun void g_mem_chunk_info (void)
+@end deftypefun
+
+@deftypefun void g_blow_chunks (void)
+Not what you might be thinking, @code{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).
+@end deftypefun
+
+@node Timers, Output, Memory, Top
+@comment node-name, next, previous, up
+@chapter Timer functions
+
+@subsection Functions
+
+@deftypefun GTimer* g_timer_new (void)
+@end deftypefun
+
+@deftypefun void g_timer_destroy (GTimer *@var{timer})
+@end deftypefun
+
+@deftypefun void g_timer_start (GTimer *@var{timer})
+@end deftypefun
+
+@deftypefun void g_timer_stop (GTimer *@var{timer})
+@end deftypefun
+
+@deftypefun void g_timer_reset (GTimer *@var{timer})
+@end deftypefun
+
+@deftypefun gdouble g_timer_elapsed (GTimer *@var{timer}, gulong *@var{microseconds})
+@end deftypefun
+
+@node Output, Utilities, Timers, Top
+@comment node-name, next, previous, up
+@chapter Output functions
+
+@subsection Functions
+
+@deftypefun void g_error (gchar *@var{format}, @dots{})
+@end deftypefun
+
+@deftypefun void g_warning (gchar *@var{format}, @dots{})
+@end deftypefun
+
+@deftypefun void g_message (gchar *@var{format}, @dots{})
+@end deftypefun
+
+@deftypefun void g_print (gchar *@var{format}, @dots{})
+@end deftypefun
+
+@node Utilities, Errors, Output, Top
+@comment node-name, next, previous, up
+@chapter Utility functions
+
+@node Errors, String Chunks, Utilities, Top
+@comment node-name, next, previous, up
+@chapter Error handling
+
+@node String Chunks, Strings, Errors, Top
+@comment node-name, next, previous, up
+@chapter String chunks
+
+@node Strings, Resizable arrays, String Chunks, Top
+@comment node-name, next, previous, up
+@chapter String handling
+
+@node Resizable arrays, GScanner, Strings, Top
+@comment node-name, next, previous, up
+@chapter Resizable arrays
+
+@node GScanner, Miscellany, Resizable arrays, Top
+@comment node-name, next, previous, up
+@chapter Flexible lexical scanner
+
+@node Miscellany, Function Index, GScanner, Top
+@comment node-name, next, previous, up
+@chapter Other stuff
+
+@node Function Index, Concept Index, Miscellany, Top
+@comment node-name, next, previous, up
+@unnumbered Function Index
+
+@printindex fn
+
+@node Concept Index, , Function Index, Top
+@comment node-name, next, previous, up
+@unnumbered Concept Index
+
+@printindex cp
+
+@summarycontents
+@contents 
+@bye
+
diff --git a/glib/Makefile.am b/glib/Makefile.am
index 25b3fa8b1..829a7c793 100644
--- a/glib/Makefile.am
+++ b/glib/Makefile.am
@@ -1,6 +1,6 @@
 ## Process this file with automake to produce Makefile.in
 
-SUBDIRS = gmodule
+SUBDIRS = gmodule docs
 
 configincludedir = $(pkglibdir)/include
 
@@ -10,9 +10,10 @@ glib-config: glib-config.in
 
 DEFS += -DG_LOG_DOMAIN=g_log_domain_glib
 
-EXTRA_DIST =	\
-		glib.m4 \
-		glib.spec
+EXTRA_DIST =			\
+		glib.m4		\
+		glib.spec	\
+		sanity_check
 
 # build . first, then SUBDIRS
 all-recursive-am: all-am
@@ -57,7 +58,7 @@ testglib_LDADD = libglib.la
 m4datadir = $(datadir)/aclocal
 m4data_DATA = glib.m4
 
-.PHONY: files release
+.PHONY: files release sanity snapshot
 
 files:
 	@files=`ls $(DISTFILES) 2> /dev/null `; for p in $$files; do \
@@ -65,4 +66,12 @@ files:
 	done
 
 release:
+	rm -rf .deps */.deps
+	cd docs && make glib.html
+	$(MAKE) distcheck
+
+sanity:
+	./sanity_check $(VERSION)
+
+snapshot:
 	$(MAKE) dist distdir=$(PACKAGE)`date +"%y%m%d"`
diff --git a/sanity_check b/sanity_check
new file mode 100755
index 000000000..87673c93a
--- /dev/null
+++ b/sanity_check
@@ -0,0 +1,41 @@
+#!/bin/sh
+
+VERSION=$1
+
+if [ ! -f glib-$VERSION.tar.gz ]; then
+	echo "ERROR: glib-$VERSION.tar.gz does not exist..."
+	exit 1
+fi
+
+echo ""
+
+echo "Checking glib-$VERSION.tar.gz..."
+tar xfz glib-$VERSION.tar.gz
+
+
+for file in README NEWS glib.spec docs/glib-config.1
+do
+	echo -n "$file... "
+	if [ "x`grep $VERSION glib-$VERSION/$file | wc -l | awk -F' ' '{print $1}'`" == "x1" ]; then
+		echo "ok"
+	else
+		echo "failed."
+		exit 1
+	fi
+done
+
+echo -n "INSTALL..."
+if [ "x`grep $VERSION glib-$VERSION/INSTALL | wc -l | awk -F' ' '{print $1}'`" == "x2" ]; then 
+	echo "ok" 
+else
+	echo "failed."
+	exit 1
+fi
+
+echo ""
+echo "Number of lines in created documentation files:"
+
+wc -l glib-$VERSION/docs/*.html | grep -v total
+wc -l glib-$VERSION/docs/*.info | grep -v total
+
+rm -rf glib-$VERSION