Explain --enable-include-printf.

	* glib/building.sgml: Explain --enable-include-printf.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 98694a6..f8cbc25 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,7 @@
 2002-11-23  Matthias Clasen  <maclas@gmx.de>
 
+       * glib/building.sgml: Explain --enable-include-printf.
+
        * glib/Makefile.am (extra_files): 
        * gobject/Makefile.am (extra_files): Add version.xml.in.
 

diff --git a/docs/reference/glib/building.sgml b/docs/reference/glib/building.sgml
index 212d4b4..0addb1e 100644 (file)
--- a/docs/reference/glib/building.sgml
+++ b/docs/reference/glib/building.sgml
@@ -69,6 +69,10 @@ How to compile GLib itself
           <group>
             <arg>--with-threads=[none|posix|dce|solaris|win32]</arg>
           </group>
+         <group>
+            <arg>--disable-included-printf</arg>
+            <arg>--enable-included-printf</arg>
+          </group>
           <group>
             <arg>--disable-gtk-doc</arg>
             <arg>--enable-gtk-doc</arg>
@@ -195,6 +199,26 @@ How to compile GLib itself
       </formalpara>
 
       <formalpara>
+        <title><systemitem>--disable-included-printf</systemitem> and
+          <systemitem>--enable-included-printf</systemitem></title>
+
+        <para>
+          By default the <command>configure</command> script will try
+          to auto-detect whether the C library provides a suitable set
+         of <function>printf()</function> functions. In detail, 
+         <command>configure</command> checks that the semantics of
+          <function>snprintf()</function> are as specified by C99 and
+         that positional parameters as specified in the Single Unix
+         Specification are supported. If this not the case, GLib will
+         include an implementation of the <function>printf()</function> 
+          family.
+          These options can be used to explicitly control whether
+          an implementation fo the <function>printf()</function> family
+          should be included or not.
+        </para>
+      </formalpara>
+
+      <formalpara>
         <title><systemitem>--disable-gtk-doc</systemitem> and
           <systemitem>--enable-gtk-doc</systemitem></title>