From 14b9008cca69dc6aaa2dec9954d8687437a25fbb Mon Sep 17 00:00:00 2001
From: Yaakov Selkowitz <yselkowi@redhat.com>
Date: Tue, 11 Oct 2011 21:53:57 +0000
Subject: [PATCH] 	* utils.sgml (getconf): Expand documentation.

---
 winsup/utils/ChangeLog  |  4 ++++
 winsup/utils/utils.sgml | 24 ++++++++++++++++++++----
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/winsup/utils/ChangeLog b/winsup/utils/ChangeLog
index ff7017866..9341396df 100644
--- a/winsup/utils/ChangeLog
+++ b/winsup/utils/ChangeLog
@@ -1,3 +1,7 @@
+2011-10-11  Yaakov Selkowitz  <yselkowitz@users.sourceforge.net>
+
+	* utils.sgml (getconf): Expand documentation.
+
 2011-10-10  Corinna Vinschen  <corinna@vinschen.de>
 
 	* ldd.cc (VERSION): Remove.
diff --git a/winsup/utils/utils.sgml b/winsup/utils/utils.sgml
index 0411cb93a..a5752e841 100644
--- a/winsup/utils/utils.sgml
+++ b/winsup/utils/utils.sgml
@@ -484,15 +484,31 @@ Other options:
 
 <para>The <command>getconf</command> utility prints the value of the
 configuration variable specified by <literal>variable_name</literal>.
-If <literal>pathname</literal> is given, <command>getconf</command> prints
-the value of the configuration variable for the specified pathname.</para>
+If no <literal>pathname</literal> is given, <command>getconf</command>
+serves as a wrapper for the <literal>confstr</literal> and
+<literal>sysconf</literal> functions, supporting the symbolic constants
+defined in the <literal>limits.h</literal> and <literal>unistd.h</literal>
+headers, without their respective <literal>_CS_</literal> or
+<literal>_SC_</literal> prefixes.
+</para>
+
+<para>If <literal>pathname</literal> is given, <command>getconf</command>
+prints the value of the configuration variable for the specified pathname.
+In this form, <command>getconf</command> serves as a wrapper for the
+<literal>pathconf</literal> function, supporting the symbolic constants defined
+in the <literal>unistd.h</literal> header, without the <literal>_PC_</literal> 
+prefix. </para>
 
 <para>If you specify the <literal>-v</literal> option, the parameter
 denotes a specification for which the value of the configuration variable
-should be printed.</para>
+should be printed. Note that the only specifications supported by Cygwin
+are <literal>POSIX_V7_ILP32_OFFBIG</literal> and the legacy
+<literal>POSIX_V6_ILP32_OFFBIG</literal> and
+<literal>XBS5_ILP32_OFFBIG</literal> equivalents.</para>
 
 <para>Use the <literal>-a</literal> option to print a list of all available
-configuration variables.</para>
+configuration variables for the system, or given <literal>pathname</literal>,
+and their values.</para>
 
 </sect2>