source: general/prog/python-modules.xml@ d3e019dc

<?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;

  <!ENTITY notify-python-download-http
  "http://www.galago-project.org/files/releases/source/notify-python/notify-python-&notify-python-version;.tar.bz2">
  <!ENTITY notify-python-download-ftp  " ">
  <!ENTITY notify-python-md5sum        "d247cf79b46cef7495deb0a76334f81d">
  <!ENTITY notify-python-size          "212 KB">
  <!ENTITY notify-python-buildsize     "2.3 MB">
  <!ENTITY notify-python-time          "less than 0.1 SBU">

  <!ENTITY pyxml-download-http
  "&sourceforge-repo;/pyxml/PyXML-&pyxml-version;.tar.gz">
  <!ENTITY pyxml-download-ftp  "&gentoo-ftp-repo;/PyXML-&pyxml-version;.tar.gz">
  <!ENTITY pyxml-md5sum        "1f7655050cebbb664db976405fdba209">
  <!ENTITY pyxml-size          "734 KB">
  <!ENTITY pyxml-buildsize     "14.6 MB">
  <!ENTITY pyxml-time          "less than 0.1 SBU">

  <!--
  <!ENTITY pycairo-download-http
  "http://cairographics.org/releases/pycairo-&pycairo-version;.tar.gz">
  <!ENTITY pycairo-download-ftp  " ">
  <!ENTITY pycairo-md5sum        "054da6c125cb427a003f5fd6c54f853e">
  <!ENTITY pycairo-size          "465 KB">
  <!ENTITY pycairo-buildsize     "3 MB">
  <!ENTITY pycairo-time          "0.1 SBU">
  -->

  <!ENTITY py2cairo-download-http
  "http://cairographics.org/releases/py2cairo-&py2cairo-version;.tar.bz2">
  <!ENTITY py2cairo-download-ftp  " ">
  <!ENTITY py2cairo-md5sum        "20337132c4ab06c1146ad384d55372c5">
  <!ENTITY py2cairo-size          "400 KB">
  <!ENTITY py2cairo-buildsize     "3.6 MB">
  <!ENTITY py2cairo-time          "less than 0.1 SBU">

  <!ENTITY pygobject2-download-http
  "&gnome-download-http;/pygobject/2.28/pygobject-&pygobject2-version;.tar.xz">
  <!ENTITY pygobject2-download-ftp
  "&gnome-download-ftp;/pygobject/2.28/pygobject-&pygobject2-version;.tar.xz">
  <!ENTITY pygobject2-md5sum        "9415cb7f2b3a847f2310ccea258b101e">
  <!ENTITY pygobject2-size          "730 KB">
  <!ENTITY pygobject2-buildsize     "25 MB">
  <!ENTITY pygobject2-time          "0.2 SBU">

  <!ENTITY pygobject3-download-http
  "&gnome-download-http;/pygobject/3.2/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-download-ftp
  "&gnome-download-ftp;/pygobject/3.2/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-md5sum        "f895f1ec37f60c2ba528c2d760bcb69e">
  <!ENTITY pygobject3-size          "540 KB">
  <!ENTITY pygobject3-buildsize     "13 MB">
  <!ENTITY pygobject3-time          "0.2 SBU">

  <!ENTITY pygtk-download-http
  "&gnome-download-http;/pygtk/2.24/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-download-ftp
  "&gnome-download-ftp;/pygtk/2.24/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-md5sum        "a1051d5794fd7696d3c1af6422d17a49">
  <!ENTITY pygtk-size          "2.2 MB">
  <!ENTITY pygtk-buildsize     "83 MB">
  <!ENTITY pygtk-time          "0.7 SBU">

  <!ENTITY pygtksourceview-download-http
  "&gnome-download-http;/pygtksourceview/2.10/pygtksourceview-&pygtksourceview-version;.tar.bz2">
  <!ENTITY pygtksourceview-download-ftp
  "&gnome-download-ftp;/pygtksourceview/2.10/pygtksourceview-&pygtksourceview-version;.tar.bz2">
  <!ENTITY pygtksourceview-md5sum        "2654354d61422fb79d8375fc3a3b5393">
  <!ENTITY pygtksourceview-size          "283 KB">
  <!ENTITY pygtksourceview-buildsize     "5 MB">
  <!ENTITY pygtksourceview-time          "0.4 SBU">

  <!ENTITY pyatspi2-download-http
  "&gnome-download-http;/pyatspi/2.4/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-download-ftp
  "&gnome-download-ftp;/pyatspi/2.4/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-md5sum        "08248c386418ddcec0117b74e6866f94">
  <!ENTITY pyatspi2-size          "268 KB">
  <!ENTITY pyatspi2-buildsize     "3.7 MB">
  <!ENTITY pyatspi2-time          "less than 0.1 SBU">

  <!ENTITY pyrex-download-http
  "http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/Pyrex-&pyrex-version;.tar.gz">
  <!ENTITY pyrex-download-ftp  " ">
  <!ENTITY pyrex-md5sum        "515dee67d15d4393841e2d60e8341947">
  <!ENTITY pyrex-size          "252 KB">
  <!ENTITY pyrex-buildsize     "4.0 MB">
  <!ENTITY pyrex-time          "less than 0.1 SBU">

  <!ENTITY pyxdg-download-http "http://people.freedesktop.org/~takluyver/pyxdg-&pyxdg-version;.tar.gz">
  <!ENTITY pyxdg-download-ftp  " ">
  <!ENTITY pyxdg-md5sum        "d31ceab3d68f235be4e4421a9bf110bd">
  <!ENTITY pyxdg-size          "44 KB">
  <!ENTITY pyxdg-buildsize     "750 KB">
  <!ENTITY pyxdg-time          "less than 0.1 SBU">

