source: general/prog/pygobject2.xml@ 1ac8b4c6

<?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 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          "732 KB">
  <!ENTITY pygobject2-buildsize     "24 MB">
  <!ENTITY pygobject2-time          "0.2 SBU">
]>

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

      &lfs7a_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="sect4">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/pygobject-&pygobject2-version;-fixes-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

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

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

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

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

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

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

<screen><userinput>patch -Np1 -i ../pygobject-&pygobject2-version;-fixes-1.patch   &amp;&amp;
sed -i "/seems to be moved/s/^/#/" ltmain.sh &amp;&amp;
./configure --prefix=/usr --disable-introspection &amp;&amp;
make</userinput></screen>

      <para>
        This package does not have a working testsuite.
      </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>
        <command>sed -i ... ltmain.sh</command>: This sed silences several
        useless and annoying warnings generated by libtool.
      </para>

      <para>
        <option>--disable-introspection</option>: Omit this switch if you have
        installed <xref linkend="gobject-introspection"/>. Note that it
        conflicts with <xref linkend="pygobject3"/>.
      </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 -->