source: general/prog/perl-modules.xml@ f2981ec8

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

Updated to the YAML-0.50 Perl Module and provided a note in the Module::Build instructions about using an older version of YAML

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