<!--  <!ENTITY ipython-download-http
  "http://archive.ipython.org/release/&ipython-version;/ipython-&ipython-version;.tar.gz">
  <!ENTITY ipython-download-ftp  "">
  <!ENTITY ipython-md5sum        "4cf9f23b1171b3517f9a7a2bfc875b5f">
  <!ENTITY ipython-size          "8.9 MB">
  <!ENTITY ipython-buildsize     "58 MB">
  <!ENTITY ipython-time          "less than 0.1 SBU"> -->
]>

<sect1 id="python-modules" xreflabel="Python modules">
  <?dbhtml filename="python-modules.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Python Modules</title>

  <indexterm zone="python-modules">
    <primary sortas="a-Python-modules">Python modules</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Python Modules</title>

    <para>
      The <application>Python</application> module packages add useful objects
      to the <application>Python</application> language. Modules utilized by
      packages throughout BLFS are listed here, along with their dependencies.
      Installation of the modules shown on this page is meant to follow from top
      to bottom to handle optional dependencies in each module.
    </para>

    <itemizedlist spacing="compact">
      <listitem>
        <para>
          <xref linkend="notify-python"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyxml"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="py2cairo"/>
        </para>
      </listitem>
      <!-- <listitem>
        <para>
          <xref linkend="pycairo"/>
        </para>
      </listitem> -->
      <listitem>
        <para>
          <xref linkend="pygobject2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygobject3"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygtk"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygtksourceview"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyatspi2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyrex"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyxdg"/>
        </para>
      </listitem>
      <!-- <listitem>
        <para>
          <xref linkend="ipython"/>
        </para>
      </listitem> -->
    </itemizedlist>
  </sect2>

  <!-- Begin Notify Python -->
  <sect2 id="notify-python" xreflabel="Notify Python-&notify-python-version;">

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

    <indexterm zone="notify-python">
      <primary sortas="a-notify-python">notify-python</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Notify Python Module</title>

      <para>
        Notify Python provides <application>Python 2</application>
        bindings to the <application>libnotify</application>.
      </para>

      &lfs71_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&notify-python-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&notify-python-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &notify-python-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &notify-python-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &notify-python-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &notify-python-time;
          </para>
        </listitem>
      </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/notify-python-&notify-python-version;-libnotify-0.7-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

      <bridgehead renderas="sect4">Notify Python Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="libnotify"/> and
        <xref linkend="pygtk"/> (with <xref linkend="gtk2"/> support).
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/notify-python"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Notify Python</title>

      <para>
        Install <application>Notify Python</application> by running the following
        commands:
      </para>

