source: general/prog/perl-modules.xml@ 895dad28

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 895dad28 was 895dad28, checked in by DJ Lucas <dj@…>, 18 years ago

Added Archive::Zip to Perl Modules.

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