glfs/general/prog/perl-deps/perl-xml-sax.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;

  <!ENTITY my-download-http "&metacpan_authors;/G/GR/GRANTM/XML-SAX-&XML-SAX-version;.tar.gz">
  <!ENTITY my-md5sum "b62e3754523695c7f5bbcafa3676a38d">

]>

  <!-- Begin XML::SAX -->
  <sect2 id="perl-xml-sax" xreflabel="XML-SAX-&XML-SAX-version;">

    <title>XML::SAX-&XML-SAX-version;</title>

    <indexterm zone="perl-xml-sax">
      <primary sortas="a-XML-SAX">XML::SAX</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to XML::SAX</title>

      <para>
        XML::SAX is a SAX parser access API for Perl. It includes classes and
        APIs required for implementing SAX drivers, along with a factory class
        for returning any SAX parser installed on the user's system.
      </para>

      &lfs110a_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&my-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &my-md5sum;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">XML::SAX Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="libxml2"/>,
        <xref linkend="perl-xml-namespacesupport"/> and
        <xref linkend="perl-xml-sax-base"/>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of XML::SAX</title>

        <!-- claimed to not support parallel building, but all it does is
         copy a few files, works with -j4 although running parallel builds
         on modules is usually not beneficial : Ken -->

      <para>
        This module uses a variant of the standard build and installation
         instructions:

<screen><userinput>yes | perl Makefile.PL &amp;&amp;
make             &amp;&amp;
make test</userinput></screen>

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

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

      </para>

    </sect3>

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

      <para>
        <command>yes</command>: Perl will ask if you want it to alter
        ParserDetails.ini and then wait for a response. The default is
        'y'. Using 'yes' allows you to script this.
      </para>

    </sect3>

  </sect2>