<screen><userinput>patch -Np1 -i ../notify-python-&notify-python-version;-libnotify-0.7-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a testsuite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0/pynotify
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End Notify Python -->

  <!-- Begin PyXML -->
  <sect2 id="pyxml" xreflabel="PyXML-&pyxml-version;">

    <title>PyXML-&pyxml-version;</title>

    <indexterm zone="pyxml">
      <primary sortas="a-PyXML">PyXML</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyXML Module</title>

      <para>
        The <application>PyXML</application> package contains a validating XML
        parser, an implementation of the SAX and DOM programming interfaces, an
        interface to the Expat parser, and a C helper module that can speed up
        <filename>xmllib.py</filename> by a factor of five. This is useful for
        validating, parsing and manipulating XML files using Python programs.
      </para>

      &lfs71_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pyxml-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyxml-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyxml-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyxml-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyxml-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyxml-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyXML Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyxml"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyXML</title>

      <para>
        Install <application>PyXML</application> by running the following
        commands:
      </para>

<screen><userinput>python setup.py build</userinput></screen>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>python setup.py install &amp;&amp;
install -v -m644 doc/man/xmlproc_*.1 /usr/share/man/man1 &amp;&amp;
install -v -m755 -d /usr/share/doc/PyXML-&pyxml-version; &amp;&amp;
cp -v -R doc demo test /usr/share/doc/PyXML-&pyxml-version; &amp;&amp;
install -v -m644 README* /usr/share/doc/PyXML-&pyxml-version;</userinput></screen>

      <para>
        To run the regression tests, the package must first be installed. Then,
        as an unprivileged user, issue the following commands:
      </para>

<screen><userinput>cd test &amp;&amp;
python regrtest.py &amp;&amp;
cd ..</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>python setup.py build</command>: This command copies the
        <filename>*.py</filename> files to a staging area and compiles the C
        extensions.
      </para>

      <para>
        <command>python setup.py install</command>: This command installs the
        package.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>xmlproc_parse and xmlproc_val</seg>
          <seg>PyXML Python library modules</seg>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/_xmlplus and
            /usr/share/doc/PyXML-&pyxml-version;
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="xmlproc_parse">
          <term><command>xmlproc_parse</command></term>
          <listitem>
            <para>
              is a simple XML file parser using the xmlproc parser.
            </para>
            <indexterm zone="pyxml xmlproc_parse">
              <primary sortas="b-xmlproc_parse">xmlproc_parse</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="xmlproc_val">
          <term><command>xmlproc_val</command></term>
          <listitem>
            <para>
              is a validating XML file parser using the xmlproc parser.
            </para>
            <indexterm zone="pyxml xmlproc_val">
              <primary sortas="b-xmlproc_val">xmlproc_val</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect3>
  </sect2>

  <!-- End PyXML -->

  <!-- Begin Py2cairo -->
  <sect2 id="py2cairo" xreflabel="Py2cairo-&py2cairo-version;">

    <title>Py2cairo-&py2cairo-version;</title>

    <indexterm zone="py2cairo">
      <primary sortas="a-Py2cairo">Py2cairo</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Py2cairo Module</title>

      <para>
        Py2cairo provides <application>Python 2</application> bindings to
        <application>Cairo</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&py2cairo-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&py2cairo-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &py2cairo-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &py2cairo-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &py2cairo-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &py2cairo-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Py2cairo Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/> and
        <xref linkend="cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="http://pytest.org">pytest</ulink>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/py2cairo"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Py2cairo</title>

      <para>
        Install <application>Py2cairo</application> by running the following
        commands:
      </para>

<screen><userinput>./waf configure --prefix=/usr &amp;&amp;
./waf build</userinput></screen>

      <para>
        The test suite requires the optional <application>pytest</application>
        package.  If installed, it is run by changing to the 
        <filename class='directory'>test</filename> directory and running 
        <userinput>py.test</userinput>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>./waf install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>_cairo.so</seg>
          <seg>
            /usr/include/pycairo and
            /usr/lib/python&python2-majorver;/site-packages/cairo
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End Py2cairo -->

  <!-- Begin Pycairo
  <sect2 id="pycairo" xreflabel="Pycairo-&pycairo-version;">

    <title>Pycairo-&pycairo-version;</title>

    <indexterm zone="pycairo">
      <primary sortas="a-Pycairo">Pycairo</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Pycairo Module</title>

      <para>
        Pycairo provides <application>Python 3</application> bindings to
        <application>Cairo</application>.
      </para>

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pycairo-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pycairo-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pycairo-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pycairo-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pycairo-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pycairo-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Pycairo Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python3"/> and
        <xref linkend="cairo"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pycairo"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Pycairo</title>

      <para>
        Install <application>Pycairo</application> by running the following
        commands:
      </para>

<screen><userinput>./configure -&45;prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a test suite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>Pycairo Python library module</seg>
          <seg>
            /usr/include/pycairo and
            /usr/lib/python&python3-majorver;/site-packages/cairo
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  End Pycairo -->

  <!-- Begin PyGObject2 -->
  <sect2 id="pygobject2" xreflabel="PyGObject-&pygobject2-version;">

    <title>PyGObject-&pygobject2-version;</title>

    <indexterm zone="pygobject2">
      <primary sortas="a-PyGObject">PyGObject</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGObject Module</title>

      <para>
        PyGObject-&pygobject2-version; provides
        <application>Python 2</application> bindings to the GObject class from
        <application>GLib</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygobject2-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygobject2-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygobject2-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygobject2-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygobject2-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygobject2-time;
          </para>
        </listitem>
      </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch (if you have installed
          <xref linkend="gobject-introspection"/>):
          <ulink url="&patch-root;/pygobject-&pygobject2-version;-introspection-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

      <bridgehead renderas="sect4">PyGObject Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="glib2"/> and
        <xref linkend="py2cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="gobject-introspection"/> and
        <xref linkend="libxslt"/> (to Build Documentation)
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygobject2"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGObject</title>

      <para>
        Install <application>PyGObject</application> by running the following
        commands:
      </para>

