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
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 <!-- This section commented out now because the new organization of files
38 on the Anduin server do not include md5sums for the .tar.gz Perl
39 module sources
40
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download MD5 sums (HTTP):
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
52 -->
53
54 <!-- Module::Info -->
55 <bridgehead renderas="sect3" id="perl-module-info"
56 xreflabel="Module::Info">The Module::Info Module</bridgehead>
57
58 <indexterm zone="perl-modules perl-module-info">
59 <primary sortas="g-Module-Info">Module::Info</primary>
60 </indexterm>
61
62 <para>One module in particular is shown first, as this module's usefulness
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>
69
70 <itemizedlist spacing='compact'>
71 <listitem>
72 <para><ulink
73 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
74 Module-Info-&Module-Info-version;</ulink>
75 (<xref linkend="perl-standard-install"/>)</para>
76 </listitem>
77 </itemizedlist>
78
79 <!-- Test::Pod -->
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>
94
95 <itemizedlist spacing='compact'>
96 <listitem>
97 <para><ulink
98 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
99 Test-Pod-&Test-Pod-version;</ulink></para>
100
101 <itemizedlist>
102 <listitem>
103 <para id="perl-pod-simple"><ulink
104 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz">
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>
108 </indexterm>
109
110 <itemizedlist>
111 <listitem>
112 <para id="perl-pod-escapes"><ulink
113 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
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
121 </listitem>
122 <listitem>
123 <para id="perl-test-builder-tester"><ulink
124 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
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>
129 </indexterm>
130 </listitem>
131 </itemizedlist>
132
133 </listitem>
134 </itemizedlist>
135
136 <!-- Module::Build -->
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
162 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
163 Module-Build-&Module-Build-version;</ulink></para>
164
165 <itemizedlist>
166 <listitem>
167 <para id="perl-module-signature"><ulink
168 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
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
174 <itemizedlist>
175 <listitem>
176 <para id="perl-digest-sha"><ulink
177 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
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
185 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
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
199 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
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
208 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
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>
213 </listitem>
214 </itemizedlist>
215
216 </listitem>
217 <listitem>
218 <para id="perl-archive-tar"><ulink
219 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
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
228 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
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>
236 <para><xref linkend="perl-compress-zlib"/></para>
237 </listitem>
238 </itemizedlist>
239
240 </listitem>
241 <listitem>
242 <para><xref linkend="perl-test-pod"/></para>
243 </listitem>
244 <listitem>
245 <para id="perl-text-diff"><ulink
246 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
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
255 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
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>
260
261 <itemizedlist>
262 <listitem>
263 <para><xref linkend="unzip"/></para>
264 </listitem>
265 </itemizedlist>
266
267 </listitem>
268 </itemizedlist>
269
270 </listitem>
271 </itemizedlist>
272
273 </listitem>
274 <listitem>
275 <para id="perl-yaml"><ulink
276 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
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
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 -->
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
346 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
347 HTML-Parser-&HTML-Parser-version;</ulink></para>
348
349 <itemizedlist>
350 <listitem>
351 <para id="perl-html-tagset"><ulink
352 url="http://cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
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
363 <!-- XML::Parser -->
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
380 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
381 XML-Parser-&XML-Parser-version;</ulink></para>
382
383 <itemizedlist>
384 <listitem>
385 <para><xref linkend="expat"/></para>
386 </listitem>
387 </itemizedlist>
388
389 </listitem>
390 </itemizedlist>
391
392 <!-- SGMLSpm -->
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'>
406 <listitem>
407 <para><ulink
408 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
409 SGMLSpm-&SGMLSpm-version;</ulink></para>
410 </listitem>
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
430 <!-- Tk -->
431 <bridgehead renderas="sect3" id="perl-tk"
432 xreflabel="Perl-Tk">The Tk Module</bridgehead>
433
434 <indexterm zone="perl-modules perl-tk">
435 <primary sortas="g-Tk">Tk</primary>
436 </indexterm>
437
438 <para>The <application>Tk</application> module is a
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'>
449 <listitem>
450 <para><ulink
451 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
452 Tk-&Perl-Tk-version;</ulink></para>
453
454 <itemizedlist>
455 <listitem>
456 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
457 </listitem>
458 </itemizedlist>
459
460 </listitem>
461 </itemizedlist>
462
463 <!-- Net::DNS -->
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'>
479 <listitem>
480 <para><ulink
481 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
482 Net-DNS-&Net-DNS-version;</ulink></para>
483
484 <itemizedlist>
485 <listitem>
486 <para id="perl-digest-hmac"><ulink
487 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
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>
492
493 <itemizedlist>
494 <listitem>
495 <para id="perl-digest-sha1"><ulink
496 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
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>
503
504 </listitem>
505 <listitem>
506 <para id="perl-net-ip"><ulink
507 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
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
515 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
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
525 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
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
536 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
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>
542 </listitem>
543 </itemizedlist>
544
545 </listitem>
546 </itemizedlist>
547
548 <!-- LWP -->
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'>
568 <listitem>
569 <para><ulink
570 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
571 LWP-&LWP-version;</ulink></para>
572
573 <itemizedlist>
574 <listitem>
575 <para id="perl-uri"><ulink
576 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
577 URI-&URI-version;</ulink></para>
578 <indexterm zone="perl-modules perl-uri">
579 <primary sortas="g-URI">URI</primary>
580 </indexterm>
581
582 <itemizedlist>
583 <listitem>
584 <para id="perl-business-isbn"><ulink
585 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
586 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
587 used during the test suite)</para>
588 <indexterm zone="perl-modules perl-business-isbn">
589 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
590 </indexterm>
591
592 <itemizedlist>
593 <listitem>
594 <para id="perl-business-isbn-data"><ulink
595 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
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>
600
601 <itemizedlist>
602 <listitem>
603 <para><xref linkend="perl-test-pod"/></para>
604 </listitem>
605 <listitem>
606 <para id="perl-test-prereq"><ulink
607 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
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>
612
613 <itemizedlist>
614 <listitem>
615 <para><xref linkend="perl-module-info"/></para>
616 </listitem>
617 <listitem>
618 <para><xref linkend="perl-module-build"/> (optional)</para>
619 </listitem>
620 <listitem>
621 <para id="perl-module-corelist"><ulink
622 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
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>
629
630 </listitem>
631 </itemizedlist>
632
633 </listitem>
634 </itemizedlist>
635
636 </listitem>
637 </itemizedlist>
638
639 </listitem>
640 <listitem>
641 <para><xref linkend="perl-html-parser"/></para>
642 </listitem>
643 <listitem>
644 <para><xref linkend="perl-compress-zlib"/></para>
645 </listitem>
646 <listitem>
647 <para id="perl-crypt-ssleay"><ulink
648 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
649 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
650 support)</para>
651 <indexterm zone="perl-modules perl-crypt-ssleay">
652 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
653 </indexterm>
654
655 <itemizedlist>
656 <listitem>
657 <para><xref linkend="openssl"/></para>
658 </listitem>
659 </itemizedlist>
660
661 </listitem>
662 </itemizedlist>
663
664 </listitem>
665 </itemizedlist>
666
667 <!-- Date::Manip -->
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'>
683 <listitem>
684 <para><ulink
685 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
686 DateManip-&DateManip-version;</ulink>
687 (<xref linkend="perl-standard-install"/>)</para>
688 </listitem>
689 </itemizedlist>
690
691 <!-- Finance::Quote -->
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>
717 <para>To run the regression test suite, you'll need to create a
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'>
729 <listitem>
730 <para><ulink
731 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
732 Finance-Quote-&Finance-Quote-version;</ulink></para>
733
734 <itemizedlist>
735 <listitem>
736 <para id="perl-html-tableextract"><ulink
737 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
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>
742
743 <itemizedlist>
744 <listitem>
745 <para><xref linkend="perl-html-parser"/></para>
746 </listitem>
747 </itemizedlist>
748
749 </listitem>
750 <listitem>
751 <para><xref linkend="perl-lwp"/></para>
752 </listitem>
753 </itemizedlist>
754
755 </listitem>
756 </itemizedlist>
757
758 <!-- Finance::QuoteHist -->
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
774 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
775 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
776
777 <itemizedlist>
778 <listitem>
779 <para><ulink
780 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
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
798 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
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
809 <!-- Archive::Zip -->
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
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
821 <xref linkend="perl-standard-install"/>.</para>
822
823 <itemizedlist spacing='compact'>
824 <listitem>
825 <para><ulink
826 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
827 Archive-Zip-&Archive-Zip-version;</ulink></para>
828
829 <itemizedlist>
830 <listitem>
831 <para><xref linkend="perl-compress-zlib"/></para>
832 </listitem>
833 </itemizedlist>
834
835 </listitem>
836 </itemizedlist>
837
838 </sect2>
839
840 <sect2 role="installation" id="perl-standard-install"
841 xreflabel="build and installation instructions">
842 <title>Standard Installation of Perl Modules</title>
843
844 <para>Install <application>Perl</application> modules by running the
845 following commands:</para>
846
847<screen><userinput>perl Makefile.PL &amp;&amp;
848make &amp;&amp;
849make test</userinput></screen>
850
851 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
852
853<screen role="root"><userinput>make install</userinput></screen>
854
855 </sect2>
856
857 <sect2 role="installation">
858 <title>(Alternate) Auto Installation of Perl Modules.</title>
859
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
865 the automated installation method.</para>
866
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
871 <systemitem class="username">root</systemitem> user:</para>
872
873<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
874
875 <para>Each module may now be installed from this shell with the command:</para>
876
877<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
878
879 <para>For additional commands and help, type <command>help</command>.</para>
880
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
887 </sect2>
888
889</sect1>
Note: See TracBrowser for help on using the repository browser.