source: general/prog/perl-modules.xml@ 8191bd1

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

Singled out the Text::Diff module in the Perl Modules instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5566 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 42.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY perl_modules_md5sums_download_http "http://anduin.linuxfromscratch.org/sources/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
8 <!ENTITY perl_modules_md5sums_download_ftp "ftp://anduin.linuxfromscratch.org/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
9]>
10
11<sect1 id="perl-modules" xreflabel="Perl modules">
12 <?dbhtml filename="perl-modules.html" ?>
13
14 <sect1info>
15 <othername>$LastChangedBy$</othername>
16 <date>$Date$</date>
17 </sect1info>
18
19 <title>Perl Modules</title>
20
21 <indexterm zone="perl-modules">
22 <primary sortas="a-Perl-modules">Perl modules</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Perl Modules</title>
27
28 <para>The <application>Perl</application> module packages add useful
29 objects to the <application>Perl</application> language. Modules utilized
30 by packages throughout BLFS are listed here, along with their dependencies.
31 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 standard
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-extutils-parsexs"><ulink
500 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
501 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
502 <indexterm zone="perl-modules perl-extutils-parsexs">
503 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
504 </indexterm>
505
506 <itemizedlist>
507 <listitem>
508 <para id="perl-extutils-cbuilder"><ulink
509 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
510 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
511 <indexterm zone="perl-modules perl-extutils-cbuilder">
512 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
513 </indexterm>
514 </listitem>
515 </itemizedlist>
516
517 </listitem>
518 <listitem>
519 <para id="perl-archive-tar"><ulink
520 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
521 Archive-Tar-&Archive-Tar-version;</ulink></para>
522 <indexterm zone="perl-modules perl-archive-tar">
523 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
524 </indexterm>
525
526 <itemizedlist>
527 <listitem>
528 <para id="perl-io-zlib"><ulink
529 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
530 IO-Zlib-&IO-Zlib-version;</ulink></para>
531 <indexterm zone="perl-modules perl-io-zlib">
532 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
533 </indexterm>
534
535 <itemizedlist>
536 <listitem>
537 <para><xref linkend="perl-compress-zlib"/></para>
538 </listitem>
539 </itemizedlist>
540
541 </listitem>
542 <listitem>
543 <para><xref linkend="perl-text-diff"/></para>
544 </listitem>
545 <listitem>
546 <para><xref linkend="perl-test-pod"/> (optionally used during
547 the tests)</para>
548 </listitem>
549 </itemizedlist>
550
551 </listitem>
552 <listitem>
553 <para><xref linkend="perl-module-signature"/> (optionally used
554 during the tests)</para>
555 </listitem>
556 <listitem>
557 <para><ulink
558 url="http://cpan.org/authors/id/I/IN/INGY/YAML-0.39.tar.gz">
559 YAML-0.39</ulink> (Optional- adds an addditional feature to
560 Module::Build. Note that this version of YAML is older than the
561 existing <xref linkend="perl-yaml"/> listed on this page. The newer
562 version is not compatible with this version of Module::Build.
563 Also note that you cannot have both YAML-0.39 and another version
564 exist together.)</para>
565 </listitem>
566 </itemizedlist>
567
568 </listitem>
569 </itemizedlist>
570
571 <bridgehead renderas="sect4" id="perl-module-build-install"
572 xreflabel="modified build instructions">Module::Build Build and
573 Installation Instructions</bridgehead>
574
575<screen><userinput>perl Build.PL &amp;&amp;
576./Build &amp;&amp;
577./Build test</userinput></screen>
578
579 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
580
581<screen role='root'><userinput>./Build install</userinput></screen>
582
583 <!-- Module::Info -->
584 <bridgehead renderas="sect3" id="perl-module-info"
585 xreflabel="Module::Info-&Module-Info-version;">
586 Module::Info-&Module-Info-version;</bridgehead>
587
588 <indexterm zone="perl-modules perl-module-info">
589 <primary sortas="g-Module-Info">Module::Info</primary>
590 </indexterm>
591
592 <para>The Module::Info module is quite useful for tasks other than just
593 support of other modules. It can be used from the command-line to tell you
594 if a particular module is included in, or has been installed into your
595 <application>Perl</application> installation. Additionally, Module::Info
596 can tell you what version of a module is installed and what dependencies
597 are required for it. You can even use Module::Info to gather dependencies
598 of uninstalled modules. The Module::Info module installs using the standard
599 <xref linkend="perl-standard-install"/>. The version module requires using
600 the Module::Build installation method.</para>
601
602 <itemizedlist spacing='compact'>
603 <listitem>
604 <para><ulink
605 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
606 Module-Info-&Module-Info-version;</ulink></para>
607
608 <itemizedlist>
609 <listitem>
610 <para id="perl-version-module"><ulink
611 url="http://cpan.org/authors/id/J/JP/JPEACOCK/version-&version-perl-version;.tar.gz">
612 version-&version-perl-version;</ulink>
613 (optionally used during the tests)</para>
614 <indexterm zone="perl-modules perl-version-module">
615 <primary sortas="g-version">version</primary>
616 </indexterm>
617
618 <itemizedlist>
619 <listitem>
620 <para><xref linkend="perl-module-build"/></para>
621 </listitem>
622 </itemizedlist>
623
624 </listitem>
625 <listitem>
626 <para><xref linkend="perl-test-pod"/>
627 (optionally used during the tests)</para>
628 </listitem>
629 </itemizedlist>
630
631 </listitem>
632 </itemizedlist>
633
634 <!-- Module::Signature -->
635 <bridgehead renderas="sect3" id="perl-module-signature"
636 xreflabel="Module::Signature-&Module-Signature-version;">
637 Module::Signature-&Module-Signature-version;</bridgehead>
638
639 <indexterm zone="perl-modules perl-module-signature">
640 <primary sortas="g-Module-Signature">Module::Signature</primary>
641 </indexterm>
642
643 <para>The Module::Signature module is used to check and create
644 <filename>SIGNATURE</filename> files for CPAN distributions. After
645 installing Module::Signature you can verify the content of a distribution
646 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
647 the tarball, changing into the newly created directory and issuing the
648 command <command>cpansign -v</command>. It will check each file's
649 integrity, as well as the signature's validity.</para>
650
651 <itemizedlist spacing='compact'>
652 <listitem>
653 <para><ulink
654 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
655 Module-Signature-&Module-Signature-version;</ulink></para>
656
657 <itemizedlist>
658 <listitem>
659 <para id="perl-digest-sha"><ulink
660 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
661 Digest-SHA-&Digest-SHA-version;</ulink></para>
662 <indexterm zone="perl-modules perl-digest-sha">
663 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
664 </indexterm>
665 </listitem>
666 <listitem>
667 <para id="perl-par-dist"><ulink
668 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
669 PAR-Dist-&PAR-Dist-version;</ulink></para>
670 <indexterm zone="perl-modules perl-par-dist">
671 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
672 </indexterm>
673 </listitem>
674 <listitem>
675 <para><xref linkend="gnupg"/></para>
676 </listitem>
677 </itemizedlist>
678
679 </listitem>
680 </itemizedlist>
681
682 <!-- Net::DNS -->
683 <bridgehead renderas="sect3" id="perl-net-dns"
684 xreflabel="Net-DNS-&Net-DNS-version;">
685 Net::DNS-&Net-DNS-version;</bridgehead>
686
687 <indexterm zone="perl-modules perl-net-dns">
688 <primary sortas="g-Net-DNS">Net::DNS</primary>
689 </indexterm>
690
691 <para>Net::DNS is a DNS resolver implemented in
692 <application>Perl</application>. It can be used to perform nearly any type
693 of DNS query from a <application>Perl</application> script. The Net::DNS
694 module and all its dependencies can be installed using the
695 <application>Perl</application> Module
696 <xref linkend="perl-standard-install"/>.</para>
697
698 <itemizedlist spacing='compact'>
699 <listitem>
700 <para><ulink
701 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
702 Net-DNS-&Net-DNS-version;</ulink></para>
703
704 <itemizedlist>
705 <listitem>
706 <para id="perl-digest-hmac"><ulink
707 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
708 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
709 <indexterm zone="perl-modules perl-digest-hmac">
710 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
711 </indexterm>
712
713 <itemizedlist>
714 <listitem>
715 <para id="perl-digest-sha1"><ulink
716 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
717 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
718 <indexterm zone="perl-modules perl-digest-sha1">
719 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
720 </indexterm>
721 </listitem>
722 </itemizedlist>
723
724 </listitem>
725 <listitem>
726 <para id="perl-net-ip"><ulink
727 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
728 Net-IP-&Net-IP-version;</ulink></para>
729 <indexterm zone="perl-modules perl-net-ip">
730 <primary sortas="g-Net-IP">Net::IP</primary>
731 </indexterm>
732 </listitem>
733 <listitem>
734 <para id="perl-io-socket-inet6"><ulink
735 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
736 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
737 IPv6 support)</para>
738 <indexterm zone="perl-modules perl-io-socket-inet6">
739 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
740 </indexterm>
741
742 <itemizedlist>
743 <listitem>
744 <para id="perl-socket6"><ulink
745 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
746 Socket6-&Socket6-version;</ulink></para>
747 <indexterm zone="perl-modules perl-socket6">
748 <primary sortas="g-Socket6">Socket6</primary>
749 </indexterm>
750 </listitem>
751 </itemizedlist>
752
753 </listitem>
754 <listitem>
755 <para id="perl-digest-bubblebabble"><ulink
756 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
757 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
758 (optional, only used during the test suite)</para>
759 <indexterm zone="perl-modules perl-digest-bubblebabble">
760 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
761 </indexterm>
762 </listitem>
763 </itemizedlist>
764
765 </listitem>
766 </itemizedlist>
767
768 <!-- SGMLSpm -->
769 <bridgehead renderas="sect3" id="perl-sgmlspm"
770 xreflabel="SGMLSpm-&SGMLSpm-version;">
771 SGMLSpm-&SGMLSpm-version;</bridgehead>
772
773 <indexterm zone="perl-modules perl-sgmlspm">
774 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
775 </indexterm>
776
777 <para>The SGMLSpm module is a <application>Perl</application> library
778 used for parsing the output from James Clark's SGMLS and NSGMLS
779 parsers. This module requires modified installation instructions, shown
780 below.</para>
781
782 <itemizedlist spacing='compact'>
783 <listitem>
784 <para><ulink
785 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
786 SGMLSpm-&SGMLSpm-version;</ulink></para>
787 </listitem>
788 </itemizedlist>
789
790 <para>If your system's <application>Perl</application> version is different
791 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
792 command below to reflect the version you have installed.</para>
793
794<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
795 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
796 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
797 Makefile</userinput></screen>
798
799 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
800
801<screen role="root"><userinput>make install &amp;&amp;
802install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
803make install_html &amp;&amp;
804rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
805install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
806
807 <!-- Test::Pod -->
808 <bridgehead renderas="sect3" id="perl-test-pod"
809 xreflabel="Test::Pod-&Test-Pod-version;">
810 Test::Pod-&Test-Pod-version;</bridgehead>
811
812 <indexterm zone="perl-modules perl-test-pod">
813 <primary sortas="g-Test-Pod">Test::Pod</primary>
814 </indexterm>
815
816 <para>The Test:Pod module is (most of the time, optionally) used by other
817 modules during the build process to check the validity of POD (Plain Old
818 Documentation) files. The Test::Pod module is typically included by module
819 authors to automatically find and check all POD files in a module
820 distribution. This module and all the dependencies can be installed using the
821 <xref linkend="perl-standard-install"/>.</para>
822
823 <itemizedlist spacing='compact'>
824 <listitem>
825 <para><ulink
826 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
827 Test-Pod-&Test-Pod-version;</ulink></para>
828
829 <itemizedlist>
830 <listitem>
831 <para id="perl-pod-simple"><ulink
832 url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
833 Pod-Simple-&Pod-Simple-version;</ulink></para>
834 <indexterm zone="perl-modules perl-pod-simple">
835 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
836 </indexterm>
837
838 <itemizedlist>
839 <listitem>
840 <para id="perl-pod-escapes"><ulink
841 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
842 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
843 <indexterm zone="perl-modules perl-pod-escapes">
844 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
845 </indexterm>
846 </listitem>
847 </itemizedlist>
848
849 </listitem>
850 <listitem>
851 <para><xref linkend="perl-test-simple"/></para>
852 </listitem>
853 </itemizedlist>
854
855 </listitem>
856 </itemizedlist>
857
858 <!-- Test::Simple -->
859 <bridgehead renderas="sect3" id="perl-test-simple"
860 xreflabel="Test::Simple-&Test-Simple-version;">
861 Test::Simple-&Test-Simple-version;</bridgehead>
862
863 <indexterm zone="perl-modules perl-test-simple">
864 <primary sortas="g-Test-Simple">Test::Simple</primary>
865 </indexterm>
866
867 <para>The Test::Simple module contains utilities designed to assist
868 developers in creating tests. A version of Test::Simple was installed
869 during LFS with the <application>Perl</application>-&LFS-Perl-version;
870 installation, however, some of the sub-modules contained in Test::Simple
871 have been updated (notably, the Test::More module) and these updated
872 modules are now required by other modules. This updated version of
873 Test::Simple also now includes the Test:Builder:Tester module, required by
874 many of the modules on this page. Note that installing this updated
875 version of Test::Simple will overwrite some files from the original
876 <application>Perl</application> installation, but there's really nothing to
877 be alarmed about as these modules are only used by developers creating
878 tests, or for running the test suites during additional module
879 installations.</para>
880
881 <itemizedlist spacing='compact'>
882 <listitem>
883 <para><ulink
884 url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
885 Test-Simple-&Test-Simple-version;</ulink>
886 (<xref linkend="perl-standard-install"/>)</para>
887 </listitem>
888 </itemizedlist>
889
890 <!-- Text::Diff -->
891 <bridgehead renderas="sect3" id="perl-text-diff"
892 xreflabel="Text::Diff-&Text-Diff-version;">
893 Text::Diff-&Text-Diff-version;</bridgehead>
894
895 <indexterm zone="perl-modules perl-text-diff">
896 <primary sortas="g-Text-Diff">Text::Diff</primary>
897 </indexterm>
898
899 <para>Text::Diff is used to perform diffs on files and record sets. It
900 provides a basic set of services akin to the GNU <command>diff</command>
901 utility. It is not anywhere near as feature complete as GNU
902 <command>diff</command>, but it is better integrated with
903 <application>Perl</application> and available on all platforms. Text::Diff
904 is often faster than shelling out to a system's <command>diff</command>
905 executable for small files, and generally slower on larger files.</para>
906
907 <itemizedlist spacing='compact'>
908 <listitem>
909 <para><ulink
910 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
911 Text-Diff-&Text-Diff-version;</ulink></para>
912
913 <itemizedlist>
914 <listitem>
915 <para id="perl-algorithm-diff"><ulink
916 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
917 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
918 <indexterm zone="perl-modules perl-algorithm-diff">
919 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
920 </indexterm>
921
922 <itemizedlist>
923 <listitem>
924 <para><xref linkend="unzip"/></para>
925 </listitem>
926 </itemizedlist>
927
928 </listitem>
929 </itemizedlist>
930
931 </listitem>
932 </itemizedlist>
933
934 <!-- Tk -->
935 <bridgehead renderas="sect3" id="tk-perl"
936 xreflabel="Tk-Perl-&Tk-Perl-version;">
937 Tk-&Tk-Perl-version;</bridgehead>
938
939 <indexterm zone="perl-modules tk-perl">
940 <primary sortas="g-Tk">Tk</primary>
941 </indexterm>
942
943 <para>The <application>Tk</application> module is a
944 <application>Perl</application> interface to the
945 <application>Tk</application> package. The goal of this release is Unicode
946 support via <application>Perl</application>'s and
947 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
948 builds and loads into a threaded <application>Perl</application> but is NOT
949 yet thread safe. The module can be installed using the
950 <application>Perl</application> Module
951 <xref linkend="perl-standard-install"/>.</para>
952
953 <itemizedlist spacing='compact'>
954 <listitem>
955 <para><ulink
956 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Tk-Perl-version;.tar.gz">
957 Tk-&Tk-Perl-version;</ulink></para>
958
959 <itemizedlist>
960 <listitem>
961 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
962 </listitem>
963 </itemizedlist>
964
965 </listitem>
966 </itemizedlist>
967
968 <!-- XML::Parser -->
969 <bridgehead renderas="sect3" id="perl-xml-parser"
970 xreflabel="XML::Parser-&XML-Parser-version;">
971 XML::Parser-&XML-Parser-version;</bridgehead>
972
973 <indexterm zone="perl-modules perl-xml-parser">
974 <primary sortas="g-XML-Parser">XML::Parser</primary>
975 </indexterm>
976
977 <para>The XML::Parser module is a <application>Perl</application> extension
978 interface to James Clark's XML parser,
979 <application>expat</application>. The module can be installed using the
980 <application>Perl</application> Module
981 <xref linkend="perl-standard-install"/>.</para>
982
983 <itemizedlist spacing='compact'>
984 <listitem>
985 <para><ulink
986 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
987 XML-Parser-&XML-Parser-version;</ulink></para>
988
989 <itemizedlist>
990 <listitem>
991 <para><xref linkend="expat"/></para>
992 </listitem>
993 </itemizedlist>
994
995 </listitem>
996 </itemizedlist>
997
998 <!-- YAML -->
999 <bridgehead renderas="sect3" id="perl-yaml"
1000 xreflabel="YAML-&YAML-version;">
1001 YAML-&YAML-version;</bridgehead>
1002
1003 <indexterm zone="perl-modules perl-yaml">
1004 <primary sortas="g-YAML">YAML</primary>
1005 </indexterm>
1006
1007 <para></para>
1008
1009 <itemizedlist spacing='compact'>
1010 <listitem>
1011 <para><ulink
1012 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1013 YAML-&YAML-version;</ulink></para>
1014
1015 <itemizedlist>
1016 <listitem>
1017 <para>Dependency list will be added</para>
1018 </listitem>
1019 </itemizedlist>
1020
1021 </listitem>
1022 </itemizedlist>
1023
1024 </sect2>
1025
1026 <sect2 role="installation" id="perl-standard-install"
1027 xreflabel="build and installation instructions">
1028 <title>Standard Installation of Perl Modules</title>
1029
1030 <para>Install <application>Perl</application> modules by running the
1031 following commands:</para>
1032
1033<screen><userinput>perl Makefile.PL &amp;&amp;
1034make &amp;&amp;
1035make test</userinput></screen>
1036
1037 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1038
1039<screen role="root"><userinput>make install</userinput></screen>
1040
1041 </sect2>
1042
1043 <sect2 role="installation">
1044 <title>(Alternate) Auto Installation of Perl Modules.</title>
1045
1046 <para>There is an alternate way of installing the modules using
1047 <application>Perl</application>'s built-in <command>install</command>
1048 command. The command automatically downloads the source from the CPAN
1049 archive, extracts it, runs the commands mentioned above, and removes the
1050 build source tree. You may still need to install dependent library
1051 packages before running the automated installation method.</para>
1052
1053 <para>The first time you run this command, you'll be prompted to enter some
1054 information regarding download locations and methods. This information is
1055 retained in files located in <filename class='directory'>~/.cpan</filename>.
1056 Start the perl shell with the following command as the
1057 <systemitem class="username">root</systemitem> user:</para>
1058
1059<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
1060
1061 <para>Each module may now be installed from this shell with the
1062 command:</para>
1063
1064<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
1065
1066 <para>For additional commands and help, type <command>help</command>.</para>
1067
1068 <para>Alternatively, for scripted or non-interactive installations, use the
1069 following syntax as the
1070 <systemitem class="username">root</systemitem> user:</para>
1071
1072<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
1073
1074 </sect2>
1075
1076</sect1>
Note: See TracBrowser for help on using the repository browser.