<screen><userinput>patch -p1 &lt; ../pygobject-&pygobject2-version;-introspection-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not have a working testsuite.
      </para>
      <!-- <para>
        To test the results, issue: <command>make check</command>.
      </para> -->

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--disable-introspection</parameter>: This switch is required
        if you have not installed
        <application>gobject-introspection</application>.
      </para>

      <para>
        <option>--disable-docs</option>: This option disables the rebuilding of
        the html documentation if <xref linkend="libxslt"/> is installed.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>pygobject-codegen-2.0</seg>
          <seg>
            libpyglib-2.0-python.so,
            _gio.so,
            unix.so,
            _glib.so and
            _gobject.so.
          </seg>
          <seg>
            /usr/include/pygtk-2.0,
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0/{gio,glib,gobject},
            /usr/share/gtk-doc/html/pygobject and
            /usr/share/pygobject/2.0
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End PyGObject2 -->

  <!-- Begin PyGObject3 -->
  <sect2 id="pygobject3" xreflabel="PyGObject-&pygobject3-version;">

    <title>PyGObject-&pygobject3-version;</title>

    <indexterm zone="pygobject3">
      <primary sortas="a-PyGObject">PyGObject</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGObject Module</title>

      <para>
        PyGObject-&pygobject3-version; provides
        <application>Python 2</application> bindings to the GObject class from
        <application>GLib</application>.
      </para>

      &lfs70_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygobject3-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygobject3-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygobject3-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygobject3-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygobject3-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygobject3-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyGObject Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="gobject-introspection"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="libxslt"/> (to Build Documentation)
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygobject3"/>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGObject</title>

      <para>
        Install <application>PyGObject</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        To test the results, issue: <command>make check</command>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>

    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--disable-docs</parameter>: This option disables the
        rebuilding of the html documentation if <xref linkend="libxslt"/> is
        installed.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Program</segtitle>
        <segtitle>Installed Library</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            pygobject-codegen-2.0
          </seg>
          <seg>
            libpyglib-gi-2.0-python.so
           </seg>
          <seg>
            /usr/include/pygobject-3.0
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End PyGObject -->

  <!-- Begin PyGTK -->
  <sect2 id="pygtk" xreflabel="PyGTK-&pygtk-version;">

    <title>PyGTK-&pygtk-version;</title>

    <indexterm zone="pygtk">
      <primary sortas="a-PyGTK">PyGTK</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGTK Module</title>

      <para>
        PyGTK lets you to easily create programs with a graphical user interface
        using the <application>Python</application> programming language.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygtk-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygtk-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygtk-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygtk-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygtk-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygtk-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyGTK Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="pygobject2"/>
      </para>

      <bridgehead renderas="sect5">Required (atk module)</bridgehead>
      <para role="required">
        <xref linkend="atk"/>
      </para>

      <bridgehead renderas="sect5">Required (pango module)</bridgehead>
      <para role="required">
        <xref linkend="pango"/>
      </para>

      <bridgehead renderas="sect5">Required (pangocairo module)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="pango"/>
      </para>

      <bridgehead renderas="sect5">Required (gtk and gtk.unixprint modules)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="gtk2"/>.
      </para>

      <bridgehead renderas="sect5">Required (gtk.libglade module)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="libglade"/>.
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="http://numpy.scipy.org/">NumPy</ulink>
      </para>

      <bridgehead renderas="sect5">Optional (to Build Documentation)</bridgehead>
      <para role="optional">
        <xref linkend="libxslt"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygtk"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGTK</title>

      <para>
        Install <application>PyGTK</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        The tests must be run from an active X display. If this is so, issue:
        <command>make check</command>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--enable-docs</parameter>: This option enables rebuilding the
        html documentation if <xref linkend="libxslt"/> is installed.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>pygtk-codegen-2.0 and pygtk-demo.</seg>
          <seg>
            atk.so,
            _gtk.so,
            glade.so,
            gtkunixprint.so,
            pango.so and
            pangocairo.so.
          </seg>
          <seg>
            /usr/include/pygtk-2.0,
            /usr/lib/pygtk,
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0,
            /usr/share/gtk-doc/html/pygtk and
            /usr/share/pygtk.
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="pygtk-codegen-2.0">
          <term><command>pygtk-codegen-2.0</command></term>
          <listitem>
            <para>
              is a wrapper script to run the <application>PyGTK</application>
              codegen module.
            </para>
            <indexterm zone="pygtk pygtk-codegen-2.0">
              <primary sortas="b-pygtk-codegen-2.0">pygtk-codegen-2.0</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="pygtk-demo">
          <term><command>pygtk-demo</command></term>
          <listitem>
            <para>
              is a Python wrapper to run the <application>PyGTK</application>
              demo program.
            </para>
            <indexterm zone="pygtk pygtk-demo">
              <primary sortas="b-pygtk-demo">pygtk-demo</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect3>
  </sect2>
  <!-- End PyGTK -->

  <!-- Begin PyGtkSourceView -->
  <sect2 id="pygtksourceview" xreflabel="PyGtkSourceView-&pygtksourceview-version;">

    <title>PyGtkSourceView-&pygtksourceview-version;</title>

    <indexterm zone="pygtksourceview">
      <primary sortas="a-PyGtkSourceView">PyGtkSourceView</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGtkSourceView Module</title>

      <para>
        PyGtkSourceView contains python bindings for the version 2 of the
        <application>GtkSourceView</application> library.
      </para>

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygtksourceview-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygtksourceview-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygtksourceview-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygtksourceview-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygtksourceview-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygtksourceview-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyGtkSourceView Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="gtksourceview"/> and
        <xref linkend="pygtk"/>.
      </para>

      <bridgehead renderas="sect5">Recommended</bridgehead>
      <para role="recommended">
        <xref linkend="DocBook"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="gtk-doc"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygtksourceview"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGtkSourceView</title>

      <para>
        Install <application>PyGtkSourceView</application> by running the
        following commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a test suite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <option>--disable-docs</option>: This option disables the documentation
        building and is required if <application>DocBook</application> is not
        installed.
      </para>

      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/gtk-doc-rebuild.xml"/>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>gtksourceview2.so</seg>
          <seg>/usr/share/gtk-doc/html/pygtksourceview2</seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="gtksourceview2">
          <term><filename class='libraryfile'>gtksourceview2.so</filename></term>
          <listitem>
            <para>
              PyGtkSourceView Python library module.
            </para>
            <indexterm zone="pygtksourceview gtksourceview2">
              <primary sortas="c-gtksourceview2">gtksourceview2.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect3>
  </sect2>
  <!-- End PyGtkSourceView -->

  <!-- Begin pyatspi2 -->
  <sect2 id="pyatspi2" xreflabel="pyatspi2-&pyatspi2-version;">

    <title>pyatspi2-&pyatspi2-version;</title>

    <indexterm zone="pyatspi2">
      <primary sortas="a-pyatspi2">pyatspi2</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to pyatspi2</title>

      <para>
        The <application>pyatspi2</application> package contains Python2
        bindings for the core components of GNOME Accessibility.
      </para>

      &lfs70_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pyatspi2-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyatspi2-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyatspi2-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyatspi2-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyatspi2-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyatspi2-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">pyatspi2 Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="pygobject3"/>
      </para>

      <bridgehead renderas="sect5">Recommended</bridgehead>
      <para role="recommended">
        <xref linkend="at-spi2-core"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyatspi2"/>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of pyatspi2</title>

      <para>
        Install <application>pyatspi2</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make check</command>.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/pyatspi
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End pyatspi2 -->

  <!-- Begin Pyrex -->
  <sect2 id="pyrex" xreflabel="Pyrex-&pyrex-version;">

    <title>Pyrex-&pyrex-version;</title>

    <indexterm zone="pyrex">
      <primary sortas="a-Pyrex">pyrex</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Pyrex Module</title>

      <para>
        <application>Pyrex</application> is language used for writing
        <application>Python</application> extension modules.
      </para>

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
          Download (HTTP): <ulink url="&pyrex-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyrex-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyrex-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyrex-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyrex-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyrex-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Pyrex Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyrex"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Pyrex</title>

      <para>
        Install <application>pyrex</application> by running the following
        commands as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>python setup.py install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>python setup.py install</command>: This command installs
        the package. There are other options available, see
        <command>python setup.py --help-commands</command> for details.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            pyrexc
          </seg>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/Pyrex
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End Pyrex -->

  <!-- Begin pyxdg -->
  <sect2 id="pyxdg" xreflabel="PyXDG-&pyxdg-version;">

    <title>PyXDG-&pyxdg-version;</title>

    <indexterm zone="pyxdg">
      <primary sortas="a-PyXDG">pyxdg</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyXDG Module</title>

      <para>
        <application>PyXDG</application> is a <application>Python</application>
        library to access freedesktop.org standards.
      </para>

      &lfs71_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pyxdg-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyxdg-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyxdg-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyxdg-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyxdg-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyxdg-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyXDG Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyxdg"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyXDG</title>

      <para>
        Install <application>PyXDG</application> by running the following
        commands as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>python setup.py install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>python setup.py install</command>: This command installs
        the package. There are other options available, see
        <command>Python setup.py --help-commands</command> for details.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/xdg
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!--End pyxdg -->

  <!-- Begin IPython -->
