Commit bca0383f authored by Neil Conway's avatar Neil Conway

Update installation docs for PL/Python to note that distutils is now

required. Original patch from James William Pye, editorializing by
Neil Conway.
parent 9fcbe2af
<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.203 2004/06/20 01:32:46 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.204 2004/09/23 00:30:13 neilc Exp $ -->
<chapter id="installation"> <chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]> <title><![%standalone-include[<productname>PostgreSQL</>]]>
...@@ -144,9 +144,9 @@ su - postgres ...@@ -144,9 +144,9 @@ su - postgres
<indexterm><primary>libperl</primary></indexterm> <indexterm><primary>libperl</primary></indexterm>
<filename>libperl</filename> library must be a shared library <filename>libperl</filename> library must be a shared library
also on most platforms. This appears to be the default in also on most platforms. This appears to be the default in
recent Perl versions, but it was not in earlier versions, and in recent <productname>Perl</productname> versions, but it was not
general it is the choice of whomever installed Perl at your in earlier versions, and in general it is the choice of whomever
site. installed Perl at your site.
</para> </para>
<para> <para>
...@@ -170,16 +170,20 @@ su - postgres ...@@ -170,16 +170,20 @@ su - postgres
<listitem> <listitem>
<para> <para>
To build the PL/Python server programming language, you need a To build the PL/Python server programming language, you need a
Python installation, including the header files. Since <productname>Python</productname> installation with the header
PL/Python will be a shared library, the files and the distutils module. The distutils module is
<indexterm><primary>libpython</primary></indexterm> included by default with <productname>Python</productname> 1.6
<filename>libpython</filename> library must be a shared library and later; users of earlier versions of
also on most platforms. This is not the case in a default <productname>Python</productname> will need to install it.
Python installation.
</para> </para>
<para> <para>
If after building and installing you have a file called Since PL/Python will be a shared library, the
<indexterm><primary>libpython</primary></indexterm>
<filename>libpython</filename> library must be a shared library
also on most platforms. This is not the case in a default
<productname>Python</productname> installation. If after
building and installing you have a file called
<filename>plpython.so</filename> (possibly a different <filename>plpython.so</filename> (possibly a different
extension), then everything went well. Otherwise you should extension), then everything went well. Otherwise you should
have seen a notice like this flying by: have seen a notice like this flying by:
...@@ -188,17 +192,18 @@ su - postgres ...@@ -188,17 +192,18 @@ su - postgres
*** You might have to rebuild your Python installation. Refer to *** You might have to rebuild your Python installation. Refer to
*** the documentation for details. *** the documentation for details.
</screen> </screen>
That means you have to rebuild (part of) your Python That means you have to rebuild (part of) your
installation to supply this shared library. <productname>Python</productname> installation to supply this
shared library.
</para> </para>
<para> <para>
If you have problems, run Python 2.3 or later's configure using the If you have problems, run <productname>Python</> 2.3 or later's
<literal>--enable-shared</> flag. On some operating systems you configure using the <literal>--enable-shared</> flag. On some
don't have to build a shared library, but you will have operating systems you don't have to build a shared library, but
to convince the <productname>PostgreSQL</> build system of this. you will have to convince the <productname>PostgreSQL</> build
Consult the <filename>Makefile</filename> in the system of this. Consult the <filename>Makefile</filename> in
<filename>src/pl/plpython</filename> directory for details. the <filename>src/pl/plpython</filename> directory for details.
</para> </para>
</listitem> </listitem>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment