source: general/prog/python-modules.xml@ 66b546a

<?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 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.0/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-download-ftp
  "&gnome-download-ftp;/pygobject/3.0/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-md5sum        "d17e2565e139d647e8ee50fd1126aa9e">
  <!ENTITY pygobject3-size          "540 KB">
  <!ENTITY pygobject3-buildsize     "16 MB">
  <!ENTITY pygobject3-time          "0.2 SBU">

  <!ENTITY pygtk-download-http
  "&gnome-download-http;/pygtk/2.17/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-download-ftp
  "&gnome-download-ftp;/pygtk/2.17/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-md5sum        "43d704343d7ca04a6e4ddd4fa73a3c55">
  <!ENTITY pygtk-size          "2.2 MB">
  <!ENTITY pygtk-buildsize     "65 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.2/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-download-ftp
  "&gnome-download-ftp;/pyatspi/2.2/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-md5sum        "9e3abb0d33bdf66e025cc16588095cba">
  <!ENTITY pyatspi2-size          "260 KB">
  <!ENTITY pyatspi2-buildsize     "3.7 MB">
  <!ENTITY pyatspi2-time          "less than 0.1 SBU">

  <!ENTITY pyxdg-download-http
  "http://www.freedesktop.org/~lanius/pyxdg-&pyxdg-version;.tar.gz">
  <!ENTITY pyxdg-download-ftp  " ">
  <!ENTITY pyxdg-md5sum        "9f33542e846d0fc1e0bfa992a8555b0a">
  <!ENTITY pyxdg-size          "38 KB">
  <!ENTITY pyxdg-buildsize     "728 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="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="pyxdg"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="ipython"/>
        </para>
      </listitem>
    </itemizedlist>
  </sect2>

  <!-- 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>

      &lfs71_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;/pycairo"/>
      </para>
    </sect3>

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

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

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</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>make 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/python2.7/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="python2"/> 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 --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&python2-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>

      &lfs71_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;/pygobject2-&pygobject2-version;-introspection-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

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

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="pycairo"/> and
        <xref linkend="pkgconfig"/>.
      </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;/pygobject"/>
      </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; ../pygobject2-&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 3</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="python2"/> and
        <xref linkend="pkgconfig"/>
      </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;/pygobject"/>
      </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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>pygobject-codegen-2.0</seg>
          <seg>
            libpyglib-gi-2.0-python.so, 
             _gio.so, 
             _gi_cairo.so and
             _gobject.so.
           </seg>
          <seg>
            /usr/include/pygobject-3.0 and
            /usr/lib/python2.7
          </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>

      &lfs71_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="pycairo"/> and
        <xref linkend="pango"/>
      </para>

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

      <bridgehead renderas="sect5">Required (gtk.libglade module)</bridgehead>
      <para role="required">
        <xref linkend="pycairo"/> 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</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_built;

      <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="pygobject2"/>
      </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=$GNOME_PREFIX \
            --sysconfdir=$GNOME_SYSCONFDIR \
            --libexecdir=$GNOME_PREFIX/lib/pyatspi2 &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 Programs</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            Accessibility.py, appevent.py, constants.py, deviceevent.py,
            document.py, editabletext.py, enum.py, interfaces.py, registry.py,
            role.py, state.py, text.py, and utils.py
          </seg>
          <seg><envar>$GNOME_PREFIX</envar>/lib/python2.7/site-packages/pyatspi</seg>
        </seglistitem>
      </segmentedlist>

  <!--<variablelist> ## none of these are documented anywhere
        <bridgehead renderas="sect3">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="Accessibility.py">
          <term><command>Accessibility.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 Accessibility.py">
              <primary sortas="b-Accessibility.py">Accessibility.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="appevent.py">
          <term><command>appevent.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 appevent.py">
              <primary sortas="b-appevent.py">appevent.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="constants.py">
          <term><command>constants.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 constants.py">
              <primary sortas="b-constants.py">constants.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="deviceevent.py">
          <term><command>deviceevent.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 deviceevent.py">
              <primary sortas="b-deviceevent.py">deviceevent.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="document.py">
          <term><command>document.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 document.py">
              <primary sortas="b-document.py">document.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="editabletext.py">
          <term><command>editabletext.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 editabletext.py">
              <primary sortas="b-editabletext.py">editabletext.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="enum.py">
          <term><command>enum.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 enum.py">
              <primary sortas="b-enum.py">enum.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="interfaces.py">
          <term><command>interfaces.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 interfaces.py">
              <primary sortas="b-interfaces.py">interfaces.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="registry.py">
          <term><command>registry.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 registry.py">
              <primary sortas="b-registry.py">registry.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="role.py">
          <term><command>role.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 role.py">
              <primary sortas="b-role.py">role.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="state.py">
          <term><command>state.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 state.py">
              <primary sortas="b-state.py">state.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="text.py">
          <term><command>text.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 text.py">
              <primary sortas="b-text.py">text.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="utils.py">
          <term><command>utils.py</command></term>
          <listitem>
            <para>
              does this .....
            </para>
            <indexterm zone="pyatspi2 utils.py">
              <primary sortas="b-utils.py">utils.py</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>-->
    </sect3>
  </sect2>
  <!-- End pyatspi2 -->

  <!-- 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>

      <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 Programs</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            BaseDirectory.py, Config.py, Exceptions.py, IconTheme.py,
            IniFile.py, Locale.py, Menu.py and RecentFile.py.
          </seg>
          <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>
            <!-- this is what the manpage says! -->
            <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>
            <!-- again, description from the manpage -->
            <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>