<!--  <sect2 id="ipython" xreflabel="IPython-&ipython-version;">

    <title>IPython-&ipython-version;</title>

    <indexterm zone="ipython">
      <primary sortas="a-IPython">ipython</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to IPython Module</title>

      <para>
        <application>IPython</application> provides a rich toolkit to help you
        make the most out of using Python interactively.
      </para>

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&ipython-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&ipython-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &ipython-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &ipython-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &ipython-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &ipython-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">IPython Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/>
        ( or <xref linkend="python3"/> : not tested), and
        <xref linkend="sqlite"/>
      </para>

      <bridgehead renderas="sect5">optional</bridgehead>
      <para role="optional">
        <ulink url="http://sphinx.pocoo.org">sphinx</ulink> (for building docs),
        <ulink url="http://pygments.org">pygments</ulink> (for syntax
        higlighting documentation),
        <ulink url="http://pypi.python.org/pypi/nose">nose</ulink> (to build the
        test program),
        <ulink url="http://www.noah.org/python/pexpect">pexpect</ulink> (for
        standalone doctests), and
        <ulink url="http://pypi.python.org/pypi/pyzmq">sphinx</ulink> (for
        qtconsole, notebook, parallel computing)
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/ipython"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of IPython</title>

      <para>
        Install <application>ipython</application> by running the following
        commands as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>python setup.py install - -prefix=/usr</userinput></screen>

      <para>
        If you built this against <application>nose</application>, you can run
        the testsuite after the package has been installed by entering:
        <command>iptest</command>. The tests test_startup_{,i}py (and perhaps
        others if you provided the optional dependencies) will fail.
      </para>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>python setup.py install - -prefix=/usr</command>: This command
        installs the package. The prefix ensures that the programs are located
        in <filename class="directory">/usr/bin</filename> instead of
        <filename class="directory">/usr/local/bin</filename>.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            ipcluster, ipcontroller, ipengine, iplogger, iptest (if nose was
            installed), ipython, irunner, pycolor and a host of python scripts.
          </seg>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/IPython and
            /usr/share/doc/IPython.
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect3">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="ipcluster">
          <term><command>ipcluster</command></term>
          <listitem>
            <para>
              IPython parallel computing cluster control tool
            </para>
            <indexterm zone="ipython ipcluster">
              <primary sortas="b-ipcluster">ipcluster</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="ipcontroller">
          <term><command>ipcontroller</command></term>
          <listitem>
            <para>
              IPython parallel computing controller control tool
            </para>
            <indexterm zone="ipython ipcontroller">
              <primary sortas="b-ipcontroller">ipcontroller</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="ipengine">
          <term><command>ipengine</command></term>
          <listitem>
            <para>
              IPython parallel computing engine control tool
            </para>
            <indexterm zone="ipython ipengine">
              <primary sortas="b-ipengine">ipengine</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="iplogger">
          <term><command>iplogger</command></term>
          <listitem>
            <para>
              IPython logger fpr parallel computing
            </para>
            <indexterm zone="ipython iplogger">
              <primary sortas="b-iplogger">iplogger</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="iptest">
          <term><command>iptest</command></term>
          <listitem>
            <para>
              runs the IPython testsuite
            </para>
            <indexterm zone="ipython iptest">
              <primary sortas="b-iptest">iptest</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="ipython-prog">
          <term><command>ipython</command></term>
          <listitem>
            <para>
              Tools for Interactive Computing in Python
            </para>
            <indexterm zone="ipython ipython">
              <primary sortas="b-ipython">ipython</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="irunner">
          <term><command>irunner</command></term>
          <listitem>
            <para>
              is an interface to IPython&apos;s runner module
            </para>
            <indexterm zone="ipython irunner">
              <primary sortas="b-irunner">irunner</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="pycolor">
          <term><command>pycolor</command></term>
          <listitem>
            <para>
              Colorize a python file or stdin using ANSI and print to stdout
            </para>
            <indexterm zone="ipython pycolor">
              <primary sortas="b-pycolor">pycolor</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect3>
  </sect2> -->
  <!-- End IPython -->
</sect1>