source: general/prog/python-modules.xml@ 4949485e

<?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 pygobject-download-http "&gnome-download-http;/pygobject/3.0/pygobject-&pygobject-version;.tar.xz">
  <!ENTITY pygobject-download-ftp  "&gnome-download-ftp;/pygobject/3.0/pygobject-&pygobject-version;.tar.xz">
  <!ENTITY pygobject-md5sum        "d17e2565e139d647e8ee50fd1126aa9e">
  <!ENTITY pygobject-size          "540 KB">
  <!ENTITY pygobject-buildsize     "16 MB">
  <!ENTITY pygobject-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 pyorbit-download-http "&gnome-download-http;/pyorbit/2.24/pyorbit-&pyorbit-version;.tar.bz2">
  <!ENTITY pyorbit-download-ftp  "&gnome-download-ftp;/pyorbit/2.24/pyorbit-&pyorbit-version;.tar.bz2">
  <!ENTITY pyorbit-md5sum        "574593815e75ee6e98062c75d6d1581f">
  <!ENTITY pyorbit-size          "286 KB">
  <!ENTITY pyorbit-buildsize     "4 MB">
  <!ENTITY pyorbit-time          "0.1 SBU">

  <!ENTITY gnome-python-download-http "&gnome-download-http;/gnome-python/2.28/gnome-python-&gnome-python-version;.tar.bz2">
  <!ENTITY gnome-python-download-ftp  "&gnome-download-ftp;/gnome-python/2.28/gnome-python-&gnome-python-version;.tar.bz2">
  <!ENTITY gnome-python-md5sum        "a17ad952813ed86f520de8e07194a2bf">
  <!ENTITY gnome-python-size          "549 KB">
  <!ENTITY gnome-python-buildsize     "12 MB">
  <!ENTITY gnome-python-time          "0.3 SBU">

  <!ENTITY gnome-python-desktop-download-http "&gnome-download-http;/gnome-python-desktop/&gnome-version;/gnome-python-desktop-&gnome-python-desktop-version;.tar.bz2">
  <!ENTITY gnome-python-desktop-download-ftp  "&gnome-download-ftp;/gnome-python-desktop/&gnome-version;/gnome-python-desktop-&gnome-python-desktop-version;.tar.bz2">
  <!ENTITY gnome-python-desktop-md5sum        "b90f6e96a6321e7bf859f6faff2aa4df">
  <!ENTITY gnome-python-desktop-size          "584 KB">
  <!ENTITY gnome-python-desktop-buildsize     "15 MB">
  <!ENTITY gnome-python-desktop-time          "0.3 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="pygobject"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="pygtk"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="pygtksourceview"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="pyorbit"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="gnome-python"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="gnome-python-desktop"/></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>

      <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="python"/></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>Python2</application> bindings to
      <application>Cairo</application>.</para>

      &lfs70_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="python"/> 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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>None</seg>
          <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</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="python"/> 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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>None</seg>
          <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 PyGObject -->
  <sect2 id="pygobject" xreflabel="PyGObject-&pygobject-version;">

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

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

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

      <para>PyGObject provides <application>Python</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="&pygobject-download-http;"/></para>
        </listitem>
        <listitem>
          <para>Download (FTP): <ulink url="&pygobject-download-ftp;"/></para>
        </listitem>
        <listitem>
          <para>Download MD5 sum: &pygobject-md5sum;</para>
        </listitem>
        <listitem>
          <para>Download size: &pygobject-size;</para>
        </listitem>
        <listitem>
          <para>Estimated disk space required: &pygobject-buildsize;</para>
        </listitem>
        <listitem>
          <para>Estimated build time: &pygobject-time;</para>
        </listitem>
      </itemizedlist>

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

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python"/> and
        <xref linkend="glib2"/>
      </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
               _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>

      <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="pygobject"/></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/pygtk,lib/{pygtk/2.0/demos/images,
          python&python2-majorver;/site-packages/gtk-2.0/gtk},
          share/{gtk-doc/html/pygtk/{cursors,icons,images},pygtk/2.0/defs}}</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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>None</seg>
          <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 PyORBit -->
  <sect2 id="pyorbit" xreflabel="PyORBit-&pyorbit-version;">

    <title>PyORBit-&pyorbit-version;</title>

    <indexterm zone="pyorbit">
      <primary sortas="a-PyORBit">PyORBit</primary>
    </indexterm>

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

      <para>This is a <application>Python</application> language binding for
      the <application>ORBit2</application> CORBA implementation.</para>

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

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

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required"><xref linkend="python"/> and
      <xref linkend="ORBit2"/></para>

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

    </sect3>

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

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

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

      <!-- There's some test scripts, but I don't know what to run -->
      <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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>None</seg>
          <seg>PyORBit Python library module</seg>
          <seg>/usr/include/pyorbit-2</seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End PyORBit -->

  <!-- Begin Gnome-Python -->
  <sect2 id="gnome-python" xreflabel="Gnome-Python-&gnome-python-version;">

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

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

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

      <para>Gnome-Python provides <application>Python</application> modules
      for various GNOME libraries.</para>

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

      <bridgehead renderas="sect4">Gnome-Python Dependencies</bridgehead>

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

      <!-- Many modules get their deps pulled in through libgnome: libbonobo,
           gnome-vfs, GConf -->

      <bridgehead renderas="sect5">Required (gnome.ui module)</bridgehead>
      <para role="required"><xref linkend="pyorbit"/> and
      <xref linkend="libgnomeui"/></para>

      <bridgehead renderas="sect5">Required (gnome.canvas module)</bridgehead>
      <para role="required"><xref linkend="libgnomecanvas"/></para>

      <bridgehead renderas="sect5">Required (gnomevfs module bonobo
      support)</bridgehead>
      <para role="required"><xref linkend="pyorbit"/></para>

      <bridgehead renderas="sect5">Required (bonobo.ui module)</bridgehead>
      <para role="required"><xref linkend="libbonoboui"/></para>

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

    </sect3>

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

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

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

      <!-- Tests were crashing on me; need to figure out why -->
      <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 Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>None</seg>
          <seg>libpythonmethod.so, _bonobo.so, activation.so, ui.so, gconf.so,
          _gnome.so, ui.so, gnomecanvas.so, _gnomevfs.so, and
          gnomevfsbonobo.so</seg>
          <seg>/usr/{include/gnome-python-2.0,
          lib/python&python2-majorver;/site-packages/gtk-2.0/{bonobo,gnomevfs},
          share/{gtk-doc/html/pygnomevfs,pygtk/2.0/argtypes}}</seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End Gnome-Python -->

  <!-- Begin Gnome-Python-Desktop -->
  <sect2 id="gnome-python-desktop" xreflabel="Gnome-Python-Desktop-&gnome-python-desktop-version;">

    <title>Gnome-Python-Desktop-&gnome-python-desktop-version;</title>

    <indexterm zone="gnome-python-desktop">
      <primary sortas="a-Gnome-Python-Desktop">Gnome-Python-Desktop</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Gnome-Python-Desktop Module</title>

      <para>Gnome-Python-Desktop provides additional <application>Python</application>
      modules for GNOME libraries.</para>

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

      <bridgehead renderas="sect4">Gnome-Python-Desktop Dependencies</bridgehead>

      <!-- Not strictly true, but needed to find install directories and
           by most modules -->
      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required"><xref linkend="gnome-python"/></para>

      <bridgehead renderas="sect5">Required (gnomeapplet module)</bridgehead>
      <para role="required"><xref linkend="gnome-panel"/></para>

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

      <bridgehead renderas="sect5">Required (gnomeprint.ui module)</bridgehead>
      <para role="required"><xref linkend="libgnomeprintui"/></para>

      <!-- looks like version 1.x of gtksourceview is the requirement -->
      <bridgehead renderas="sect5">Required (gtksourceview module)</bridgehead>
      <para role="required"><xref linkend="gtksourceview"/> (Version 1.x required)</para>

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

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

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

      <bridgehead renderas="sect5">Required (braseromedia and braseroburn modules)</bridgehead>
      <para role="required"><xref linkend="brasero"/></para>

      <bridgehead renderas="sect5">Required (mediaprofiles module)</bridgehead>
      <para role="required"><xref linkend="gnome-media"/></para>

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

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

      <bridgehead renderas="sect5">Required (gnomekeyring module)</bridgehead>
      <para role="required"><xref linkend="gnome-keyring"/></para>

      <bridgehead renderas="sect5">Required (gnomedesktop module)</bridgehead>
      <para role="required"><xref linkend="gnome-desktop"/></para>

      <bridgehead renderas="sect5">Required (bugbuddy module)</bridgehead>
      <para role="required"><xref linkend="bug-buddy"/></para>

      <bridgehead renderas="sect5">Required (evolution.ebook and evolution.ecal modules)</bridgehead>
      <para role="required"><xref linkend="evolution-data-server"/></para>

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

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

    </sect3>

    <sect3 role="installation">
      <title>Installation of Gnome-Python-Desktop</title>

      <para>Install <application>Gnome-Python-Desktop</application> by running
      the following commands:</para>

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

      <!-- Tests were crashing on me; need to figure out why -->
      <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><parameter>--enable-metacity</parameter>: This option enables
      building the metacity module if <xref linkend="metacity"/> 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>None</seg>
          <seg>braseroburn.so, braseromedia.so, evince.so, ebook.so, ecal.so,
          gnomeapplet.so, _gnomedesktop.so, gnomekeyring.so, _print.so, ui.so,
          gtop.so, mediaprofiles.so, rsvg.so, plparser.so, and wnck.so</seg>
          <seg>/usr/{lib/python&python2-majorver;/site-packages/gtk-2.0/{evolution,
          gnomedesktop,gnomeprint,totem},share/gtk-doc/html/pygnomeprintui}</seg>
          <seg>None</seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End Gnome-Python-Desktop -->

</sect1>