Explain --enable-include-printf.

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

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 98694a68e44a752ffae5bcd499d962b8cb7d022b..f8cbc25c0eec549ac6889c0afcb7d4a011873a59 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 212d4b4e8410bbbe0c7583b63f92100587e8e7a1..0addb1eef4e0939110d46c23d94a3f80bba53477 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>
@@ -194,6 +198,26 @@ How to compile GLib itself
         </para>
       </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>