glfs/general/prog/libxml2py2.xml

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

  <!-- The download, md5sum, size entities need to match those used in libxml2.xml -->
  <!ENTITY libxml2py2-download-http "http://xmlsoft.org/sources/libxml2-&libxml2-version;.tar.gz">
  <!ENTITY libxml2py2-download-ftp  "ftp://xmlsoft.org/libxml2/libxml2-&libxml2-version;.tar.gz">
  <!ENTITY libxml2py2-md5sum        "b786e353e2aa1b872d70d5d1ca0c740d">
  <!ENTITY libxml2py2-size          "5.2 MB">
  <!ENTITY libxml2py2-buildsize     "54 MB (2.3 MB installed)">
  <!ENTITY libxml2py2-time          "less than 0.1 SBU">
]>

  <!-- Begin libxml2py2 -->
  <sect2 id="libxml2py2" xreflabel="libxml2-&libxml2-version; (for Python2)">

    <title>libxml2-&libxml2-version; (for its Python2 module)</title>

    <indexterm zone="libxml2py2">
      <primary sortas="a-libxml2py2">libxml2</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to the libxml2 Python2 module</title>

      <para>
        These instructions provide the <application>Python2</application>
        bindings for <application>libxml2</application>: the
        <application>Python3</application> bindings are built as part of <xref
        linkend="libxml2"/> and most packages in the book do not use these
        bindings for the older <application>Python2</application>.
      </para>

      <para>
        By building these bindings after <xref linkend="libxml2"/> has
        been installed, there is no need to rebuild the time-consuming (if all
        dependencies are used) main part of that package.
      </para>

      &lfs82_checked;

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

      <bridgehead renderas="sect4">libxml2 (Python2) Dependencies</bridgehead>

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

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

    <sect3 role="installation">
      <title>Installation of libxml2 Python2 module</title>

<!-- Editors note: Use \-\-root= instead of DESTDIR= when updating. -->

      <para>
        To build the <application>Python 2</application> module, run:
      </para>

<screen><userinput>cd python             &amp;&amp;
python setup.py build</userinput></screen>

      <para>
        To install the <application>Python 2</application> module,
        as the
        <systemitem class="username">root</systemitem> user run:
      </para>

<screen role="root"><userinput>python setup.py install --optimize=1</userinput></screen>

    </sect3>

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

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

        <seglistitem>
          <seg>
            drv_libxml2.py, libxml2.py
          </seg>
          <seg>
            libxml2mod.so
          </seg>
          <seg>
            None
          </seg>
        </seglistitem>
      </segmentedlist>

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

      <varlistentry id="drv_libxml2.py2">
        <term><command>drv_libxml2.py</command></term>
        <listitem>
          <para>
            is a SAX <application>Python2</application> driver for libxml2.
          </para>
          <indexterm zone="libxml2py2 drv_libxml2.py2">
            <primary sortas="b-drv_libxml2.py2">drv_libxml2.py for Python2</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libxml2.py2">
        <term><command>libxml2.py</command></term>
        <listitem>
          <para>
            is the <application>Python2</application> binding for libxml2.
          </para>
          <indexterm zone="libxml2py2 libxml2.py2">
            <primary sortas="b-libxml2.py2">libxml2.py for Python2</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libxml2mod2">
        <term><filename class="libraryfile">libxml2mod.so</filename></term>
        <listitem>
          <para>
            is the interface for <application>Python2</application>
            to use <filename class="libraryfile">libxml2.so</filename>.
          </para>
          <indexterm zone="libxml2py2 libxml2mod2">
            <primary sortas="c-libxml2mod">libxml2mod.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

    </sect3>

  </sect2>
  <!--End lbxml2py2 -->