source: general/prog/perl-modules.xml@ 6894318f

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 6894318f was 6894318f, checked in by Randy McMurchy <randy@…>, 18 years ago

Updated to the HTML-Tagset-3.10 Perl Module

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5554 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 36.0 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>The Compress::Zlib module provides a <application>Perl</application>
307 interface to the <application>Zlib</application> compression library. Most
308 of the functionality provided by <application>Zlib</application> is
309 available in Compress::Zlib. The module can be split into two general areas
310 of functionality, namely in-memory compression/decompression and read/write
311 access to gzip files.</para>
312
313 <note>
314 <para>The Compress::Zlib module requires the following
315 <command>sed</command> after untarring the distribution tarball (before
316 any other build commands) to use the system-installed copy of
317 <application>Zlib</application>.</para>
318
319<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
320 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \
321 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \
322 config.in</userinput></screen>
323 </note>
324
325 <itemizedlist spacing='compact'>
326 <listitem>
327 <para><ulink
328 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
329 Compress-Zlib-&Compress-Zlib-version;</ulink>
330 (<xref linkend="perl-standard-install"/>)</para>
331 </listitem>
332 </itemizedlist>
333
334 <!-- HTML::Parser -->
335 <bridgehead renderas="sect3" id="perl-html-parser"
336 xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead>
337
338 <indexterm zone="perl-modules perl-html-parser">
339 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
340 </indexterm>
341
342 <para>The HTML::Parser distribution is a collection of modules that parse
343 and extract information from HTML documents. In order to use the included
344 HTML::HeadParser module, you will also need to install
345 <xref linkend="perl-lwp"/>. The two modules listed below can be installed
346 using the <application>Perl</application> Module
347 <xref linkend="perl-standard-install"/>.</para>
348
349 <itemizedlist spacing='compact'>
350 <listitem>
351 <para><ulink
352 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
353 HTML-Parser-&HTML-Parser-version;</ulink></para>
354
355 <itemizedlist>
356 <listitem>
357 <para id="perl-html-tagset"><ulink
358 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
359 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
360 <indexterm zone="perl-modules perl-html-tagset">
361 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
362 </indexterm>
363 </listitem>
364 </itemizedlist>
365
366 </listitem>
367 </itemizedlist>
368
369 <!-- HTML::TableExtract -->
370 <bridgehead renderas="sect3" id="perl-html-tableextract"
371 xreflabel="HTML::TableExtract">The HTML::TableExtract Module</bridgehead>
372
373 <indexterm zone="perl-modules perl-html-tableextract">
374 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
375 </indexterm>
376
377 <para></para>
378
379 <itemizedlist spacing='compact'>
380 <listitem>
381 <para><ulink
382 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
383 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
384
385 <itemizedlist>
386 <listitem>
387 <para><xref linkend="perl-html-parser"/></para>
388 </listitem>
389 </itemizedlist>
390
391 </listitem>
392 </itemizedlist>
393
394 <!-- XML::Parser -->
395 <bridgehead renderas="sect3" id="perl-xml-parser"
396 xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
397
398 <indexterm zone="perl-modules perl-xml-parser">
399 <primary sortas="g-XML-Parser">XML::Parser</primary>
400 </indexterm>
401
402 <para>The XML::Parser module is a <application>Perl</application> extension
403 interface to James Clark's XML parser,
404 <application>expat</application>. The module can be installed using the
405 <application>Perl</application> Module
406 <xref linkend="perl-standard-install"/>.</para>
407
408 <itemizedlist spacing='compact'>
409 <listitem>
410 <para><ulink
411 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
412 XML-Parser-&XML-Parser-version;</ulink></para>
413
414 <itemizedlist>
415 <listitem>
416 <para><xref linkend="expat"/></para>
417 </listitem>
418 </itemizedlist>
419
420 </listitem>
421 </itemizedlist>
422
423 <!-- SGMLSpm -->
424 <bridgehead renderas="sect3" id="perl-sgmlspm"
425 xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
426
427 <indexterm zone="perl-modules perl-sgmlspm">
428 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
429 </indexterm>
430
431 <para>The SGMLSpm module is a <application>Perl</application> library
432 used for parsing the output from James Clark's SGMLS and NSGMLS
433 parsers. This module requires modified installation instructions, shown
434 below.</para>
435
436 <itemizedlist spacing='compact'>
437 <listitem>
438 <para><ulink
439 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
440 SGMLSpm-&SGMLSpm-version;</ulink></para>
441 </listitem>
442 </itemizedlist>
443
444 <para>If your system's <application>Perl</application> version is different
445 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
446 command below to reflect the version you have installed.</para>
447
448<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
449 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
450 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
451 Makefile</userinput></screen>
452
453 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
454
455<screen role="root"><userinput>make install &amp;&amp;
456install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
457make install_html &amp;&amp;
458rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
459install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
460
461 <!-- Tk -->
462 <bridgehead renderas="sect3" id="perl-tk"
463 xreflabel="Perl-Tk">The Tk Module</bridgehead>
464
465 <indexterm zone="perl-modules perl-tk">
466 <primary sortas="g-Tk">Tk</primary>
467 </indexterm>
468
469 <para>The <application>Tk</application> module is a
470 <application>Perl</application> interface to the
471 <application>Tk</application> package. The goal of this release is Unicode
472 support via <application>Perl</application>'s and
473 core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
474 builds and loads into a threaded <application>Perl</application> but is NOT
475 yet thread safe. The module can be installed using the
476 <application>Perl</application> Module
477 <xref linkend="perl-standard-install"/>.</para>
478
479 <itemizedlist spacing='compact'>
480 <listitem>
481 <para><ulink
482 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
483 Tk-&Perl-Tk-version;</ulink></para>
484
485 <itemizedlist>
486 <listitem>
487 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
488 </listitem>
489 </itemizedlist>
490
491 </listitem>
492 </itemizedlist>
493
494 <!-- Net::DNS -->
495 <bridgehead renderas="sect3" id="perl-net-dns"
496 xreflabel="Net-DNS">The Net::DNS Module</bridgehead>
497
498 <indexterm zone="perl-modules perl-net-dns">
499 <primary sortas="g-Net-DNS">Net::DNS</primary>
500 </indexterm>
501
502 <para>Net::DNS is a DNS resolver implemented in
503 <application>Perl</application>. It can be used to perform nearly any type
504 of DNS query from a <application>Perl</application> script. The Net::DNS
505 module and all its dependencies can be installed using the
506 <application>Perl</application> Module
507 <xref linkend="perl-standard-install"/>.</para>
508
509 <itemizedlist spacing='compact'>
510 <listitem>
511 <para><ulink
512 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
513 Net-DNS-&Net-DNS-version;</ulink></para>
514
515 <itemizedlist>
516 <listitem>
517 <para id="perl-digest-hmac"><ulink
518 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
519 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
520 <indexterm zone="perl-modules perl-digest-hmac">
521 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
522 </indexterm>
523
524 <itemizedlist>
525 <listitem>
526 <para id="perl-digest-sha1"><ulink
527 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
528 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
529 <indexterm zone="perl-modules perl-digest-sha1">
530 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
531 </indexterm>
532 </listitem>
533 </itemizedlist>
534
535 </listitem>
536 <listitem>
537 <para id="perl-net-ip"><ulink
538 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
539 Net-IP-&Net-IP-version;</ulink></para>
540 <indexterm zone="perl-modules perl-net-ip">
541 <primary sortas="g-Net-IP">Net::IP</primary>
542 </indexterm>
543 </listitem>
544 <listitem>
545 <para id="perl-io-socket-inet6"><ulink
546 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
547 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
548 IPv6 support)</para>
549 <indexterm zone="perl-modules perl-io-socket-inet6">
550 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
551 </indexterm>
552
553 <itemizedlist>
554 <listitem>
555 <para id="perl-socket6"><ulink
556 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
557 Socket6-&Socket6-version;</ulink></para>
558 <indexterm zone="perl-modules perl-socket6">
559 <primary sortas="g-Socket6">Socket6</primary>
560 </indexterm>
561 </listitem>
562 </itemizedlist>
563
564 </listitem>
565 <listitem>
566 <para id="perl-digest-bubblebabble"><ulink
567 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
568 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
569 (optional, only used during the test suite)</para>
570 <indexterm zone="perl-modules perl-digest-bubblebabble">
571 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
572 </indexterm>
573 </listitem>
574 </itemizedlist>
575
576 </listitem>
577 </itemizedlist>
578
579 <!-- LWP -->
580 <bridgehead renderas="sect3" id="perl-lwp"
581 xreflabel="LWP">The LWP Module</bridgehead>
582
583 <indexterm zone="perl-modules perl-lwp">
584 <primary sortas="g-LWP">LWP</primary>
585 </indexterm>
586
587 <para>The libwww-perl (LWP) collection is a set of
588 <application>Perl</application> modules which provides a simple and
589 consistent application programming interface to the World-Wide Web. The
590 main focus of the library is to provide classes and functions that allow
591 you to write WWW clients. The library also contains modules that are of
592 more general use and even classes that help you implement simple HTTP
593 servers. The LWP modules and all its <application>Perl</application>
594 module dependencies can be installed using the
595 <application>Perl</application> Module
596 <xref linkend="perl-standard-install"/>.</para>
597
598 <itemizedlist spacing='compact'>
599 <listitem>
600 <para><ulink
601 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
602 LWP-&LWP-version;</ulink></para>
603
604 <itemizedlist>
605 <listitem>
606 <para id="perl-uri"><ulink
607 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
608 URI-&URI-version;</ulink></para>
609 <indexterm zone="perl-modules perl-uri">
610 <primary sortas="g-URI">URI</primary>
611 </indexterm>
612
613 <itemizedlist>
614 <listitem>
615 <para id="perl-business-isbn"><ulink
616 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
617 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
618 used during the test suite)</para>
619 <indexterm zone="perl-modules perl-business-isbn">
620 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
621 </indexterm>
622
623 <itemizedlist>
624 <listitem>
625 <para id="perl-business-isbn-data"><ulink
626 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
627 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
628 <indexterm zone="perl-modules perl-business-isbn-data">
629 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
630 </indexterm>
631
632 <itemizedlist>
633 <listitem>
634 <para><xref linkend="perl-test-pod"/></para>
635 </listitem>
636 <listitem>
637 <para id="perl-test-prereq"><ulink
638 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
639 Test-Prereq-&Test-Prereq-version;</ulink></para>
640 <indexterm zone="perl-modules perl-test-prereq">
641 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
642 </indexterm>
643
644 <itemizedlist>
645 <listitem>
646 <para><xref linkend="perl-module-info"/></para>
647 </listitem>
648 <listitem>
649 <para><xref linkend="perl-module-build"/> (optional)</para>
650 </listitem>
651 <listitem>
652 <para id="perl-module-corelist"><ulink
653 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
654 Module-CoreList-&Module-Corelist-version;</ulink></para>
655 <indexterm zone="perl-modules perl-module-corelist">
656 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
657 </indexterm>
658 </listitem>
659 </itemizedlist>
660
661 </listitem>
662 </itemizedlist>
663
664 </listitem>
665 </itemizedlist>
666
667 </listitem>
668 </itemizedlist>
669
670 </listitem>
671 <listitem>
672 <para><xref linkend="perl-html-parser"/></para>
673 </listitem>
674 <listitem>
675 <para><xref linkend="perl-compress-zlib"/></para>
676 </listitem>
677 <listitem>
678 <para id="perl-crypt-ssleay"><ulink
679 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
680 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
681 support)</para>
682 <indexterm zone="perl-modules perl-crypt-ssleay">
683 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
684 </indexterm>
685
686 <itemizedlist>
687 <listitem>
688 <para><xref linkend="openssl"/></para>
689 </listitem>
690 </itemizedlist>
691
692 </listitem>
693 </itemizedlist>
694
695 </listitem>
696 </itemizedlist>
697
698 <!-- Date::Manip -->
699 <bridgehead renderas="sect3" id="perl-date-manip"
700 xreflabel="Date::Manip">The Date::Manip Module</bridgehead>
701
702 <indexterm zone="perl-modules perl-date-manip">
703 <primary sortas="g-Date-Manip">Date::Manip</primary>
704 </indexterm>
705
706 <para>Date::Manip is a set of routines designed to make any common
707 date/time manipulation easy to do. Operations such as comparing two times,
708 calculating a time a given amount of time from another, or parsing
709 international times are all easily done. From the very beginning, the
710 main focus of Date::Manip has been to be able to do ANY desired date/time
711 operation easily.</para>
712
713 <itemizedlist spacing='compact'>
714 <listitem>
715 <para><ulink
716 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
717 DateManip-&DateManip-version;</ulink>
718 (<xref linkend="perl-standard-install"/>)</para>
719 </listitem>
720 </itemizedlist>
721
722 <!-- Finance::Quote -->
723 <bridgehead renderas="sect3" id="perl-finance-quote"
724 xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead>
725
726 <indexterm zone="perl-modules perl-finance-quote">
727 <primary sortas="g-Finance-Quote">Finance::Quote</primary>
728 </indexterm>
729
730 <para>Finance::Quote is used to get stock quotes from various Internet
731 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
732 Stock Exchange. There are two methods of using this module &ndash; a
733 functional interface that is depreciated, and an object-orientated method
734 that provides greater flexibility and stability. With the exception of
735 straight currency exchange rates, all information is returned as a
736 two-dimensional hash (or a reference to such a hash, if called in a scalar
737 context).</para>
738
739 <para>After you've installed the package, issue
740 <command>perldoc Finance::Quote</command> for full information.
741 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
742 after unpacking the distribution tarball and changing into the top-level
743 directory. The module and dependencies can be installed using the
744 <application>Perl</application> module
745 <xref linkend="perl-standard-install"/>.</para>
746
747 <note>
748 <para>To run the regression test suite, you'll need to create a
749 symbolic link to the <filename class='directory'>test</filename>
750 directory using the following command after unpacking the tarball
751 and changing into the root directory of the sources:</para>
752
753<screen><userinput>ln -s test t</userinput></screen>
754
755 <para>Some tests will fail depending on certain conditions. See the
756 <filename>INSTALL</filename> file for full details.</para>
757 </note>
758
759 <itemizedlist spacing='compact'>
760 <listitem>
761 <para><ulink
762 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
763 Finance-Quote-&Finance-Quote-version;</ulink></para>
764
765 <itemizedlist>
766 <listitem>
767 <para><xref linkend="perl-html-tableextract"/></para>
768 </listitem>
769 <listitem>
770 <para><xref linkend="perl-lwp"/></para>
771 </listitem>
772 </itemizedlist>
773
774 </listitem>
775 </itemizedlist>
776
777 <!-- Finance::QuoteHist -->
778 <bridgehead renderas="sect3" id="perl-finance-quotehist"
779 xreflabel="Finance::QuoteHist">The Finance::QuoteHist Module</bridgehead>
780
781 <indexterm zone="perl-modules perl-finance-quotehist">
782 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
783 </indexterm>
784
785 <para>The Finance::QuoteHist bundle is several modules designed to fetch
786 historical stock quotes from the web. The module and dependencies can be
787 installed using the <application>Perl</application> module
788 <xref linkend="perl-standard-install"/>.</para>
789
790 <itemizedlist spacing='compact'>
791 <listitem>
792 <para><ulink
793 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
794 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
795
796 <itemizedlist>
797 <listitem>
798 <para><xref linkend="perl-html-tableextract"/></para>
799 </listitem>
800 <listitem>
801 <para><xref linkend="perl-lwp"/></para>
802 </listitem>
803 <listitem>
804 <para><xref linkend="perl-date-manip"/></para>
805 </listitem>
806 <listitem>
807 <para id="perl-text-csv_xs"><ulink
808 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
809 Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
810 <indexterm zone="perl-modules perl-text-csv_xs">
811 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
812 </indexterm>
813 </listitem>
814 </itemizedlist>
815
816 </listitem>
817 </itemizedlist>
818
819 <!-- Archive::Zip -->
820 <bridgehead renderas="sect3" id="perl-archive-zip"
821 xreflabel="Archive::Zip">The Archive::Zip Module</bridgehead>
822
823 <indexterm zone="perl-modules perl-archive-zip">
824 <primary sortas="g-Archive-Zip">Archive::Zip</primary>
825 </indexterm>
826
827 <para>The Archive::Zip module allows a <application>Perl</application>
828 program to create, manipulate, read, and write Zip archive files. The
829 two modules listed below can be installed using the
830 <application>Perl</application> module
831 <xref linkend="perl-standard-install"/>.</para>
832
833 <itemizedlist spacing='compact'>
834 <listitem>
835 <para><ulink
836 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
837 Archive-Zip-&Archive-Zip-version;</ulink></para>
838
839 <itemizedlist>
840 <listitem>
841 <para><xref linkend="perl-compress-zlib"/></para>
842 </listitem>
843 </itemizedlist>
844
845 </listitem>
846 </itemizedlist>
847
848 </sect2>
849
850 <sect2 role="installation" id="perl-standard-install"
851 xreflabel="build and installation instructions">
852 <title>Standard Installation of Perl Modules</title>
853
854 <para>Install <application>Perl</application> modules by running the
855 following commands:</para>
856
857<screen><userinput>perl Makefile.PL &amp;&amp;
858make &amp;&amp;
859make test</userinput></screen>
860
861 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
862
863<screen role="root"><userinput>make install</userinput></screen>
864
865 </sect2>
866
867 <sect2 role="installation">
868 <title>(Alternate) Auto Installation of Perl Modules.</title>
869
870 <para>There is an alternate way of installing the modules using
871 <application>Perl</application>'s built-in <command>install</command> command.
872 The command automatically downloads the source from the CPAN
873 archive, extracts it, runs the commands mentioned above, and removes the build
874 tree. You may still need to install dependent library packages before running
875 the automated installation method.</para>
876
877 <para>The first time you run this command, you'll be prompted to enter some
878 information regarding download locations and methods. This information is
879 retained in files located in <filename class='directory'>~/.cpan</filename>.
880 Start the perl shell with the following command as the
881 <systemitem class="username">root</systemitem> user:</para>
882
883<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
884
885 <para>Each module may now be installed from this shell with the command:</para>
886
887<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
888
889 <para>For additional commands and help, type <command>help</command>.</para>
890
891 <para>Alternatively, for scripted or non-interactive installations, use the
892 following syntax as the
893 <systemitem class="username">root</systemitem> user:</para>
894
895<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
896
897 </sect2>
898
899</sect1>
Note: See TracBrowser for help on using the repository browser.