Changeset 10a2ee5


Ignore:
Timestamp:
07/14/2005 12:51:10 AM (16 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
10.0, 10.1, 11.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, ken/refactor-virt, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
ba4b31cf
Parents:
dc913a5a
Message:

Complete overhaul of the Perl Modules; module version updates, new modules, additional dependencies, removal of obsolete modules, text rewrite and new layout

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4719 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
3 edited

Legend:

Unmodified
Added
Removed
  • general.ent

    rdc913a5a r10a2ee5  
    1 <!ENTITY day          "12">
     1<!ENTITY day          "13">
    22<!ENTITY month        "07">
    33<!ENTITY year         "2005">
     
    149149<!ENTITY tcl-version                  "8.4.9">
    150150<!ENTITY tk-version                   "8.4.9">
     151
     152<!-- Used to identify the target LFS version in the
     153     PDL and Perl Modules instructions -->
    151154<!ENTITY LFS-Perl-version             "5.8.6">
     155
     156<!-- Perl module versions used in the Perl Modules instructions -->
    152157<!ENTITY Module-Info-version          "0.28">
    153 <!ENTITY Gtk-Perl-version             "0.7009">
    154 <!ENTITY XML-Parser-version           "2.34">
    155 <!ENTITY XML-Writer-version           "0.520">
    156 <!ENTITY SGMLSpm-version              "1.03ii">
    157 <!ENTITY Perl-Tk-version              "804.027">
    158 <!ENTITY Net-DNS-version              "0.48">
    159 <!ENTITY Digest-HMAC-version          "1.01">
    160 <!ENTITY Digest-SHA1-version          "2.10">
    161 <!ENTITY LWP-version                  "5.803">
    162 <!ENTITY URI-version                  "1.35">
    163 <!ENTITY Business-ISBN-version        "1.79">
    164 <!ENTITY Business-ISBN-Data-version   "1.09">
    165158<!ENTITY Test-Pod-version             "1.20">
    166159<!ENTITY Pod-Simple-version           "3.02">
    167160<!ENTITY Pod-Escapes-version          "1.04">
    168161<!ENTITY Test-Builder-Tester-version  "1.01">
    169 <!ENTITY Test-Prereq-version          "1.025">
     162<!ENTITY Module-Build-version         "0.2611">
     163<!ENTITY Module-Signature-version     "0.44">
     164<!ENTITY Digest-SHA-version           "5.28">
     165<!ENTITY PAR-Dist-version             "0.07">
     166<!ENTITY ExtUtils-ParseXS-version     "2.11">
     167<!ENTITY ExtUtils-CBuilder-version    "0.12">
     168<!ENTITY Archive-Tar-version          "1.24">
     169<!ENTITY IO-Zlib-version              "1.04">
     170<!ENTITY Compress-Zlib-version        "1.34">
     171<!ENTITY YAML-version                 "0.39">
     172<!ENTITY XML-Parser-version           "2.34">
     173<!ENTITY SGMLSpm-version              "1.03ii">
     174<!ENTITY Perl-Tk-version              "804.027">
     175<!ENTITY Net-DNS-version              "0.52">
     176<!ENTITY Digest-HMAC-version          "1.01">
     177<!ENTITY Digest-SHA1-version          "2.10">
     178<!ENTITY Net-IP-version               "1.23">
     179<!ENTITY IO-Socket-INET6-version      "2.51">
     180<!ENTITY Socket6-version              "0.18">
     181<!ENTITY Digest-BubbleBabble-version  "0.01">
     182<!ENTITY LWP-version                  "5.803">
     183<!ENTITY URI-version                  "1.35">
     184<!ENTITY Business-ISBN-version        "1.80">
     185<!ENTITY Business-ISBN-Data-version   "1.10">
     186<!ENTITY Test-Prereq-version          "1.027">
    170187<!ENTITY Module-Corelist-version      "2.02">
    171188<!ENTITY HTML-Parser-version          "3.45">
     
    174191<!ENTITY Crypt-SSLeay-version         "0.51">
    175192<!ENTITY DateManip-version            "5.44">
    176 <!ENTITY Finance-Quote-version        "1.08">
     193<!ENTITY Finance-Quote-version        "1.10">
    177194<!ENTITY HTML-TableExtract-version    "2.02">
     195
     196<!-- Perl module versions used in the PDL instructions -->
    178197<!ENTITY Filter-version               "1.30">
    179198<!ENTITY Term-ReadLine-Gnu-version    "1.15">
  • general/prog/perl-modules.xml

    rdc913a5a r10a2ee5  
    2626    <title>Introduction to Perl Modules</title>
    2727
    28     <para>The <application>Perl</application> module packages add useful objects
    29     to the <application>Perl</application> language.  Modules utilized by packages
    30     throughout BLFS are listed here, along with their dependencies. Most references to
    31     <application>Perl</application> modules are in the form of Module, Module::SubName
    32     or Module::Sub::Name, however occasionally you'll also see Module, Module-SubName
    33     or Module-Sub-Name. Most references on this page are in the latter form, as these
    34     are the official package names.</para>
     28    <para>The <application>Perl</application> module packages add useful
     29    objects to the <application>Perl</application> language. Modules utilized
     30    by packages throughout BLFS are listed here, along with their dependencies.
     31    Most references to <application>Perl</application> modules are in the form
     32    of Module, Module::SubName or Module::Sub::Name, however occasionally
     33    you'll also see Module, Module-SubName or Module-Sub-Name. Most references
     34    on this page are in the latter form, as these are the official package
     35    names.</para>
    3536
    3637    <itemizedlist spacing="compact">
     
    4546    </itemizedlist>
    4647
    47     <bridgehead renderas="sect3" id="perl-module-info">The Module::Info Module</bridgehead>
     48    <bridgehead renderas="sect3" id="perl-module-info"
     49    xreflabel="Module::Info">The Module::Info Module</bridgehead>
    4850
    4951    <indexterm zone="perl-modules perl-module-info">
     
    5254
    5355    <para>One module in particular is shown first, as this module's usefulness
    54     warrants installation, even though it won't be required by many other modules.
    55     The Module::Info module can tell you if a particular module is included in,
    56     or has been installed into your <application>Perl</application> installation.
    57     Additionally, the module can tell you what versions are installed and what
    58     dependencies are required for them. You can even use Module::Info to gather
    59     dependencies of uninstalled modules.</para>
     56    warrants installation, even though it won't be required by many other
     57    modules. The Module::Info module can tell you if a particular module is
     58    included in, or has been installed into your <application>Perl</application>
     59    installation. Additionally, Module::Info can tell you what versions are
     60    installed and what dependencies are required for them. You can even use
     61    Module::Info to gather dependencies of uninstalled modules.</para>
    6062
    6163    <itemizedlist spacing='compact'>
     
    6365        <para><ulink
    6466        url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
    65         Module-Info-&Module-Info-version;</ulink></para>
    66       </listitem>
    67     </itemizedlist>
    68 
    69     <bridgehead renderas="sect3">Perl Module Packages</bridgehead>
    70 
    71     <itemizedlist spacing='compact'>
    72       <listitem>
    73         <para id="perl-gtk-perl"><ulink
    74         url="http://www.cpan.org/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz">
    75         Gtk-Perl-&Gtk-Perl-version;</ulink></para>
    76         <indexterm zone="perl-modules perl-gtk-perl">
    77           <primary sortas="g-Gtk-Perl">Gtk::Perl</primary>
    78         </indexterm>
     67        Module-Info-&Module-Info-version;</ulink>
     68        (<xref linkend="perl-standard-install"/>)</para>
     69      </listitem>
     70    </itemizedlist>
     71
     72    <bridgehead renderas="sect3" id="perl-test-pod"
     73    xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
     74
     75    <indexterm zone="perl-modules perl-test-pod">
     76      <primary sortas="g-Test-Pod">Test::Pod</primary>
     77    </indexterm>
     78
     79    <para>Another useful module, and one which is (typically optionally) used
     80    by other modules during the build process is the Test:Pod module. This
     81    module is used to check the validity of POD (Plain Old Documentation)
     82    files. The Test::Pod module is typically included by module authors to
     83    automatically find and check all POD files in a module distribution. This
     84    module and all the dependencies can be installed using the
     85    <xref linkend="perl-standard-install"/>.</para>
     86
     87    <itemizedlist spacing='compact'>
     88      <listitem>
     89        <para><ulink
     90        url="http://www.cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
     91        Test-Pod-&Test-Pod-version;</ulink></para>
     92
    7993        <itemizedlist>
    8094          <listitem>
    81             <para id="perl-xml-writer"><ulink
    82             url="http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz">
    83             XML-Writer-&XML-Writer-version;</ulink></para>
    84             <indexterm zone="perl-modules perl-xml-writer">
    85               <primary sortas="g-XML-Writer">XML::Writer</primary>
    86             </indexterm>
    87           </listitem>
    88           <listitem>
    89             <para id="perl-xml-parser"><ulink
    90             url="http://www.cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
    91             XML-Parser-&XML-Parser-version;</ulink></para>
    92             <indexterm zone="perl-modules perl-xml-parser">
    93               <primary sortas="g-XML-Parser">XML::Parser</primary>
    94             </indexterm>
    95             <itemizedlist>
    96               <listitem>
    97                 <para><xref linkend="expat"/></para>
    98               </listitem>
    99             </itemizedlist>
    100           </listitem>
    101           <listitem>
    102             <para><xref linkend="GTK"/></para>
     95            <para id="perl-pod-simple"><ulink
     96            url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz">
     97            Pod-Simple-&Pod-Simple-version;</ulink></para>
     98            <indexterm zone="perl-modules perl-pod-simple">
     99              <primary sortas="g-Pod-Simple">Pod::Simple</primary>
     100            </indexterm>
     101
     102            <itemizedlist>
     103              <listitem>
     104                <para id="perl-pod-escapes"><ulink
     105                url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
     106                Pod-Escapes-&Pod-Escapes-version;</ulink></para>
     107                <indexterm zone="perl-modules perl-pod-escapes">
     108                  <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
     109                </indexterm>
     110              </listitem>
     111            </itemizedlist>
     112
     113          </listitem>
     114          <listitem>
     115            <para id="perl-test-builder-tester"><ulink
     116            url="http://www.cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
     117            Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
     118            <indexterm zone="perl-modules perl-test-builder-tester">
     119              <primary sortas="g-Test-Builder-Tester">
     120              Test::Builder::Tester</primary>
     121            </indexterm>
    103122          </listitem>
    104123        </itemizedlist>
    105       </listitem>
    106       <listitem>
    107         <para id="perl-sgmlspm"><ulink
     124
     125      </listitem>
     126    </itemizedlist>
     127
     128    <bridgehead renderas="sect3" id="perl-module-build"
     129    xreflabel="Module::Build">The Module::Build Module</bridgehead>
     130
     131    <indexterm zone="perl-modules perl-module-build">
     132      <primary sortas="g-Module-Build">Module::Build</primary>
     133    </indexterm>
     134
     135    <para>The Module::Build module is a system for building, testing, and
     136    installing <application>Perl</application> modules. It is meant to be an
     137    alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
     138    the module through subclassing in a much more straightforward way than with
     139    MakeMaker. It also does not require a <command>make</command> command on
     140    your system. Most of the Module::Build code is
     141    pure-<application>Perl</application> and written in a very cross-platform
     142    way.</para>
     143
     144    <para>The Module::Build module (as well as any other
     145    <application>Perl</application> module that uses the Module::Build build
     146    system) uses <xref linkend="perl-module-build-install"/>. All the
     147    dependencies can be installed using the
     148    <xref linkend="perl-standard-install"/>.</para>
     149
     150    <note>
     151      <para>The Compress::Zlib module requires the following
     152      <command>sed</command> after untarring the distribution tarball (before
     153      any other build commands) to use the system-installed copy of
     154      <application>Zlib</application>.</para>
     155
     156<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
     157       -e "s|INCLUDE    = ./zlib-src|INCLUDE    = /usr/include|" \
     158       -e "s|LIB        = ./zlib-src|LIB        = /usr/lib|" \
     159    config.in</userinput></screen>
     160    </note>
     161
     162    <itemizedlist spacing='compact'>
     163      <listitem>
     164        <para><ulink
     165        url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
     166        Module-Build-&Module-Build-version;</ulink></para>
     167
     168        <itemizedlist>
     169          <listitem>
     170            <para id="perl-module-signature"><ulink
     171            url="http://www.cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
     172            Module-Signature-&Module-Signature-version;</ulink> (optional)</para>
     173            <indexterm zone="perl-modules perl-module-signature">
     174              <primary sortas="g-Module-Signature">Module::Signature</primary>
     175            </indexterm>
     176
     177            <itemizedlist>
     178              <listitem>
     179                <para id="perl-digest-sha"><ulink
     180                url="http://www.cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
     181                Digest-SHA-&Digest-SHA-version;</ulink></para>
     182                <indexterm zone="perl-modules perl-digest-sha">
     183                  <primary sortas="g-Digest-SHA">Digest::SHA</primary>
     184                </indexterm>
     185              </listitem>
     186              <listitem>
     187                <para id="perl-par-dist"><ulink
     188                url="http://www.cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
     189                PAR-Dist-&PAR-Dist-version;</ulink></para>
     190                <indexterm zone="perl-modules perl-par-dist">
     191                  <primary sortas="g-PAR-Dist">PAR::Dist</primary>
     192                </indexterm>
     193              </listitem>
     194              <listitem>
     195                <para><xref linkend="gnupg"/></para>
     196              </listitem>
     197            </itemizedlist>
     198
     199          </listitem>
     200          <listitem>
     201            <para id="perl-extutils-parsexs"><ulink
     202            url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
     203            ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
     204            <indexterm zone="perl-modules perl-extutils-parsexs">
     205              <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
     206            </indexterm>
     207
     208            <itemizedlist>
     209              <listitem>
     210                <para id="perl-extutils-cbuilder"><ulink
     211                url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
     212                ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
     213                <indexterm zone="perl-modules perl-extutils-cbuilder">
     214                  <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
     215                </indexterm>
     216              </listitem>
     217            </itemizedlist>
     218
     219          </listitem>
     220          <listitem>
     221            <para id="perl-archive-tar"><ulink
     222            url="http://www.cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
     223            Archive-Tar-&Archive-Tar-version;</ulink></para>
     224            <indexterm zone="perl-modules perl-archive-tar">
     225              <primary sortas="g-Archive-Tar">Archive::Tar</primary>
     226            </indexterm>
     227
     228            <itemizedlist>
     229              <listitem>
     230                <para id="perl-io-zlib"><ulink
     231                url="http://www.cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
     232                IO-Zlib-&IO-Zlib-version;</ulink></para>
     233                <indexterm zone="perl-modules perl-io-zlib">
     234                  <primary sortas="g-IO-Zlib">IO::Zlib</primary>
     235                </indexterm>
     236
     237                <itemizedlist>
     238                  <listitem>
     239                    <para id="perl-compress-zlib"><ulink
     240                    url="http://www.cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
     241                    Compress-Zlib-&Compress-Zlib-version;</ulink></para>
     242                    <indexterm zone="perl-modules perl-compress-zlib">
     243                      <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
     244                    </indexterm>
     245                  </listitem>
     246                </itemizedlist>
     247
     248              </listitem>
     249              <listitem>
     250                <para><xref linkend="perl-test-pod"/></para>
     251              </listitem>
     252            </itemizedlist>
     253
     254          </listitem>
     255          <listitem>
     256            <para id="perl-yaml"><ulink
     257            url="http://www.cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
     258            YAML-&YAML-version;</ulink></para>
     259            <indexterm zone="perl-modules perl-yaml">
     260              <primary sortas="g-YAML">YAML</primary>
     261            </indexterm>
     262          </listitem>
     263        </itemizedlist>
     264
     265      </listitem>
     266    </itemizedlist>
     267
     268    <bridgehead renderas="sect4" id="perl-module-build-install"
     269    xreflabel="modified build instructions">Module::Build Build and
     270    Installation Instructions</bridgehead>
     271
     272<screen><userinput>perl Build.PL &amp;&amp;
     273./Build test</userinput></screen>
     274
     275    <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
     276
     277<screen role='root'><userinput>./Build install</userinput></screen>
     278
     279    <bridgehead renderas="sect3" id="perl-html-parser"
     280    xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead>
     281
     282    <indexterm zone="perl-modules perl-html-parser">
     283      <primary sortas="g-HTML-Parser">HTML::Parser</primary>
     284    </indexterm>
     285
     286    <para>The HTML::Parser distribution is a collection of modules that parse
     287    and extract information from HTML documents. In order to use the included
     288    HTML::HeadParser module, you will also need to install
     289    <xref linkend="perl-lwp"/>. The two modules listed below can be installed
     290    using the <application>Perl</application> Module
     291    <xref linkend="perl-standard-install"/>.</para>
     292
     293    <itemizedlist spacing='compact'>
     294      <listitem>
     295        <para><ulink
     296        url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
     297        HTML-Parser-&HTML-Parser-version;</ulink></para>
     298
     299        <itemizedlist>
     300          <listitem>
     301            <para id="perl-html-tagset"><ulink
     302            url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
     303            HTML-Tagset-&HTML-Tagset-version;</ulink></para>
     304            <indexterm zone="perl-modules perl-html-tagset">
     305              <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
     306            </indexterm>
     307          </listitem>
     308        </itemizedlist>
     309
     310      </listitem>
     311    </itemizedlist>
     312
     313    <bridgehead renderas="sect3" id="perl-xml-parser"
     314    xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
     315
     316    <indexterm zone="perl-modules perl-xml-parser">
     317      <primary sortas="g-XML-Parser">XML::Parser</primary>
     318    </indexterm>
     319
     320    <para>The XML::Parser module is a <application>Perl</application> extension
     321    interface to James Clark's XML parser,
     322    <application>expat</application>. The module can be installed using the
     323    <application>Perl</application> Module
     324    <xref linkend="perl-standard-install"/>.</para>
     325
     326    <itemizedlist spacing='compact'>
     327      <listitem>
     328        <para><ulink
     329        url="http://www.cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
     330        XML-Parser-&XML-Parser-version;</ulink></para>
     331
     332        <itemizedlist>
     333          <listitem>
     334            <para><xref linkend="expat"/></para>
     335          </listitem>
     336        </itemizedlist>
     337
     338      </listitem>
     339    </itemizedlist>
     340
     341    <bridgehead renderas="sect3" id="perl-sgmlspm"
     342    xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
     343
     344    <indexterm zone="perl-modules perl-sgmlspm">
     345      <primary sortas="g-SGMLSpm">SGMLSpm</primary>
     346    </indexterm>
     347
     348    <para>The SGMLSpm module is a <application>Perl</application> library
     349    used for parsing the output from James Clark's SGMLS and NSGMLS
     350    parsers. This module requires modified installation instructions, shown
     351    below.</para>
     352
     353    <itemizedlist spacing='compact'>
     354      <listitem>
     355        <para><ulink
    108356        url="http://www.cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
    109357        SGMLSpm-&SGMLSpm-version;</ulink></para>
    110         <indexterm zone="perl-modules perl-sgmlspm">
    111           <primary sortas="g-SGMLSpm">SGMLSpm</primary>
    112         </indexterm>
    113       </listitem>
    114       <listitem>
    115         <para id="perl-perl-tk"><ulink
     358      </listitem>
     359    </itemizedlist>
     360
     361    <para>If your system's <application>Perl</application> version is different
     362    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
     363    command below to reflect the version you have installed.</para>
     364
     365<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
     366       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
     367       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
     368    Makefile</userinput></screen>
     369
     370    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     371
     372<screen role="root"><userinput>make install &amp;&amp;
     373install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
     374make install_html &amp;&amp;
     375rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
     376install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
     377
     378    <bridgehead renderas="sect3" id="perl-tk"
     379    xreflabel="Tk">The Tk Module</bridgehead>
     380
     381    <indexterm zone="perl-modules perl-tk">
     382      <primary sortas="g-Tk">Tk</primary>
     383    </indexterm>
     384
     385    <para>The <application>Tk</application> module is a
     386    <application>Perl</application> interface to the
     387    <application>Tk</application> package. The goal of this release is Unicode
     388    support via <application>Perl</application>'s and
     389    core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
     390    builds and loads into a threaded <application>Perl</application> but is NOT
     391    yet thread safe. The module can be installed using the
     392    <application>Perl</application> Module
     393    <xref linkend="perl-standard-install"/>.</para>
     394
     395    <itemizedlist spacing='compact'>
     396      <listitem>
     397        <para><ulink
    116398        url="http://www.cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
    117399        Tk-&Perl-Tk-version;</ulink></para>
    118         <indexterm zone="perl-modules perl-perl-tk">
    119           <primary sortas="g-Perl-Tk">Perl::Tk</primary>
    120         </indexterm>
     400
    121401        <itemizedlist>
    122402          <listitem>
     
    124404          </listitem>
    125405        </itemizedlist>
    126       </listitem>
    127       <listitem>
    128         <para id="perl-net-dns"><ulink
    129         url="http://www.cpan.org/authors/id/C/CR/CREIN/Net-DNS-&Net-DNS-version;.tar.gz">
     406
     407      </listitem>
     408    </itemizedlist>
     409
     410    <bridgehead renderas="sect3" id="perl-net-dns"
     411    xreflabel="Net-DNS">The Net::DNS Module</bridgehead>
     412
     413    <indexterm zone="perl-modules perl-net-dns">
     414      <primary sortas="g-Net-DNS">Net::DNS</primary>
     415    </indexterm>
     416
     417    <para>Net::DNS is a DNS resolver implemented in
     418    <application>Perl</application>. It can be used to perform nearly any type
     419    of DNS query from a <application>Perl</application> script. The Net::DNS
     420    module and all its dependencies can be installed using the
     421    <application>Perl</application> Module
     422    <xref linkend="perl-standard-install"/>.</para>
     423
     424    <itemizedlist spacing='compact'>
     425      <listitem>
     426        <para><ulink
     427        url="http://www.cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
    130428        Net-DNS-&Net-DNS-version;</ulink></para>
    131         <indexterm zone="perl-modules perl-net-dns">
    132           <primary sortas="g-Net-DNS">Net::DNS</primary>
    133         </indexterm>
     429
    134430        <itemizedlist>
    135431          <listitem>
     
    140436              <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
    141437            </indexterm>
     438
    142439            <itemizedlist>
    143440              <listitem>
     
    150447              </listitem>
    151448            </itemizedlist>
     449
     450          </listitem>
     451          <listitem>
     452            <para id="perl-net-ip"><ulink
     453            url="http://www.cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
     454            Net-IP-&Net-IP-version;</ulink></para>
     455            <indexterm zone="perl-modules perl-net-ip">
     456              <primary sortas="g-Net-IP">Net::IP</primary>
     457            </indexterm>
     458          </listitem>
     459          <listitem>
     460            <para id="perl-io-socket-inet6"><ulink
     461            url="http://www.cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
     462            IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
     463            IPv6 support)</para>
     464            <indexterm zone="perl-modules perl-io-socket-inet6">
     465              <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
     466            </indexterm>
     467
     468            <itemizedlist>
     469              <listitem>
     470                <para id="perl-socket6"><ulink
     471                url="http://www.cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
     472                Socket6-&Socket6-version;</ulink></para>
     473                <indexterm zone="perl-modules perl-socket6">
     474                  <primary sortas="g-Socket6">Socket6</primary>
     475                </indexterm>
     476              </listitem>
     477            </itemizedlist>
     478
     479          </listitem>
     480          <listitem>
     481            <para id="perl-digest-bubblebabble"><ulink
     482            url="http://www.cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
     483            Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
     484            (optional, only used during the test suite)</para>
     485            <indexterm zone="perl-modules perl-digest-bubblebabble">
     486              <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
     487            </indexterm>
    152488          </listitem>
    153489        </itemizedlist>
    154       </listitem>
    155       <listitem>
    156         <para id="perl-lwp"><ulink
     490
     491      </listitem>
     492    </itemizedlist>
     493
     494    <bridgehead renderas="sect3" id="perl-lwp"
     495    xreflabel="LWP">The LWP Module</bridgehead>
     496
     497    <indexterm zone="perl-modules perl-lwp">
     498      <primary sortas="g-LWP">LWP</primary>
     499    </indexterm>
     500
     501    <para>The libwww-perl (LWP) collection is a set of
     502    <application>Perl</application> modules which provides a simple and
     503    consistent application programming interface to the World-Wide Web. The
     504    main focus of the library is to provide classes and functions that allow
     505    you to write WWW clients. The library also contains modules that are of
     506    more general use and even classes that help you implement simple HTTP
     507    servers. The LWP modules and all its <application>Perl</application>
     508    module dependencies can be installed using the
     509    <application>Perl</application> Module
     510    <xref linkend="perl-standard-install"/>.</para>
     511
     512    <note>
     513      <para>The Compress::Zlib module requires the following
     514      <command>sed</command> after untarring the distribution tarball (before
     515      any other build commands) to use the system-installed copy of
     516      <application>Zlib</application>.</para>
     517 
     518<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
     519       -e "s|INCLUDE    = ./zlib-src|INCLUDE    = /usr/include|" \
     520       -e "s|LIB        = ./zlib-src|LIB        = /usr/lib|" \
     521    config.in</userinput></screen>
     522    </note>
     523
     524    <itemizedlist spacing='compact'>
     525      <listitem>
     526        <para><ulink
    157527        url="http://www.cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
    158528        LWP-&LWP-version;</ulink></para>
    159         <indexterm zone="perl-modules perl-lwp">
    160           <primary sortas="g-LWP">LWP</primary>
    161         </indexterm>
     529
    162530        <itemizedlist>
    163531          <listitem>
     
    168536              <primary sortas="g-URI">URI</primary>
    169537            </indexterm>
     538
    170539            <itemizedlist>
    171540              <listitem>
    172541                <para id="perl-business-isbn"><ulink
    173542                url="http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
    174                 Business-ISBN-&Business-ISBN-version;</ulink> (Only used during the
    175                 test suite)</para>
     543                Business-ISBN-&Business-ISBN-version;</ulink> (optonal, only
     544                used during the test suite)</para>
    176545                <indexterm zone="perl-modules perl-business-isbn">
    177546                  <primary sortas="g-Business-ISBN">Business::ISBN</primary>
    178547                </indexterm>
     548
    179549                <itemizedlist>
    180550                  <listitem>
     
    185555                      <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
    186556                    </indexterm>
     557
    187558                    <itemizedlist>
    188559                      <listitem>
    189                         <para id="perl-test-pod"><ulink
    190                         url="http://www.cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
    191                         Test-Pod-&Test-Pod-version;</ulink></para>
    192                         <indexterm zone="perl-modules perl-test-pod">
    193                           <primary sortas="g-Test-Pod">Test::Pod</primary>
    194                         </indexterm>
    195                         <itemizedlist>
    196                           <listitem>
    197                             <para id="perl-pod-simple"><ulink
    198                             url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz">
    199                             Pod-Simple-&Pod-Simple-version;</ulink></para>
    200                             <indexterm zone="perl-modules perl-pod-simple">
    201                               <primary sortas="g-Pod-Simple">Pod::Simple</primary>
    202                             </indexterm>
    203                             <itemizedlist>
    204                               <listitem>
    205                                 <para id="perl-pod-escapes"><ulink
    206                                 url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
    207                                 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
    208                                 <indexterm zone="perl-modules perl-pod-escapes">
    209                                   <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
    210                                 </indexterm>
    211                               </listitem>
    212                             </itemizedlist>
    213                           </listitem>
    214                           <listitem>
    215                             <para id="perl-test-builder-tester"><ulink
    216                             url="http://www.cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
    217                             Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
    218                             <indexterm zone="perl-modules perl-test-builder-tester">
    219                               <primary sortas="g-Test-Builder-Tester">
    220                               Test::Builder::Tester</primary>
    221                             </indexterm>
    222                           </listitem>
    223                         </itemizedlist>
     560                        <para><xref linkend="perl-test-pod"/></para>
    224561                      </listitem>
    225562                      <listitem>
     
    230567                          <primary sortas="g-Test-Prereq">Test::Prereq</primary>
    231568                        </indexterm>
     569
    232570                        <itemizedlist>
    233571                          <listitem>
    234                             <para><ulink
    235                             url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
    236                             Module-Info-&Module-Info-version;</ulink></para>
     572                            <para><xref linkend="perl-module-info"/></para>
     573                          </listitem>
     574                          <listitem>
     575                            <para><xref linkend="perl-module-build"/> (optional)</para>
    237576                          </listitem>
    238577                          <listitem>
     
    245584                          </listitem>
    246585                        </itemizedlist>
     586
    247587                      </listitem>
    248588                    </itemizedlist>
     589
    249590                  </listitem>
    250591                </itemizedlist>
    251               </listitem>
    252             </itemizedlist>
    253           </listitem>
    254           <listitem>
    255             <para id="perl-html-parser"><ulink
    256             url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
    257             HTML-Parser-&HTML-Parser-version;</ulink></para>
    258             <indexterm zone="perl-modules perl-html-parser">
    259               <primary sortas="g-HTML-Parser">HTML::Parser</primary>
    260             </indexterm>
    261             <itemizedlist>
    262               <listitem>
    263                 <para id="perl-html-tagset"><ulink
    264                 url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
    265                 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
    266                 <indexterm zone="perl-modules perl-html-tagset">
    267                   <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
    268                 </indexterm>
    269               </listitem>
    270             </itemizedlist>
    271           </listitem>
    272           <listitem>
    273             <para id="perl-compress-zlib"><ulink
     592
     593              </listitem>
     594            </itemizedlist>
     595
     596          </listitem>
     597          <listitem>
     598            <para><xref linkend="perl-html-parser"/></para>
     599          </listitem>
     600          <listitem>
     601            <para><ulink
    274602            url="http://www.cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
    275603            Compress-Zlib-&Compress-Zlib-version;</ulink></para>
    276             <indexterm zone="perl-modules perl-compress-zlib">
    277               <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
    278             </indexterm>
    279604          </listitem>
    280605          <listitem>
    281606            <para id="perl-crypt-ssleay"><ulink
    282607            url="http://www.cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
    283             Crypt-SSLeay-&Crypt-SSLeay-version;</ulink></para>
     608            Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
     609            support)</para>
    284610            <indexterm zone="perl-modules perl-crypt-ssleay">
    285611              <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
    286612            </indexterm>
     613
     614            <itemizedlist>
     615              <listitem>
     616                <para><xref linkend="openssl"/></para>
     617              </listitem>
     618            </itemizedlist>
     619
    287620          </listitem>
    288621        </itemizedlist>
    289       </listitem>
    290       <listitem>
    291         <para id="perl-datemanip"><ulink
     622
     623      </listitem>
     624    </itemizedlist>
     625
     626    <bridgehead renderas="sect3" id="perl-date-manip"
     627    xreflabel="Date::Manip">The Date::Manip Module</bridgehead>
     628
     629    <indexterm zone="perl-modules perl-date-manip">
     630      <primary sortas="g-Date-Manip">Date::Manip</primary>
     631    </indexterm>
     632
     633    <para>Date::Manip is a set of routines designed to make any common
     634    date/time manipulation easy to do. Operations such as comparing two times,
     635    calculating a time a given amount of time from another, or parsing
     636    international times are all easily done. From the very beginning, the
     637    main focus of Date::Manip has been to be able to do ANY desired date/time
     638    operation easily.</para>
     639
     640    <itemizedlist spacing='compact'>
     641      <listitem>
     642        <para><ulink
    292643        url="http://www.cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
    293         DateManip-&DateManip-version;</ulink></para>
    294         <indexterm zone="perl-modules perl-datemanip">
    295           <primary sortas="g-DateManip">DateManip</primary>
    296         </indexterm>
    297       </listitem>
    298       <listitem>
    299         <para id="perl-finance-quote"><ulink
     644        DateManip-&DateManip-version;</ulink>
     645        (<xref linkend="perl-standard-install"/>)</para>
     646      </listitem>
     647    </itemizedlist>
     648
     649    <bridgehead renderas="sect3" id="perl-finance-quote"
     650    xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead>
     651
     652    <indexterm zone="perl-modules perl-finance-quote">
     653      <primary sortas="g-Finance-Quote">Finance::Quote</primary>
     654    </indexterm>
     655
     656    <para>Finance::Quote is used to get stock quotes from various Internet
     657    sources, including Yahoo! Finance, Fidelity Investments, and the Australian
     658    Stock Exchange. There are two methods of using this module &ndash; a
     659    functional interface that is depreciated, and an object-orientated method
     660    that provides greater flexibility and stability. With the exception of
     661    straight currency exchange rates, all information is returned as a
     662    two-dimensional hash (or a reference to such a hash, if called in a scalar
     663    context).</para>
     664
     665    <para>After you've installed the package, issue
     666    <command>perldoc Finance::Quote</command> for full information.
     667    Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
     668    after unpacking the distribution tarball and changing into the top-level
     669    directory. The module and dependencies can be installed using the
     670    <application>Perl</application> module
     671    <xref linkend="perl-standard-install"/>.</para>
     672
     673    <note>
     674      <para>To run the regression test suite, you'll need to create a
     675      symbolic link to the <filename class='directory'>test</filename>
     676      directory using the following command after unpacking the tarball
     677      and changing into the root directory of the sources:</para>
     678
     679<screen><userinput>ln -s test t</userinput></screen>
     680
     681      <para>Some tests will fail depending on certain conditions. See the
     682      <filename>INSTALL</filename> file for full details.</para>
     683    </note>
     684
     685    <itemizedlist spacing='compact'>
     686      <listitem>
     687        <para><ulink
    300688        url="http://www.cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
    301689        Finance-Quote-&Finance-Quote-version;</ulink></para>
    302         <indexterm zone="perl-modules perl-finance-quote">
    303           <primary sortas="g-Finance-Quote">Finance::Quote</primary>
    304         </indexterm>
     690
    305691        <itemizedlist>
    306692          <listitem>
     
    311697              <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
    312698            </indexterm>
    313             <itemizedlist>
    314               <listitem>
    315                 <para><ulink
    316                 url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
    317                 HTML-Parser-&HTML-Parser-version;</ulink></para>
    318                 <itemizedlist>
    319                   <listitem>
    320                     <para><ulink
    321                     url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
    322                     HTML-Tagset-&HTML-Tagset-version;</ulink></para>
    323                   </listitem>
    324                 </itemizedlist>
    325               </listitem>
    326             </itemizedlist>
    327           </listitem>
    328           <listitem>
    329             <para><ulink
    330             url="http://www.cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
    331             LWP-&LWP-version;</ulink> (see dependencies above)</para>
     699
     700            <itemizedlist>
     701              <listitem>
     702                <para><xref linkend="perl-html-parser"/></para>
     703              </listitem>
     704            </itemizedlist>
     705
     706          </listitem>
     707          <listitem>
     708            <para><xref linkend="perl-lwp"/></para>
    332709          </listitem>
    333710        </itemizedlist>
     711
    334712      </listitem>
    335713    </itemizedlist>
     
    337715  </sect2>
    338716
    339   <sect2 role="installation">
    340     <title>Installation of Perl Modules</title>
    341 
    342     <para>Install <application>Perl</application> modules by running the following
    343     commands:</para>
     717  <sect2 role="installation" id="perl-standard-install"
     718  xreflabel="build and installation instructions">
     719    <title>Standard Installation of Perl Modules</title>
     720
     721    <para>Install <application>Perl</application> modules by running the
     722    following commands:</para>
    344723
    345724<screen><userinput>perl Makefile.PL &amp;&amp;
     
    350729
    351730<screen role="root"><userinput>make install</userinput></screen>
    352 
    353     <para>The modules listed below require modifications to the instructions in
    354     order to install successfully.</para>
    355 
    356     <sect3>
    357       <title>Gtk-Perl-&Gtk-Perl-version;:</title>
    358 
    359 <screen><userinput>perl Makefile.PL --without-guessing &amp;&amp;
    360 make &amp;&amp;
    361 make test</userinput></screen>
    362 
    363     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    364 
    365 <screen role="root"><userinput>make install</userinput></screen>
    366 
    367     </sect3>
    368 
    369     <sect3>
    370       <title>SGMLSpm-&SGMLSpm-version;</title>
    371 
    372       <para>If your system's <application>Perl</application> version is different
    373       than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
    374       command below to reflect the version you have installed.</para>
    375 
    376 <screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
    377     -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
    378     -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
    379     Makefile</userinput></screen>
    380 
    381     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    382 
    383 <screen role="root"><userinput>make install &amp;&amp;
    384 install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
    385 make install_html &amp;&amp;
    386 rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
    387 install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
    388 
    389     </sect3>
    390731
    391732  </sect2>
     
    415756    <para>For additional commands and help, type <command>help</command>.</para>
    416757
     758    <para>Alternatively, for scripted or non-interactive installations, use the
     759    following syntax as the
     760    <systemitem class="username">root</systemitem> user:</para>
     761
     762<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
     763
    417764  </sect2>
    418765
  • introduction/welcome/changelog.xml

    rdc913a5a r10a2ee5  
    2424
    2525  <itemizedlist>
     26
     27    <listitem>
     28      <para>July 13th, 2005 [randy]: Major overhaul to the Perl Modules
     29      instructions including adding new modules, removing obsolete modules,
     30      adding additional dependencies, complete text rewrite and new page
     31      layout.</para>
     32    </listitem>
    2633
    2734    <listitem>
Note: See TracChangeset for help on using the changeset viewer.