Add tip about building plpython 2 and 3. Fix link to Python docs.

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 1e314242fafdac42e0bba519e5888b5f2d474a90..20b070e42ad5cae16f59d93447d4755c9595ab0f 100644 (file)
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.348.2.3 2010/08/17 04:37:16 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.348.2.4 2010/09/08 20:35:53 petere Exp $ -->
 
 <chapter id="installation">
  <title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -1515,7 +1515,14 @@ su - postgres
        <listitem>
         <para>
          Full path to the Python interpreter.  This will be used to
-         determine the dependencies for building PL/Python.
+         determine the dependencies for building PL/Python.  Also,
+         whether Python 2 or 3 is specified here (or otherwise
+         implicitly chosen) determines which variant of the PL/Python
+         language becomes available.  See
+         <![%standalone-include[the <application>PL/Python</>
+         documentation]]>
+         <![%standalone-ignore[<xref linkend="plpython-python23">]]>
+         for more information.
         </para>
        </listitem>
       </varlistentry>

diff --git a/doc/src/sgml/plpython.sgml b/doc/src/sgml/plpython.sgml
index 6a26abbce73768d4ab8f1b109bc32408ea16ccc8..aa7804d9bb381980f6541888666e47a1d8d52880 100644 (file)
--- a/doc/src/sgml/plpython.sgml
+++ b/doc/src/sgml/plpython.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/plpython.sgml,v 1.51.2.1 2010/08/05 18:36:31 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/plpython.sgml,v 1.51.2.2 2010/09/08 20:35:53 petere Exp $ -->
 
 <chapter id="plpython">
  <title>PL/Python - Python Procedural Language</title>
@@ -93,6 +93,17 @@
    whether PL/Python for Python 2 or Python 3 or both are available.
   </para>
 
+  <tip>
+   <para>
+    The built variant depends on which Python version was found during
+    the installation or which version was explicitly set using
+    the <envar>PYTHON</envar> environment variable;
+    see <xref linkend="install-procedure">.  To make both variants of
+    PL/Python available in one installation, the source tree has to be
+    configured and built twice.
+   </para>
+  </tip>
+
   <para>
    This results in the following usage and migration strategy:
 
@@ -148,7 +159,7 @@
 
   <para>
    See also the
-   document <ulink url="http://docs.python.org/dev/3.0/whatsnew/3.0.html">What's
+   document <ulink url="http://docs.python.org/py3k/whatsnew/3.0.html">What's
    New In Python 3.0</ulink> for more information about porting to
    Python 3.
   </para>