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

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

Updated to the ExtUtils::CBuilder-0.15 and ExtUtils::ParseXS-2.15 Perl Modules, also added optional dependencies to the Archive::Zip and HTML::Tagset Perl Modules instructions

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