source: general/prog/perl-modules.xml@ 10a2ee5

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.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 10a2ee5 was 10a2ee5, checked in by Randy McMurchy <randy@…>, 19 years ago

Complete overhaul of the Perl Modules; module version updates, new modules, additional dependencies, removal of obsolete modules, text rewrite and new layout

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