source: general/prog/perl-modules.xml@ 5a9f4b0

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

Updated the CPAN URLs in the Perl Modules instructions

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