From 04f12a26416ce6a43d6d1a6a6815234772ee4256 Mon Sep 17 00:00:00 2001
From: Tim Janik <timj@gtk.org>
Date: Wed, 25 Jan 2006 16:14:09 +0000
Subject: [PATCH] documented G_SLICE=always-malloc and G_DEBUG=gc-friendly.
 added anchors

Wed Jan 25 17:12:47 2006  Tim Janik  <timj@gtk.org>

        * glib/running.sgml: documented G_SLICE=always-malloc and
        G_DEBUG=gc-friendly. added anchors for each env var.
---
 docs/reference/ChangeLog               |  5 ++++
 docs/reference/glib/running.sgml       | 49 +++++++++++++++++++++++++++++-----
 docs/reference/glib/tmpl/messages.sgml | 27 ++++++++++++++-----
 3 files changed, 69 insertions(+), 12 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 61734a1..f1b51d8 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+Wed Jan 25 17:12:47 2006  Tim Janik  <timj@gtk.org>
+
+	* glib/running.sgml: documented G_SLICE=always-malloc and
+	G_DEBUG=gc-friendly. added anchors for each env var.
+
 2006-01-18  Matthias Clasen  <mclasen@redhat.com>
 	
 	* === Released 2.9.4 ===
diff --git a/docs/reference/glib/running.sgml b/docs/reference/glib/running.sgml
index f17d68c..d05cabe 100644
--- a/docs/reference/glib/running.sgml
+++ b/docs/reference/glib/running.sgml
@@ -44,7 +44,7 @@ variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
   </para>
 </formalpara>
 
-<formalpara>
+<formalpara id="G_MESSAGES_PREFIXED">
   <title><envar>G_MESSAGES_PREFIXED</envar></title>
 
   <para>
@@ -54,9 +54,8 @@ variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
   </para>
 </formalpara>
 
-<formalpara>
+<formalpara id="G_DEBUG">
   <title><envar>G_DEBUG</envar></title>
-
   <para>
     If GLib has been configured with <option>--enable-debug=yes</option>,
     this variable can be set to a list of debug options, which cause GLib
@@ -79,11 +78,49 @@ variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
            debugging support.</para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>gc-friendly</term>
+	<listitem>
+		<para>
+		  Newly allocated memory that isn't directly initialized, as well
+		  as memory being freed will be reset to 0. The point here is to
+		  allow memory checkers and similar programs that use bohem GC alike
+		  algorithms to produce more accurate results.
+		  This option is special in that it doesn't require GLib to be
+		  configured with debugging support.
+		</para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </para>
 </formalpara>
 
-<formalpara>
+<formalpara id="G_SLICE">
+	<title><envar>G_SLICE</envar></title>
+	<para>
+	  This environment variable allows reconfiguration of the #GSlice
+	  memory allocator.
+	  <variablelist>
+	    <varlistentry>
+	      <term>always-malloc</term>
+	      <listitem>
+		<para>
+		  This will cause all slices allocated through g_slice_alloc() and
+		  released by g_slice_free1() to be actually allocated via direct
+		  calls to g_malloc() and g_free().
+		  This is most useful for memory checkers and similar programs that
+		  use bohem GC alike algorithms to produce more accurate results.
+		  It can also be in conjunction with debugging features of the system's
+		  malloc implementation such as glibc's MALLOC_CHECK_=2 to debug
+		  erroneous slice allocation code.
+		</para>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</para>
+</formalpara>
+
+<formalpara id="G_RANDOM_VERSION">
   <title><envar>G_RANDOM_VERSION</envar></title>
 
   <para>
@@ -95,7 +132,7 @@ variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
   </para>
 </formalpara> 
 
-<formalpara>
+<formalpara id="LIBCHARSET_ALIAS_DIR">
   <title><envar>LIBCHARSET_ALIAS_DIR</envar></title>
 
   <para>
@@ -106,7 +143,7 @@ variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
   </para>
 </formalpara> 
 
-<formalpara>
+<formalpara id="G_WIN32_PRETEND_WIN9X">
   <title><envar>G_WIN32_PRETEND_WIN9X</envar></title>
 
   <para>
diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml
index c556933..a25c123 100644
--- a/docs/reference/glib/tmpl/messages.sgml
+++ b/docs/reference/glib/tmpl/messages.sgml
@@ -115,9 +115,12 @@ A convenience function/macro to log a normal message.
 </para>
 
 @...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- # Unused Parameters # -->
 @...: 
 @...: 
+@...:
+
+@...:
+
 @...: 
 
 
@@ -127,9 +130,12 @@ A convenience function/macro to log a warning message.
 </para>
 
 @...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- # Unused Parameters # -->
 @...: 
 @...: 
+@...:
+
+@...:
+
 @...: 
 
 
@@ -143,9 +149,12 @@ example.
 </para>
 
 @...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- # Unused Parameters # -->
 @...: 
 @...: 
+@...:
+
+@...:
+
 @...: 
 
 
@@ -160,9 +169,12 @@ assertion failure.
 </para>
 
 @...: the parameters to insert into the format string.
-<!-- # Unused Parameters # -->
 @...: 
 @...: 
+@...:
+
+@...:
+
 @...: 
 
 
@@ -172,11 +184,14 @@ A convenience function/macro to log a debug message.
 </para>
 
 @...: format string, followed by parameters to insert into the format string (as with printf())
-@Since: 2.6
-<!-- # Unused Parameters # -->
+
+@...:
+
 @...: 
+@Since: 2.6
 @...: 
 @...: 
+@...:
 
 
 <!-- ##### FUNCTION g_log_set_handler ##### -->
-- 
2.7.4