source: chapter07/python.xml

<?xml version="1.0" encoding="UTF-8"?>
<!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 the
      <quote>python</quote> prefix. 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. For the <filename>ssl</filename> module,
        a message <computeroutput>Python requires a OpenSSL 1.1.1 or
        newer</computeroutput> is outputted.
        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>