Re: [HACKERS] Suggestion: Which Binary? - Mailing list pgsql-patches

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>