From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Sat, 23 Nov 2002 21:37:54 +0000 (+0000)
Subject: Explain --enable-include-printf.
X-Git-Tag: GLIB_2_1_3~26
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=940d8a269d4fb29d5f91fe0bd0e665e1e5ee14af;p=platform%2Fupstream%2Fglib.git

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
--- 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
--- 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>