source: general/prog/perl-modules.xml@ 47daa5a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 47daa5a was 47daa5a, checked in by Randy McMurchy <randy@…>, 18 years ago

Singled out the Compress::Zlib module and added descriptive comments to the Perl Modules instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5552 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 35.6 KB
RevLine 
[52d29f7]1<?xml version="1.0" encoding="ISO-8859-1"?>
[ff769b8c]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
[52d29f7]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
[23460a6]6
[a3a476d]7 <!ENTITY perl_modules_md5sums_download_http "http://anduin.linuxfromscratch.org/sources/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
8 <!ENTITY perl_modules_md5sums_download_ftp "ftp://anduin.linuxfromscratch.org/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
[52d29f7]9]>
10
[24a37fa7]11<sect1 id="perl-modules" xreflabel="Perl modules">
[9ee1058]12 <?dbhtml filename="perl-modules.html" ?>
13
14 <sect1info>
15 <othername>$LastChangedBy$</othername>
16 <date>$Date$</date>
17 </sect1info>
18
19 <title>Perl Modules</title>
20
21 <indexterm zone="perl-modules">
22 <primary sortas="a-Perl-modules">Perl modules</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Perl Modules</title>
27
[10a2ee5]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>
[9ee1058]36
[428434e7]37 <!-- This section commented out now because the new organization of files
[bccbdaea]38 on the Anduin server do not include md5sums for the .tar.gz Perl
[428434e7]39 module sources
40
[9ee1058]41 <itemizedlist spacing="compact">
42 <listitem>
[4e82a189]43 <para>Download MD5 sums (HTTP):
[9ee1058]44 <ulink url="&perl_modules_md5sums_download_http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sums (FTP):
48 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
49 </listitem>
50 </itemizedlist>
51
[428434e7]52 -->
53
[47daa5a]54 <!-- Module::Info -->
[10a2ee5]55 <bridgehead renderas="sect3" id="perl-module-info"
56 xreflabel="Module::Info">The Module::Info Module</bridgehead>
[9ee1058]57
58 <indexterm zone="perl-modules perl-module-info">
59 <primary sortas="g-Module-Info">Module::Info</primary>
60 </indexterm>
61
[4e82a189]62 <para>One module in particular is shown first, as this module's usefulness
[10a2ee5]63 warrants installation, even though it won't be required by many other
64 modules. The Module::Info module can tell you if a particular module is
65 included in, or has been installed into your <application>Perl</application>
66 installation. Additionally, Module::Info can tell you what versions are
67 installed and what dependencies are required for them. You can even use
68 Module::Info to gather dependencies of uninstalled modules.</para>
[9ee1058]69
70 <itemizedlist spacing='compact'>
71 <listitem>
[4e82a189]72 <para><ulink
[5a9f4b0]73 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
[10a2ee5]74 Module-Info-&Module-Info-version;</ulink>
75 (<xref linkend="perl-standard-install"/>)</para>
[9ee1058]76 </listitem>
77 </itemizedlist>
78
[47daa5a]79 <!-- Test::Pod -->
[10a2ee5]80 <bridgehead renderas="sect3" id="perl-test-pod"
81 xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
82
83 <indexterm zone="perl-modules perl-test-pod">
84 <primary sortas="g-Test-Pod">Test::Pod</primary>
85 </indexterm>
86
87 <para>Another useful module, and one which is (typically optionally) used
88 by other modules during the build process is the Test:Pod module. This
89 module is used to check the validity of POD (Plain Old Documentation)
90 files. The Test::Pod module is typically included by module authors to
91 automatically find and check all POD files in a module distribution. This
92 module and all the dependencies can be installed using the
93 <xref linkend="perl-standard-install"/>.</para>
[9ee1058]94
95 <itemizedlist spacing='compact'>
96 <listitem>
[10a2ee5]97 <para><ulink
[5a9f4b0]98 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
[10a2ee5]99 Test-Pod-&Test-Pod-version;</ulink></para>
100
[9ee1058]101 <itemizedlist>
102 <listitem>
[10a2ee5]103 <para id="perl-pod-simple"><ulink
[5a9f4b0]104 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz">
[10a2ee5]105 Pod-Simple-&Pod-Simple-version;</ulink></para>
106 <indexterm zone="perl-modules perl-pod-simple">
107 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
[9ee1058]108 </indexterm>
[10a2ee5]109
110 <itemizedlist>
111 <listitem>
112 <para id="perl-pod-escapes"><ulink
[5a9f4b0]113 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
[10a2ee5]114 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
115 <indexterm zone="perl-modules perl-pod-escapes">
116 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
117 </indexterm>
118 </listitem>
119 </itemizedlist>
120
[9ee1058]121 </listitem>
122 <listitem>
[10a2ee5]123 <para id="perl-test-builder-tester"><ulink
[5a9f4b0]124 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
[10a2ee5]125 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
126 <indexterm zone="perl-modules perl-test-builder-tester">
127 <primary sortas="g-Test-Builder-Tester">
128 Test::Builder::Tester</primary>
[9ee1058]129 </indexterm>
[10a2ee5]130 </listitem>
131 </itemizedlist>
132
133 </listitem>
[bccbdaea]134 </itemizedlist>
[10a2ee5]135
[47daa5a]136 <!-- Module::Build -->
[10a2ee5]137 <bridgehead renderas="sect3" id="perl-module-build"
138 xreflabel="Module::Build">The Module::Build Module</bridgehead>
139
140 <indexterm zone="perl-modules perl-module-build">
141 <primary sortas="g-Module-Build">Module::Build</primary>
142 </indexterm>
143
144 <para>The Module::Build module is a system for building, testing, and
145 installing <application>Perl</application> modules. It is meant to be an
146 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
147 the module through subclassing in a much more straightforward way than with
148 MakeMaker. It also does not require a <command>make</command> command on
149 your system. Most of the Module::Build code is
150 pure-<application>Perl</application> and written in a very cross-platform
151 way.</para>
152
153 <para>The Module::Build module (as well as any other
154 <application>Perl</application> module that uses the Module::Build build
155 system) uses <xref linkend="perl-module-build-install"/>. All the
156 dependencies can be installed using the
157 <xref linkend="perl-standard-install"/>.</para>
158
159 <itemizedlist spacing='compact'>
160 <listitem>
161 <para><ulink
[5a9f4b0]162 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
[10a2ee5]163 Module-Build-&Module-Build-version;</ulink></para>
164
165 <itemizedlist>
166 <listitem>
167 <para id="perl-module-signature"><ulink
[5a9f4b0]168 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
[10a2ee5]169 Module-Signature-&Module-Signature-version;</ulink> (optional)</para>
170 <indexterm zone="perl-modules perl-module-signature">
171 <primary sortas="g-Module-Signature">Module::Signature</primary>
172 </indexterm>
173
[9ee1058]174 <itemizedlist>
175 <listitem>
[10a2ee5]176 <para id="perl-digest-sha"><ulink
[5a9f4b0]177 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
[10a2ee5]178 Digest-SHA-&Digest-SHA-version;</ulink></para>
179 <indexterm zone="perl-modules perl-digest-sha">
180 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
181 </indexterm>
182 </listitem>
183 <listitem>
184 <para id="perl-par-dist"><ulink
[5a9f4b0]185 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
[10a2ee5]186 PAR-Dist-&PAR-Dist-version;</ulink></para>
187 <indexterm zone="perl-modules perl-par-dist">
188 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
189 </indexterm>
190 </listitem>
191 <listitem>
192 <para><xref linkend="gnupg"/></para>
193 </listitem>
194 </itemizedlist>
195
196 </listitem>
197 <listitem>
198 <para id="perl-extutils-parsexs"><ulink
[5a9f4b0]199 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
[10a2ee5]200 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
201 <indexterm zone="perl-modules perl-extutils-parsexs">
202 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
203 </indexterm>
204
205 <itemizedlist>
206 <listitem>
207 <para id="perl-extutils-cbuilder"><ulink
[5a9f4b0]208 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
[10a2ee5]209 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
210 <indexterm zone="perl-modules perl-extutils-cbuilder">
211 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
212 </indexterm>
[9ee1058]213 </listitem>
214 </itemizedlist>
[10a2ee5]215
[9ee1058]216 </listitem>
217 <listitem>
[10a2ee5]218 <para id="perl-archive-tar"><ulink
[5a9f4b0]219 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
[10a2ee5]220 Archive-Tar-&Archive-Tar-version;</ulink></para>
221 <indexterm zone="perl-modules perl-archive-tar">
222 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
223 </indexterm>
224
225 <itemizedlist>
226 <listitem>
227 <para id="perl-io-zlib"><ulink
[5a9f4b0]228 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
[10a2ee5]229 IO-Zlib-&IO-Zlib-version;</ulink></para>
230 <indexterm zone="perl-modules perl-io-zlib">
231 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
232 </indexterm>
233
234 <itemizedlist>
235 <listitem>
[47daa5a]236 <para><xref linkend="perl-compress-zlib"/></para>
[10a2ee5]237 </listitem>
238 </itemizedlist>
239
240 </listitem>
241 <listitem>
242 <para><xref linkend="perl-test-pod"/></para>
243 </listitem>
[f1239573]244 <listitem>
245 <para id="perl-text-diff"><ulink
[5a9f4b0]246 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
[f1239573]247 Text-Diff-&Text-Diff-version;</ulink></para>
248 <indexterm zone="perl-modules perl-text-diff">
249 <primary sortas="g-Text-Diff">Text::Diff</primary>
250 </indexterm>
251
252 <itemizedlist>
253 <listitem>
254 <para id="perl-algorithm-diff"><ulink
[5a9f4b0]255 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
[f1239573]256 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
257 <indexterm zone="perl-modules perl-algorithm-diff">
258 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
259 </indexterm>
[47daa5a]260
261 <itemizedlist>
262 <listitem>
263 <para><xref linkend="unzip"/></para>
264 </listitem>
265 </itemizedlist>
266
[f1239573]267 </listitem>
268 </itemizedlist>
269
270 </listitem>
[10a2ee5]271 </itemizedlist>
272
273 </listitem>
274 <listitem>
275 <para id="perl-yaml"><ulink
[5a9f4b0]276 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
[10a2ee5]277 YAML-&YAML-version;</ulink></para>
278 <indexterm zone="perl-modules perl-yaml">
279 <primary sortas="g-YAML">YAML</primary>
280 </indexterm>
281 </listitem>
282 </itemizedlist>
283
284 </listitem>
285 </itemizedlist>
286
287 <bridgehead renderas="sect4" id="perl-module-build-install"
288 xreflabel="modified build instructions">Module::Build Build and
289 Installation Instructions</bridgehead>
290
291<screen><userinput>perl Build.PL &amp;&amp;
292./Build test</userinput></screen>
293
294 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
295
296<screen role='root'><userinput>./Build install</userinput></screen>
297
[47daa5a]298 <!-- Compress::Zlib -->
299 <bridgehead renderas="sect3" id="perl-compress-zlib"
300 xreflabel="Compress::Zlib">The Compress::Zlib Module</bridgehead>
301
302 <indexterm zone="perl-modules perl-compress-zlib">
303 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
304 </indexterm>
305
306 <para></para>
307
308 <note>
309 <para>The Compress::Zlib module requires the following
310 <command>sed</command> after untarring the distribution tarball (before
311 any other build commands) to use the system-installed copy of
312 <application>Zlib</application>.</para>
313
314<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
315 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \
316 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \
317 config.in</userinput></screen>
318 </note>
319
320 <itemizedlist spacing='compact'>
321 <listitem>
322 <para><ulink
323 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
324 Compress-Zlib-&Compress-Zlib-version;</ulink></para>
325 </listitem>
326 </itemizedlist>
327
328 <!-- HTML::Parser -->
[10a2ee5]329 <bridgehead renderas="sect3" id="perl-html-parser"
330 xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead>
331
332 <indexterm zone="perl-modules perl-html-parser">
333 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
334 </indexterm>
335
336 <para>The HTML::Parser distribution is a collection of modules that parse
337 and extract information from HTML documents. In order to use the included
338 HTML::HeadParser module, you will also need to install
339 <xref linkend="perl-lwp"/>. The two modules listed below can be installed
340 using the <application>Perl</application> Module
341 <xref linkend="perl-standard-install"/>.</para>
342
343 <itemizedlist spacing='compact'>
344 <listitem>
345 <para><ulink
[5a9f4b0]346 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
[10a2ee5]347 HTML-Parser-&HTML-Parser-version;</ulink></para>
348
349 <itemizedlist>
350 <listitem>
351 <para id="perl-html-tagset"><ulink
[5a9f4b0]352 url="http://cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
[10a2ee5]353 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
354 <indexterm zone="perl-modules perl-html-tagset">
355 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
356 </indexterm>
357 </listitem>
358 </itemizedlist>
359
360 </listitem>
361 </itemizedlist>
362
[47daa5a]363 <!-- XML::Parser -->
[10a2ee5]364 <bridgehead renderas="sect3" id="perl-xml-parser"
365 xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
366
367 <indexterm zone="perl-modules perl-xml-parser">
368 <primary sortas="g-XML-Parser">XML::Parser</primary>
369 </indexterm>
370
371 <para>The XML::Parser module is a <application>Perl</application> extension
372 interface to James Clark's XML parser,
373 <application>expat</application>. The module can be installed using the
374 <application>Perl</application> Module
375 <xref linkend="perl-standard-install"/>.</para>
376
377 <itemizedlist spacing='compact'>
378 <listitem>
379 <para><ulink
[5a9f4b0]380 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
[10a2ee5]381 XML-Parser-&XML-Parser-version;</ulink></para>
382
383 <itemizedlist>
384 <listitem>
385 <para><xref linkend="expat"/></para>
[9ee1058]386 </listitem>
387 </itemizedlist>
[10a2ee5]388
[9ee1058]389 </listitem>
[10a2ee5]390 </itemizedlist>
391
[47daa5a]392 <!-- SGMLSpm -->
[10a2ee5]393 <bridgehead renderas="sect3" id="perl-sgmlspm"
394 xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
395
396 <indexterm zone="perl-modules perl-sgmlspm">
397 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
398 </indexterm>
399
400 <para>The SGMLSpm module is a <application>Perl</application> library
401 used for parsing the output from James Clark's SGMLS and NSGMLS
402 parsers. This module requires modified installation instructions, shown
403 below.</para>
404
405 <itemizedlist spacing='compact'>
[9ee1058]406 <listitem>
[10a2ee5]407 <para><ulink
[5a9f4b0]408 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
[9ee1058]409 SGMLSpm-&SGMLSpm-version;</ulink></para>
410 </listitem>
[10a2ee5]411 </itemizedlist>
412
413 <para>If your system's <application>Perl</application> version is different
414 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
415 command below to reflect the version you have installed.</para>
416
417<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
418 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
419 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
420 Makefile</userinput></screen>
421
422 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
423
424<screen role="root"><userinput>make install &amp;&amp;
425install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
426make install_html &amp;&amp;
427rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
428install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
429
[47daa5a]430 <!-- Tk -->
[10a2ee5]431 <bridgehead renderas="sect3" id="perl-tk"
[ba4b31cf]432 xreflabel="Perl-Tk">The Tk Module</bridgehead>
[10a2ee5]433
434 <indexterm zone="perl-modules perl-tk">
435 <primary sortas="g-Tk">Tk</primary>
436 </indexterm>
437
[bccbdaea]438 <para>The <application>Tk</application> module is a
[10a2ee5]439 <application>Perl</application> interface to the
440 <application>Tk</application> package. The goal of this release is Unicode
441 support via <application>Perl</application>'s and
442 core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
443 builds and loads into a threaded <application>Perl</application> but is NOT
444 yet thread safe. The module can be installed using the
445 <application>Perl</application> Module
446 <xref linkend="perl-standard-install"/>.</para>
447
448 <itemizedlist spacing='compact'>
[9ee1058]449 <listitem>
[10a2ee5]450 <para><ulink
[5a9f4b0]451 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
[9ee1058]452 Tk-&Perl-Tk-version;</ulink></para>
[10a2ee5]453
[9ee1058]454 <itemizedlist>
455 <listitem>
456 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
457 </listitem>
458 </itemizedlist>
[10a2ee5]459
[9ee1058]460 </listitem>
[10a2ee5]461 </itemizedlist>
462
[47daa5a]463 <!-- Net::DNS -->
[10a2ee5]464 <bridgehead renderas="sect3" id="perl-net-dns"
465 xreflabel="Net-DNS">The Net::DNS Module</bridgehead>
466
467 <indexterm zone="perl-modules perl-net-dns">
468 <primary sortas="g-Net-DNS">Net::DNS</primary>
469 </indexterm>
470
471 <para>Net::DNS is a DNS resolver implemented in
472 <application>Perl</application>. It can be used to perform nearly any type
473 of DNS query from a <application>Perl</application> script. The Net::DNS
474 module and all its dependencies can be installed using the
475 <application>Perl</application> Module
476 <xref linkend="perl-standard-install"/>.</para>
477
478 <itemizedlist spacing='compact'>
[9ee1058]479 <listitem>
[10a2ee5]480 <para><ulink
[5a9f4b0]481 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
[9ee1058]482 Net-DNS-&Net-DNS-version;</ulink></para>
[10a2ee5]483
[9ee1058]484 <itemizedlist>
485 <listitem>
[4e82a189]486 <para id="perl-digest-hmac"><ulink
[5a9f4b0]487 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
[9ee1058]488 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
489 <indexterm zone="perl-modules perl-digest-hmac">
490 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
491 </indexterm>
[10a2ee5]492
[9ee1058]493 <itemizedlist>
494 <listitem>
[4e82a189]495 <para id="perl-digest-sha1"><ulink
[5a9f4b0]496 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
[9ee1058]497 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
498 <indexterm zone="perl-modules perl-digest-sha1">
499 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
500 </indexterm>
501 </listitem>
502 </itemizedlist>
[10a2ee5]503
504 </listitem>
505 <listitem>
506 <para id="perl-net-ip"><ulink
[5a9f4b0]507 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
[10a2ee5]508 Net-IP-&Net-IP-version;</ulink></para>
509 <indexterm zone="perl-modules perl-net-ip">
510 <primary sortas="g-Net-IP">Net::IP</primary>
511 </indexterm>
512 </listitem>
513 <listitem>
514 <para id="perl-io-socket-inet6"><ulink
[5a9f4b0]515 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
[10a2ee5]516 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
517 IPv6 support)</para>
518 <indexterm zone="perl-modules perl-io-socket-inet6">
519 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
520 </indexterm>
521
522 <itemizedlist>
523 <listitem>
524 <para id="perl-socket6"><ulink
[5a9f4b0]525 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
[10a2ee5]526 Socket6-&Socket6-version;</ulink></para>
527 <indexterm zone="perl-modules perl-socket6">
528 <primary sortas="g-Socket6">Socket6</primary>
529 </indexterm>
530 </listitem>
531 </itemizedlist>
532
533 </listitem>
534 <listitem>
535 <para id="perl-digest-bubblebabble"><ulink
[5a9f4b0]536 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
[10a2ee5]537 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
538 (optional, only used during the test suite)</para>
539 <indexterm zone="perl-modules perl-digest-bubblebabble">
540 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
541 </indexterm>
[9ee1058]542 </listitem>
543 </itemizedlist>
[10a2ee5]544
[9ee1058]545 </listitem>
[10a2ee5]546 </itemizedlist>
547
[47daa5a]548 <!-- LWP -->
[10a2ee5]549 <bridgehead renderas="sect3" id="perl-lwp"
550 xreflabel="LWP">The LWP Module</bridgehead>
551
552 <indexterm zone="perl-modules perl-lwp">
553 <primary sortas="g-LWP">LWP</primary>
554 </indexterm>
555
556 <para>The libwww-perl (LWP) collection is a set of
557 <application>Perl</application> modules which provides a simple and
558 consistent application programming interface to the World-Wide Web. The
559 main focus of the library is to provide classes and functions that allow
560 you to write WWW clients. The library also contains modules that are of
561 more general use and even classes that help you implement simple HTTP
562 servers. The LWP modules and all its <application>Perl</application>
563 module dependencies can be installed using the
564 <application>Perl</application> Module
565 <xref linkend="perl-standard-install"/>.</para>
566
567 <itemizedlist spacing='compact'>
[9ee1058]568 <listitem>
[10a2ee5]569 <para><ulink
[5a9f4b0]570 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
[9ee1058]571 LWP-&LWP-version;</ulink></para>
[10a2ee5]572
[9ee1058]573 <itemizedlist>
574 <listitem>
[4e82a189]575 <para id="perl-uri"><ulink
[5a9f4b0]576 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
[9ee1058]577 URI-&URI-version;</ulink></para>
578 <indexterm zone="perl-modules perl-uri">
579 <primary sortas="g-URI">URI</primary>
580 </indexterm>
[10a2ee5]581
[9ee1058]582 <itemizedlist>
583 <listitem>
[4e82a189]584 <para id="perl-business-isbn"><ulink
[5a9f4b0]585 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
[919683dc]586 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
[10a2ee5]587 used during the test suite)</para>
[9ee1058]588 <indexterm zone="perl-modules perl-business-isbn">
589 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
590 </indexterm>
[10a2ee5]591
[9ee1058]592 <itemizedlist>
593 <listitem>
[4e82a189]594 <para id="perl-business-isbn-data"><ulink
[5a9f4b0]595 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
[9ee1058]596 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
597 <indexterm zone="perl-modules perl-business-isbn-data">
598 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
599 </indexterm>
[10a2ee5]600
[9ee1058]601 <itemizedlist>
602 <listitem>
[10a2ee5]603 <para><xref linkend="perl-test-pod"/></para>
[9ee1058]604 </listitem>
605 <listitem>
[4e82a189]606 <para id="perl-test-prereq"><ulink
[5a9f4b0]607 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
[9ee1058]608 Test-Prereq-&Test-Prereq-version;</ulink></para>
609 <indexterm zone="perl-modules perl-test-prereq">
610 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
611 </indexterm>
[10a2ee5]612
[9ee1058]613 <itemizedlist>
614 <listitem>
[10a2ee5]615 <para><xref linkend="perl-module-info"/></para>
616 </listitem>
617 <listitem>
618 <para><xref linkend="perl-module-build"/> (optional)</para>
[9ee1058]619 </listitem>
620 <listitem>
[4e82a189]621 <para id="perl-module-corelist"><ulink
[5a9f4b0]622 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
[9ee1058]623 Module-CoreList-&Module-Corelist-version;</ulink></para>
624 <indexterm zone="perl-modules perl-module-corelist">
625 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
626 </indexterm>
627 </listitem>
628 </itemizedlist>
[10a2ee5]629
[9ee1058]630 </listitem>
631 </itemizedlist>
[10a2ee5]632
[9ee1058]633 </listitem>
634 </itemizedlist>
[10a2ee5]635
[9ee1058]636 </listitem>
637 </itemizedlist>
[10a2ee5]638
[9ee1058]639 </listitem>
640 <listitem>
[10a2ee5]641 <para><xref linkend="perl-html-parser"/></para>
[9ee1058]642 </listitem>
643 <listitem>
[47daa5a]644 <para><xref linkend="perl-compress-zlib"/></para>
[9ee1058]645 </listitem>
646 <listitem>
[4e82a189]647 <para id="perl-crypt-ssleay"><ulink
[5a9f4b0]648 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
[10a2ee5]649 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
650 support)</para>
[9ee1058]651 <indexterm zone="perl-modules perl-crypt-ssleay">
652 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
653 </indexterm>
[10a2ee5]654
655 <itemizedlist>
656 <listitem>
657 <para><xref linkend="openssl"/></para>
658 </listitem>
659 </itemizedlist>
660
[9ee1058]661 </listitem>
662 </itemizedlist>
[10a2ee5]663
[9ee1058]664 </listitem>
[10a2ee5]665 </itemizedlist>
666
[47daa5a]667 <!-- Date::Manip -->
[10a2ee5]668 <bridgehead renderas="sect3" id="perl-date-manip"
669 xreflabel="Date::Manip">The Date::Manip Module</bridgehead>
670
671 <indexterm zone="perl-modules perl-date-manip">
672 <primary sortas="g-Date-Manip">Date::Manip</primary>
673 </indexterm>
674
675 <para>Date::Manip is a set of routines designed to make any common
676 date/time manipulation easy to do. Operations such as comparing two times,
677 calculating a time a given amount of time from another, or parsing
678 international times are all easily done. From the very beginning, the
679 main focus of Date::Manip has been to be able to do ANY desired date/time
680 operation easily.</para>
681
682 <itemizedlist spacing='compact'>
[9ee1058]683 <listitem>
[10a2ee5]684 <para><ulink
[5a9f4b0]685 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
[10a2ee5]686 DateManip-&DateManip-version;</ulink>
687 (<xref linkend="perl-standard-install"/>)</para>
[9ee1058]688 </listitem>
[10a2ee5]689 </itemizedlist>
690
[47daa5a]691 <!-- Finance::Quote -->
[10a2ee5]692 <bridgehead renderas="sect3" id="perl-finance-quote"
693 xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead>
694
695 <indexterm zone="perl-modules perl-finance-quote">
696 <primary sortas="g-Finance-Quote">Finance::Quote</primary>
697 </indexterm>
698
699 <para>Finance::Quote is used to get stock quotes from various Internet
700 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
701 Stock Exchange. There are two methods of using this module &ndash; a
702 functional interface that is depreciated, and an object-orientated method
703 that provides greater flexibility and stability. With the exception of
704 straight currency exchange rates, all information is returned as a
705 two-dimensional hash (or a reference to such a hash, if called in a scalar
706 context).</para>
707
708 <para>After you've installed the package, issue
709 <command>perldoc Finance::Quote</command> for full information.
710 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
711 after unpacking the distribution tarball and changing into the top-level
712 directory. The module and dependencies can be installed using the
713 <application>Perl</application> module
714 <xref linkend="perl-standard-install"/>.</para>
715
716 <note>
[bccbdaea]717 <para>To run the regression test suite, you'll need to create a
[10a2ee5]718 symbolic link to the <filename class='directory'>test</filename>
719 directory using the following command after unpacking the tarball
720 and changing into the root directory of the sources:</para>
721
722<screen><userinput>ln -s test t</userinput></screen>
723
724 <para>Some tests will fail depending on certain conditions. See the
725 <filename>INSTALL</filename> file for full details.</para>
726 </note>
727
728 <itemizedlist spacing='compact'>
[9ee1058]729 <listitem>
[10a2ee5]730 <para><ulink
[5a9f4b0]731 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
[9ee1058]732 Finance-Quote-&Finance-Quote-version;</ulink></para>
[10a2ee5]733
[9ee1058]734 <itemizedlist>
735 <listitem>
[4e82a189]736 <para id="perl-html-tableextract"><ulink
[5a9f4b0]737 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
[9ee1058]738 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
739 <indexterm zone="perl-modules perl-html-tableextract">
740 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
741 </indexterm>
[10a2ee5]742
[4223eb5]743 <itemizedlist>
744 <listitem>
[10a2ee5]745 <para><xref linkend="perl-html-parser"/></para>
[4223eb5]746 </listitem>
747 </itemizedlist>
[10a2ee5]748
[4223eb5]749 </listitem>
750 <listitem>
[10a2ee5]751 <para><xref linkend="perl-lwp"/></para>
[9ee1058]752 </listitem>
753 </itemizedlist>
[10a2ee5]754
[9ee1058]755 </listitem>
756 </itemizedlist>
757
[47daa5a]758 <!-- Finance::QuoteHist -->
[b61a7a16]759 <bridgehead renderas="sect3" id="perl-finance-quotehist"
760 xreflabel="Finance::QuoteHist">The Finance::QuoteHist Module</bridgehead>
761
762 <indexterm zone="perl-modules perl-finance-quotehist">
763 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
764 </indexterm>
765
766 <para>The Finance::QuoteHist bundle is several modules designed to fetch
767 historical stock quotes from the web. The module and dependencies can be
768 installed using the <application>Perl</application> module
769 <xref linkend="perl-standard-install"/>.</para>
770
771 <itemizedlist spacing='compact'>
772 <listitem>
773 <para><ulink
[5a9f4b0]774 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
[b61a7a16]775 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
776
777 <itemizedlist>
778 <listitem>
779 <para><ulink
[5a9f4b0]780 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
[b61a7a16]781 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
782
783 <itemizedlist>
784 <listitem>
785 <para><xref linkend="perl-html-parser"/></para>
786 </listitem>
787 </itemizedlist>
788
789 </listitem>
790 <listitem>
791 <para><xref linkend="perl-lwp"/></para>
792 </listitem>
793 <listitem>
794 <para><xref linkend="perl-date-manip"/></para>
795 </listitem>
796 <listitem>
797 <para id="perl-text-csv_xs"><ulink
[5a9f4b0]798 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
[b61a7a16]799 Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
800 <indexterm zone="perl-modules perl-text-csv_xs">
801 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
802 </indexterm>
803 </listitem>
804 </itemizedlist>
805
806 </listitem>
807 </itemizedlist>
808
[47daa5a]809 <!-- Archive::Zip -->
[895dad28]810 <bridgehead renderas="sect3" id="perl-archive-zip"
811 xreflabel="Archive::Zip">The Archive::Zip Module</bridgehead>
812
813 <indexterm zone="perl-modules perl-archive-zip">
814 <primary sortas="g-Archive-Zip">Archive::Zip</primary>
815 </indexterm>
816
[bccbdaea]817 <para>The Archive::Zip module allows a <application>Perl</application>
818 program to create, manipulate, read, and write Zip archive files. The
819 two modules listed below can be installed using the
820 <application>Perl</application> module
[895dad28]821 <xref linkend="perl-standard-install"/>.</para>
822
823 <itemizedlist spacing='compact'>
824 <listitem>
825 <para><ulink
[5a9f4b0]826 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
[895dad28]827 Archive-Zip-&Archive-Zip-version;</ulink></para>
828
829 <itemizedlist>
830 <listitem>
[47daa5a]831 <para><xref linkend="perl-compress-zlib"/></para>
[895dad28]832 </listitem>
833 </itemizedlist>
834
835 </listitem>
836 </itemizedlist>
837
[9ee1058]838 </sect2>
839
[10a2ee5]840 <sect2 role="installation" id="perl-standard-install"
841 xreflabel="build and installation instructions">
842 <title>Standard Installation of Perl Modules</title>
[9ee1058]843
[10a2ee5]844 <para>Install <application>Perl</application> modules by running the
845 following commands:</para>
[9ee1058]846
847<screen><userinput>perl Makefile.PL &amp;&amp;
[52d29f7]848make &amp;&amp;
[9ee1058]849make test</userinput></screen>
[7fc4452]850
[9ee1058]851 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
[7fc4452]852
[9ee1058]853<screen role="root"><userinput>make install</userinput></screen>
[62c964d]854
[9ee1058]855 </sect2>
[bd23186f]856
[4e82a189]857 <sect2 role="installation">
[9ee1058]858 <title>(Alternate) Auto Installation of Perl Modules.</title>
[62c964d]859
[4e82a189]860 <para>There is an alternate way of installing the modules using
861 <application>Perl</application>'s built-in <command>install</command> command.
862 The command automatically downloads the source from the CPAN
863 archive, extracts it, runs the commands mentioned above, and removes the build
864 tree. You may still need to install dependent library packages before running
[9ee1058]865 the automated installation method.</para>
[62c964d]866
[4e82a189]867 <para>The first time you run this command, you'll be prompted to enter some
868 information regarding download locations and methods. This information is
869 retained in files located in <filename class='directory'>~/.cpan</filename>.
870 Start the perl shell with the following command as the
[9ee1058]871 <systemitem class="username">root</systemitem> user:</para>
[62c964d]872
[9ee1058]873<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
[62c964d]874
[9ee1058]875 <para>Each module may now be installed from this shell with the command:</para>
[62c964d]876
[9ee1058]877<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
[62c964d]878
[9ee1058]879 <para>For additional commands and help, type <command>help</command>.</para>
[3d60760]880
[10a2ee5]881 <para>Alternatively, for scripted or non-interactive installations, use the
882 following syntax as the
883 <systemitem class="username">root</systemitem> user:</para>
884
885<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
886
[9ee1058]887 </sect2>
[3d60760]888
[9ee1058]889</sect1>
Note: See TracBrowser for help on using the repository browser.