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
Index: doc/src/sgml/installation.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/installation.sgml,v
retrieving revision 1.253
diff -u -r1.253 installation.sgml
--- doc/src/sgml/installation.sgml 18 Apr 2006 22:52:07 -0000 1.253
+++ doc/src/sgml/installation.sgml 20 Apr 2006 18:13:58 -0000
@@ -1011,6 +1011,253 @@
<userinput>./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'</>
</screen>
</para>
+ <para>
+ Here's a list of some of the more influential 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=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>JADE=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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>MSFFMT=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>MSGMERGE=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>NSGMLS=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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=<replaceable>??</></option></term>
+ <listitem>
+ <para>
+ <replaceable>??</> is ??.
+ </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>
---------------------------(end of broadcast)---------------------------
TIP 6: explain analyze is your friend
