I have applied the attached patch, and updated descriptions for the
items you were uncertain of. I didn't add defaults for some of
the more unusual entries, but just left them blank.
---------------------------------------------------------------------------
David Wheeler wrote:
> On Apr 3, 2006, at 14:37, Tom Lane wrote:
>
> > I would suggest handling this strictly as an addition to our
> > installation.sgml docs.
>
> Finally got 'round to this. Patch attached. There are quite a few
> environment variables in the list that Peter sent to me that I know
> nothing about. These I've listed, but the documentation for them is
> full of "??"s. You can either fill them in, leave them out, or tell
> me where to learn what they mean and I'll resubmit the patch.
>
> And by the way, Tom, I really appreciate the time you take to answer
> my questions and point me to where I can create a patch to help the
> project. It's people like you who create really successful open-
> source projects, just by being so responsive and helpful. Now that's
> leadership!
>
> Best,
>
> David
>
[ Attachment, skipping... ]
>
> ---------------------------(end of broadcast)---------------------------
> TIP 6: explain analyze is your friend
--
Bruce Momjian http://candle.pha.pa.us
EnterpriseDB http://www.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
Index: installation.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v
retrieving revision 1.253
retrieving revision 1.256
diff -c -c -r1.253 -r1.256
*** installation.sgml 18 Apr 2006 22:52:07 -0000 1.253
--- installation.sgml 25 Apr 2006 15:19:16 -0000 1.256
***************
*** 1,4 ****
! <!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.253 2006/04/18 22:52:07 momjian Exp $ -->
<chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]>
--- 1,4 ----
! <!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.256 2006/04/25 15:19:16 momjian Exp $ -->
<chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]>
***************
*** 1011,1016 ****
--- 1011,1264 ----
<userinput>./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'</>
</screen>
</para>
+
+ <para>
+ Here's a list of the significant environment variables:
+ </para>
+
+ <para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>AWK=<replaceable>/path/to/awk</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/awk</> is the full path to <application>awk</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>CC=<replaceable>/path/to/cc</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/cc</> is the full path to your C compiler, such
+ as <application>gcc</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>CFLAGS=<replaceable>FLAGS</></option></term>
+ <listitem>
+ <para>
+ <replaceable>FLAGS</> is the a list of flags to pass to the C
+ compiler.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>COLLATEINDEX</option></term>
+ <listitem>
+ <para>
+ Used for building the SGML documentation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>CPP=<replaceable>/path/to/cpp</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/cpp</> is the full path to your C preprocessor,
+ such as <application>gcc</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>CPPFLAGS=<replaceable>FLAGS</></option></term>
+ <listitem>
+ <para>
+ <replaceable>FLAGS</> is the a list of flags to pass to the C
+ preprocessor.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>DOCBOOKSTYLE</option></term>
+ <listitem>
+ <para>
+ Used for building the SGML documentation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>JADE</option></term>
+ <listitem>
+ <para>
+ Used for building the SGML documentation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>LDFLAGS=<replaceable>FLAGS</></option></term>
+ <listitem>
+ <para>
+ <replaceable>FLAGS</> is the a list of flags to pass to the link file
+ editor.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>LDFLAGS_SL</option></term>
+ <listitem>
+ <para>
+ Used for shared library linking.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>LORDER=<replaceable>/path/to/lorder</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/lorder</> is the full path to your dependency
+ listing program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>MSGFMT</option></term>
+ <listitem>
+ <para>
+ Used for Native Language Support (NLS).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>MSGMERGE</option></term>
+ <listitem>
+ <para>
+ Used for Native Language Support (NLS).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>NSGMLS</option></term>
+ <listitem>
+ <para>
+ Used for building the SGML documentation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>PERL=<replaceable>/path/to/perl</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/perl</> is the full path to your Perl 5
+ interpreter. Note that this wil be used to determine the dependencies
+ for building PL/Perl.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>PTHREAD_CC</option></term>
+ <listitem>
+ <para>
+ Used for adding thread-safety flags.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>PYTHON=<replaceable>/path/to/python</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/python</> is the full path to your Python
+ interpreter. Note that this wil be used to determine the dependencies
+ for building PL/Python.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>RANLIB=<replaceable>/path/to/ranlib</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/ranlib</> is the full path to your archive
+ library table of contents editor.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>SGMLSPL</option></term>
+ <listitem>
+ <para>
+ Used for building the SGML documentation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>STRIP=<replaceable>/path/to/strip</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/strip</> is the full path to your strip program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>TCL=<replaceable>/path/to/tcl</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/tcl</> is the full path to your TCL
+ interpreter. Note that this wil be used to determine the dependencies
+ for building PL/TCL.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>TAR=<replaceable>/path/to/tar</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/tar</> is the full path to your tar program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>TCLISH=<replaceable>/path/to/tclish</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/tclish</> is the full path to your tclish program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>XGETTEXT=<replaceable>/path/to/xgettext</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/xgettext</> is the full path to your xgettext program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>YACC=<replaceable>/path/to/yacc</></option></term>
+ <listitem>
+ <para>
+ <replaceable>/path/to/yacc</> is the full path to your yacc program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
</step>
<step>