From 940d8a269d4fb29d5f91fe0bd0e665e1e5ee14af Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Sat, 23 Nov 2002 21:37:54 +0000
Subject: [PATCH] Explain --enable-include-printf.

	* glib/building.sgml: Explain --enable-include-printf.
---
 docs/reference/ChangeLog          |  2 ++
 docs/reference/glib/building.sgml | 24 ++++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 98694a68..f8cbc25c 100644
--- 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 212d4b4e..0addb1ee 100644
--- 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>
-- 
2.34.1