source: chapter07/python.xml@ febac51

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-tools-Python" role="wrap">
  <?dbhtml filename="Python.html"?>

  <sect1info condition="script">
    <productname>Python</productname>
    <productnumber>&python-version;</productnumber>
    <address>&python-url;</address>
  </sect1info>

  <title>Python-&python-version;</title>

  <indexterm zone="ch-tools-Python">
    <primary sortas="a-Python">Python</primary>
    <secondary>temporary</secondary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../chapter08/python.xml"
    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>

    <segmentedlist>
    <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&python-tmp-sbu;</seg>
        <seg>&python-tmp-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Python</title>

    <note>
      <para>There are two package files whose name starts with
      <quote>python</quote>. The one to extract from is
      <filename>Python-&python-version;.tar.xz</filename> (notice the
      uppercase first letter).</para>
    </note>

    <para>Prepare Python for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/usr   \
            --enable-shared \
            --without-ensurepip</userinput></screen>

    <variablelist>
      <title>The meaning of the configure option:</title>

      <varlistentry>
        <term><parameter>--enable-shared</parameter></term>
        <listitem>
          <para>This switch prevents installation of static libraries.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-ensurepip</parameter></term>
        <listitem>
          <para>This switch disables the Python package installer, which is not
          needed at this stage.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <note>
      <para>
        Some Python 3 modules can't be built now because the dependencies
        are not installed yet. The building system still attempts to build
        them however, so the compilation of some files will fail and the
        compiler message may seem to indicate <quote>fatal error</quote>.
        The message should be ignored.  Just make sure the toplevel
        <command>make</command> command has not failed.  The optional
        modules are not needed now and they will be built in
        <xref linkend="chapter-building-system"/>.
      </para>
    </note>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title/>

    <para>Details on this package are located in <xref linkend="contents-python" role="."/></para>

  </sect2>

</sect1>