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

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

Added new Perl Modules to support icon-naming-utils: Tie::IxHash, XML::LibXML, XML::NamespaceSupport, XML::SAX, XML::SAX::Expat and XML::Simple

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6738 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 60.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY perl_modules_md5sums_download_http "&sources-anduin-http;/perl-modules/">
8 <!ENTITY perl_modules_md5sums_download_ftp "&sources-anduin-ftp;/perl-modules/">
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 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download MD5 sums (HTTP):
43 <ulink url="&perl_modules_md5sums_download_http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sums (FTP):
47 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
48 </listitem>
49 </itemizedlist>
50
51 <note>
52 <para>Some dependencies, such as the <xref linkend="perl-test-pod"/>
53 module, are used by several of the listed dependencies of the main
54 module and perhaps also the module being installed. Dependencies such as
55 this are only listed once in the dependency chain for each main module
56 (typically near the bottom-most dependency) to avoid redundancy and
57 additional clutter in the instructions.</para>
58 </note>
59
60 <!-- This is info for the Test::Builder::Tester module which may very well
61 be obsolete now. The packages that need it apparently also now need
62 Test::More-0.62 which is a core Perl module in an updated version. To
63 install the Test::More-0.62 version you must install the
64 Test::Simple-0.62 module which will overwrite the Perl core stuff.
65 The Test::Simple-0.62 module now includes the Test::Builder::Tester
66 module. Perl versions starting with Perl-5.9.x will have this module
67 include in the core at which time Test::Builder::Tester can be forever
68 removed from this page as it will then also be a core module.
69
70 <para id="perl-test-builder-tester"><ulink
71 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
72 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
73 <indexterm zone="perl-modules perl-test-builder-tester">
74 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
75 </indexterm>
76 -->
77
78 <!-- Archive::Zip -->
79 <bridgehead renderas="sect3" id="perl-archive-zip"
80 xreflabel="Archive::Zip-&Archive-Zip-version;">
81 Archive::Zip-&Archive-Zip-version;</bridgehead>
82
83 <indexterm zone="perl-modules perl-archive-zip">
84 <primary sortas="g-Archive-Zip">Archive::Zip</primary>
85 </indexterm>
86
87 <para>The Archive::Zip module allows a <application>Perl</application>
88 program to create, manipulate, read, and write Zip archive files. The
89 modules listed below are installed using the standard
90 <application>Perl</application> module
91 <xref linkend="perl-standard-install"/>.</para>
92
93 <itemizedlist spacing='compact'>
94 <listitem>
95 <para><ulink
96 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
97 Archive-Zip-&Archive-Zip-version;</ulink></para>
98
99 <itemizedlist>
100 <listitem>
101 <para><xref linkend="perl-compress-zlib"/></para>
102 </listitem>
103 <listitem>
104 <para><xref linkend="perl-test-pod"/>
105 (optionally used during the tests)</para>
106 </listitem>
107 </itemizedlist>
108
109 </listitem>
110 </itemizedlist>
111
112 <!-- Compress::Zlib -->
113 <bridgehead renderas="sect3" id="perl-compress-zlib"
114 xreflabel="Compress::Zlib-&Compress-Zlib-version;">
115 Compress::Zlib-&Compress-Zlib-version;</bridgehead>
116
117 <indexterm zone="perl-modules perl-compress-zlib">
118 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
119 </indexterm>
120
121 <para>The Compress::Zlib module provides a <application>Perl</application>
122 interface to the <application>Zlib</application> compression library. Most
123 of the functionality provided by <application>Zlib</application> is
124 available in Compress::Zlib. The module can be split into two general areas
125 of functionality, namely in-memory compression/decompression and read/write
126 access to gzip files. This module and all the dependencies are installed
127 using the standard <xref linkend="perl-standard-install"/>.</para>
128
129 <note>
130 <para>The Compress::Raw::Zlib module requires the following
131 <command>sed</command> after untarring the distribution tarball (before
132 any other build commands) to use the system-installed copy of
133 <application>Zlib</application>.</para>
134
135<screen><userinput>sed -i -e "s|BUILD_ZLIB\s*= True|BUILD_ZLIB = False|" \
136 -e "s|INCLUDE\s*= ./zlib-src|INCLUDE = /usr/include|" \
137 -e "s|LIB\s*= ./zlib-src|LIB = /usr/lib|" \
138 config.in</userinput></screen>
139 </note>
140
141 <itemizedlist spacing='compact'>
142 <listitem>
143 <para><ulink
144 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
145 Compress-Zlib-&Compress-Zlib-version;</ulink>
146 (uses the standard <xref linkend="perl-standard-install"/>)</para>
147
148 <itemizedlist>
149 <listitem>
150 <para><ulink
151 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Raw-Zlib-&Compress-Raw-Zlib-version;.tar.gz">
152 Compress-Raw-Zlib-&Compress-Raw-Zlib-version;</ulink></para>
153 </listitem>
154 <listitem>
155 <para><ulink
156 url="http://cpan.org/authors/id/P/PM/PMQS/IO-Compress-Zlib-&IO-Compress-Zlib-version;.tar.gz">
157 IO-Compress-Zlib-&IO-Compress-Zlib-version;</ulink></para>
158
159 <itemizedlist>
160 <listitem>
161 <para><ulink
162 url="http://cpan.org/authors/id/P/PM/PMQS/IO-Compress-Base-&IO-Compress-Base-version;.tar.gz">
163 IO-Compress-Base-&IO-Compress-Base-version;</ulink></para>
164 </listitem>
165 <listitem>
166 <para><ulink
167 url="http://cpan.org/authors/id/P/PM/PMQS/IO-Compress-Bzip2-&IO-Compress-Bzip2-version;.tar.gz">
168 IO-Compress-Bzip2-&IO-Compress-Bzip2-version;</ulink> (used during the tests)</para>
169 </listitem>
170 </itemizedlist>
171
172 </listitem>
173 </itemizedlist>
174
175 </listitem>
176 </itemizedlist>
177
178 <!-- Date::Manip -->
179 <bridgehead renderas="sect3" id="perl-date-manip"
180 xreflabel="Date::Manip-&DateManip-version;">
181 Date::Manip-&DateManip-version;</bridgehead>
182
183 <indexterm zone="perl-modules perl-date-manip">
184 <primary sortas="g-Date-Manip">Date::Manip</primary>
185 </indexterm>
186
187 <para>Date::Manip is a set of routines designed to make any common
188 date/time manipulation easy to do. Operations such as comparing two times,
189 calculating a time a given amount of time from another, or parsing
190 international times are all easily done. From the very beginning, the
191 main focus of Date::Manip has been to be able to do ANY desired date/time
192 operation easily.</para>
193
194 <itemizedlist spacing='compact'>
195 <listitem>
196 <para><ulink
197 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
198 DateManip-&DateManip-version;</ulink>
199 (uses the standard <xref linkend="perl-standard-install"/>)</para>
200 </listitem>
201 </itemizedlist>
202
203 <!-- Finance::Quote -->
204 <bridgehead renderas="sect3" id="perl-finance-quote"
205 xreflabel="Finance::Quote-&Finance-Quote-version;">
206 Finance::Quote-&Finance-Quote-version;</bridgehead>
207
208 <indexterm zone="perl-modules perl-finance-quote">
209 <primary sortas="g-Finance-Quote">Finance::Quote</primary>
210 </indexterm>
211
212 <para>Finance::Quote is used to get stock quotes from various Internet
213 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
214 Stock Exchange. There are two methods of using this module &ndash; a
215 functional interface that is depreciated, and an object-orientated method
216 that provides greater flexibility and stability. With the exception of
217 straight currency exchange rates, all information is returned as a
218 two-dimensional hash (or a reference to such a hash, if called in a scalar
219 context).</para>
220
221 <para>After you've installed the package, issue
222 <command>perldoc Finance::Quote</command> for full information.
223 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
224 after unpacking the distribution tarball and changing into the top-level
225 directory. The module and dependencies are installed using the
226 standard <application>Perl</application> module
227 <xref linkend="perl-standard-install"/>.</para>
228
229 <note>
230 <para>To run the regression test suite, you'll need a working Internet
231 connection and then create a symbolic link to the
232 <filename class='directory'>test</filename> directory using the following
233 command after unpacking the tarball and changing into the root directory
234 of the source tree:</para>
235
236<screen><userinput>ln -s test t</userinput></screen>
237
238 <para>Some tests will fail depending on certain conditions. See the
239 <filename>INSTALL</filename> file for full details.</para>
240 </note>
241
242 <itemizedlist spacing='compact'>
243 <listitem>
244 <para><ulink
245 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
246 Finance-Quote-&Finance-Quote-version;</ulink></para>
247
248 <itemizedlist>
249 <listitem>
250 <para><xref linkend="perl-html-tableextract"/></para>
251 </listitem>
252 <listitem>
253 <para><xref linkend="perl-lwp"/></para>
254 </listitem>
255 </itemizedlist>
256
257 </listitem>
258 </itemizedlist>
259
260 <!-- Finance::QuoteHist -->
261 <bridgehead renderas="sect3" id="perl-finance-quotehist"
262 xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
263 Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
264
265 <indexterm zone="perl-modules perl-finance-quotehist">
266 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
267 </indexterm>
268
269 <para>The Finance::QuoteHist bundle is several modules designed to fetch
270 historical stock quotes from the web. The module and dependencies are
271 installed using the standard <application>Perl</application> module
272 <xref linkend="perl-standard-install"/>.</para>
273
274 <itemizedlist spacing='compact'>
275 <listitem>
276 <para><ulink
277 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
278 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
279
280 <itemizedlist>
281 <listitem>
282 <para><xref linkend="perl-html-tableextract"/></para>
283 </listitem>
284 <listitem>
285 <para><xref linkend="perl-lwp"/></para>
286 </listitem>
287 <listitem>
288 <para><xref linkend="perl-date-manip"/></para>
289 </listitem>
290 <listitem>
291 <para id="perl-text-csv_pp"><ulink
292 url="http://cpan.org/authors/id/M/MA/MAKAMAKA/Text-CSV_PP-&Text-CSV_PP-version;.tar.gz">
293 Text-CSV_PP-&Text-CSV_PP-version;</ulink></para>
294 <indexterm zone="perl-modules perl-text-csv_pp">
295 <primary sortas="g-Text-CSV_PP">Text::CSV_PP</primary>
296 </indexterm>
297 </listitem>
298 <listitem>
299 <para id="perl-text-csv_xs"><ulink
300 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
301 Text-CSV_XS-&Text-CSV_XS-version; (optional)</ulink></para>
302 <indexterm zone="perl-modules perl-text-csv_xs">
303 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
304 </indexterm>
305 </listitem>
306 </itemizedlist>
307
308 </listitem>
309 </itemizedlist>
310
311 <!-- HTML::Parser -->
312 <bridgehead renderas="sect3" id="perl-html-parser"
313 xreflabel="HTML::Parser-&HTML-Parser-version;">
314 HTML::Parser-&HTML-Parser-version;</bridgehead>
315
316 <indexterm zone="perl-modules perl-html-parser">
317 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
318 </indexterm>
319
320 <para>The HTML::Parser distribution is a collection of modules that parse
321 and extract information from HTML documents. The modules listed below are
322 installed using the standard <application>Perl</application> module
323 <xref linkend="perl-standard-install"/>.</para>
324
325 <itemizedlist spacing='compact'>
326 <listitem>
327 <para><ulink
328 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
329 HTML-Parser-&HTML-Parser-version;</ulink></para>
330
331 <itemizedlist>
332 <listitem>
333 <para id="perl-html-tagset"><ulink
334 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
335 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
336 <indexterm zone="perl-modules perl-html-tagset">
337 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
338 </indexterm>
339
340 <itemizedlist>
341 <listitem>
342 <para><xref linkend="perl-test-pod"/>
343 (optionally used during the tests)</para>
344 </listitem>
345 </itemizedlist>
346
347 </listitem>
348 <listitem>
349 <para><xref linkend="perl-lwp"/> (run-time requirement for the
350 included HTML::HeadParser module)</para>
351 </listitem>
352 </itemizedlist>
353
354 </listitem>
355 </itemizedlist>
356
357 <!-- HTML::TableExtract -->
358 <bridgehead renderas="sect3" id="perl-html-tableextract"
359 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
360 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
361
362 <indexterm zone="perl-modules perl-html-tableextract">
363 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
364 </indexterm>
365
366 <para>HTML::TableExtract is a module that simplifies the extraction of the
367 content contained in tables within HTML documents, extracted either as
368 text or encoded element trees. Tables of note may be specified using
369 Headers, Depth, Count, Attributes, or some combination of the four. The
370 module and dependencies are installed using the standard
371 <application>Perl</application> module
372 <xref linkend="perl-standard-install"/>.</para>
373
374 <itemizedlist spacing='compact'>
375 <listitem>
376 <para><ulink
377 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
378 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
379
380 <itemizedlist>
381 <listitem>
382 <para id="perl-html-element-extended"><ulink
383 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-Element-Extended-&HTML-Element-Extended-version;.tar.gz">
384 HTML-Element-Extended-&HTML-Element-Extended-version;</ulink></para>
385 <indexterm zone="perl-modules perl-html-element-extended">
386 <primary sortas="g-HTML-Element-Extended">HTML::Element::Extended</primary>
387 </indexterm>
388
389 <itemizedlist>
390 <listitem>
391 <para id="perl-html-tree"><ulink
392 url="http://cpan.org/authors/id/P/PE/PETEK/HTML-Tree-&HTML-Tree-version;.tar.gz">
393 HTML-Tree-&HTML-Tree-version;</ulink></para>
394 <indexterm zone="perl-modules perl-html-tree">
395 <primary sortas="g-HTML-Tree">HTML::Tree</primary>
396 </indexterm>
397
398 <itemizedlist>
399 <listitem>
400 <para><xref linkend="perl-html-parser"/></para>
401 </listitem>
402 <listitem>
403 <para><xref linkend="perl-test-pod"/>
404 (optionally used during the tests)</para>
405 </listitem>
406 </itemizedlist>
407
408 </listitem>
409 </itemizedlist>
410
411 </listitem>
412 <listitem>
413 <para><xref linkend="perl-test-pod-coverage"/>
414 (optionally used during the tests)</para>
415 </listitem>
416 </itemizedlist>
417
418 </listitem>
419 </itemizedlist>
420
421 <!-- LWP -->
422 <bridgehead renderas="sect3" id="perl-lwp"
423 xreflabel="libwww-perl-&LWP-version;">
424 libwww-perl-&LWP-version; (a.k.a. LWP)</bridgehead>
425
426 <indexterm zone="perl-modules perl-lwp">
427 <primary sortas="g-libwww-perl">libwww-perl</primary>
428 </indexterm>
429
430 <para>The libwww-perl (LWP) collection is a set of
431 <application>Perl</application> modules which provide a simple and
432 consistent application programming interface to the World-Wide Web. The
433 main focus of the library is to provide classes and functions that allow
434 you to write WWW clients. The library also contains modules that are of
435 more general use and even classes that help you implement simple HTTP
436 servers. The LWP collection and all its <application>Perl</application>
437 module dependencies are installed using the standard
438 <application>Perl</application> module
439 <xref linkend="perl-standard-install"/>.</para>
440
441 <itemizedlist spacing='compact'>
442 <listitem>
443 <para><ulink
444 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
445 libwww-perl-&LWP-version;</ulink></para>
446
447 <itemizedlist>
448 <listitem>
449 <para id="perl-uri"><ulink
450 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
451 URI-&URI-version;</ulink></para>
452 <indexterm zone="perl-modules perl-uri">
453 <primary sortas="g-URI">URI</primary>
454 </indexterm>
455
456 <itemizedlist>
457 <listitem>
458 <para id="perl-business-isbn"><ulink
459 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
460 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
461 used during the test suite)</para>
462 <indexterm zone="perl-modules perl-business-isbn">
463 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
464 </indexterm>
465
466 <itemizedlist>
467 <listitem>
468 <para>LWP::Simple is required for many of the tests. This
469 is a circular dependency.</para>
470 </listitem>
471 <listitem>
472 <para id="perl-business-isbn-data"><ulink
473 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
474 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
475 <indexterm zone="perl-modules perl-business-isbn-data">
476 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
477 </indexterm>
478
479 <itemizedlist>
480 <listitem>
481 <para id="perl-test-prereq"><ulink
482 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
483 Test-Prereq-&Test-Prereq-version;</ulink> (you may need
484 to set up your CPAN access parameters by issuing the
485 command <command>perl -MCPAN -e shell</command> before
486 running the test suite, else the tests may hang)</para>
487 <indexterm zone="perl-modules perl-test-prereq">
488 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
489 </indexterm>
490
491 <itemizedlist>
492 <listitem>
493 <para><xref linkend="perl-module-info"/></para>
494 </listitem>
495 <listitem>
496 <para><xref linkend="perl-module-build"/> (optional)</para>
497 </listitem>
498 <listitem>
499 <para id="perl-module-corelist"><ulink
500 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
501 Module-CoreList-&Module-Corelist-version;</ulink></para>
502 <indexterm zone="perl-modules perl-module-corelist">
503 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
504 </indexterm>
505
506 <itemizedlist>
507 <listitem>
508 <para><xref linkend="perl-test-pod"/>
509 (optionally used during the tests)</para>
510 </listitem>
511 </itemizedlist>
512
513 </listitem>
514 </itemizedlist>
515
516 </listitem>
517 <listitem>
518 <para><xref linkend="perl-test-pod-coverage"/>
519 (optionally used during the tests)</para>
520 </listitem>
521 </itemizedlist>
522
523 </listitem>
524 </itemizedlist>
525
526 </listitem>
527 </itemizedlist>
528
529 </listitem>
530 <listitem>
531 <para><xref linkend="perl-html-parser"/></para>
532 </listitem>
533 <listitem>
534 <para><xref linkend="perl-compress-zlib"/></para>
535 </listitem>
536 <listitem>
537 <para id="perl-crypt-ssleay"><ulink
538 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
539 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
540 support)</para>
541 <indexterm zone="perl-modules perl-crypt-ssleay">
542 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
543 </indexterm>
544
545 <itemizedlist>
546 <listitem>
547 <para><xref linkend="openssl"/></para>
548 </listitem>
549 <listitem>
550 <para>A <quote>testcover</quote> <filename>Makefile</filename>
551 target is created (which creates a
552 <command>/usr/bin/testcover</command> script) if the <ulink
553 url="http://cpan.org/authors/id/S/SM/SMPETERS/ExtUtils-MakeMaker-Coverage-0.05.tar.gz">
554 Extutils::MakeMaker::Coverage</ulink> module is installed.</para>
555 </listitem>
556 </itemizedlist>
557
558 </listitem>
559 </itemizedlist>
560
561 </listitem>
562 </itemizedlist>
563
564 <!-- Module::Build -->
565 <bridgehead renderas="sect3" id="perl-module-build"
566 xreflabel="Module::Build-&Module-Build-version;">
567 Module::Build-&Module-Build-version;</bridgehead>
568
569 <indexterm zone="perl-modules perl-module-build">
570 <primary sortas="g-Module-Build">Module::Build</primary>
571 </indexterm>
572
573 <para>The Module::Build module is a system for building, testing, and
574 installing <application>Perl</application> modules. It is meant to be an
575 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
576 the module through subclassing in a much more straightforward way than with
577 MakeMaker. It also does not require a <command>make</command> command on
578 your system. Most of the Module::Build code is
579 pure-<application>Perl</application> and written in a very cross-platform
580 way.</para>
581
582 <para>The Module::Build module (as well as any other
583 <application>Perl</application> module that uses the Module::Build build
584 system) uses <xref linkend="perl-module-build-install"/>. All the
585 dependencies are installed using the standard
586 <application>Perl</application> module
587 <xref linkend="perl-standard-install"/>.</para>
588
589 <itemizedlist spacing='compact'>
590 <listitem>
591 <para><ulink
592 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
593 Module-Build-&Module-Build-version;</ulink></para>
594
595 <itemizedlist>
596 <listitem>
597 <para id="perl-extutils-parsexs"><ulink
598 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
599 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
600 <indexterm zone="perl-modules perl-extutils-parsexs">
601 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
602 </indexterm>
603
604 <itemizedlist>
605 <listitem>
606 <para id="perl-extutils-cbuilder"><ulink
607 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
608 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
609 <indexterm zone="perl-modules perl-extutils-cbuilder">
610 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
611 </indexterm>
612 </listitem>
613 </itemizedlist>
614
615 </listitem>
616 <listitem>
617 <para id="perl-archive-tar"><ulink
618 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
619 Archive-Tar-&Archive-Tar-version;</ulink></para>
620 <indexterm zone="perl-modules perl-archive-tar">
621 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
622 </indexterm>
623
624 <itemizedlist>
625 <listitem>
626 <para id="perl-io-zlib"><ulink
627 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
628 IO-Zlib-&IO-Zlib-version;</ulink></para>
629 <indexterm zone="perl-modules perl-io-zlib">
630 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
631 </indexterm>
632
633 <itemizedlist>
634 <listitem>
635 <para><xref linkend="perl-compress-zlib"/></para>
636 </listitem>
637 </itemizedlist>
638
639 </listitem>
640 <listitem>
641 <para><xref linkend="perl-text-diff"/></para>
642 </listitem>
643 </itemizedlist>
644
645 </listitem>
646 <listitem>
647 <para id="perl-pod-readme"><ulink
648 url="http://cpan.org/authors/id/R/RR/RRWO/Pod-Readme-&Pod-Readme-version;.tar.gz">
649 Pod-Readme-&Pod-Readme-version;</ulink> (optionally used to create
650 a <filename>README</filename> file when creating a new module
651 distribution)</para>
652 <indexterm zone="perl-modules perl-pod-readme">
653 <primary sortas="g-Pod-Readme">Pod::Readme</primary>
654 </indexterm>
655
656 <itemizedlist>
657 <listitem>
658 <para id="perl-test-portability-files"><ulink
659 url="http://cpan.org/authors/id/S/SA/SAPER/Test-Portability-Files-&Test-Portability-Files-version;.tar.gz">
660 Test-Portability-Files-&Test-Portability-Files-version;</ulink>
661 (optionally used during the tests)</para>
662 <indexterm zone="perl-modules perl-test-portability-files">
663 <primary sortas="g-Test-Portability-Files">Test::Portability::Files</primary>
664 </indexterm>
665 </listitem>
666 <listitem>
667 <para><xref linkend="perl-test-pod-coverage"/>
668 (optionally used during the tests)</para>
669 </listitem>
670 <listitem>
671 <para><xref linkend="perl-test-pod"/>
672 (optionally used during the tests)</para>
673 </listitem>
674 </itemizedlist>
675
676 </listitem>
677 <listitem>
678 <para><xref linkend="perl-module-signature"/> (required to use the
679 Module::Build <quote>distsign</quote> run-time method and
680 optionally used during the tests)</para>
681 </listitem>
682 <listitem>
683 <para><xref linkend="perl-yaml"/> (optional, provides additional
684 features to <application>Module::Build</application>)</para>
685 </listitem>
686 </itemizedlist>
687
688 </listitem>
689 </itemizedlist>
690
691 <bridgehead renderas="sect4" id="perl-module-build-install"
692 xreflabel="modified build instructions">Module::Build Build and
693 Installation Instructions</bridgehead>
694
695<screen><userinput>perl Build.PL &amp;&amp;
696./Build &amp;&amp;
697./Build test</userinput></screen>
698
699 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
700
701<screen role='root'><userinput>./Build install</userinput></screen>
702
703 <!-- Module::Info -->
704 <bridgehead renderas="sect3" id="perl-module-info"
705 xreflabel="Module::Info-&Module-Info-version;">
706 Module::Info-&Module-Info-version;</bridgehead>
707
708 <indexterm zone="perl-modules perl-module-info">
709 <primary sortas="g-Module-Info">Module::Info</primary>
710 </indexterm>
711
712 <para>The Module::Info module is quite useful for tasks other than just
713 support of other modules. It can be used from the command-line to tell you
714 if a particular module is included in, or has been installed into your
715 <application>Perl</application> installation. Additionally, Module::Info
716 can tell you what version of a module is installed and what dependencies
717 are required for it. You can even use Module::Info to gather dependencies
718 of uninstalled modules. The Module::Info module and dependencies install
719 using the standard <application>Perl</application> module
720 <xref linkend="perl-standard-install"/>.</para>
721
722 <itemizedlist spacing='compact'>
723 <listitem>
724 <para><ulink
725 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
726 Module-Info-&Module-Info-version;</ulink></para>
727
728 <itemizedlist>
729 <listitem>
730 <para id="perl-version-module"><ulink
731 url="http://cpan.org/authors/id/J/JP/JPEACOCK/version-&version-perl-version;.tar.gz">
732 version-&version-perl-version;</ulink>
733 (optionally used during the tests)</para>
734 <indexterm zone="perl-modules perl-version-module">
735 <primary sortas="g-version">version</primary>
736 </indexterm>
737
738 <itemizedlist>
739 <listitem>
740 <para><xref linkend="perl-module-build"/> (optional)</para>
741 </listitem>
742 </itemizedlist>
743
744 </listitem>
745 <listitem>
746 <para><xref linkend="perl-test-pod"/>
747 (optionally used during the tests)</para>
748 </listitem>
749 </itemizedlist>
750
751 </listitem>
752 </itemizedlist>
753
754 <!-- Module::Signature -->
755 <bridgehead renderas="sect3" id="perl-module-signature"
756 xreflabel="Module::Signature-&Module-Signature-version;">
757 Module::Signature-&Module-Signature-version;</bridgehead>
758
759 <indexterm zone="perl-modules perl-module-signature">
760 <primary sortas="g-Module-Signature">Module::Signature</primary>
761 </indexterm>
762
763 <para>The Module::Signature module is used to check and create
764 <filename>SIGNATURE</filename> files for CPAN distributions. After
765 installing Module::Signature you can verify the content of a distribution
766 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
767 the tarball, changing into the newly created directory and issuing the
768 command <command>cpansign -v</command>. It will check each file's
769 integrity, as well as the signature's validity. Note that some of the
770 dependencies appear to be circular, however, they are only run-time
771 conflicts and you should be able to fully utilize them as long as
772 everything is installed. Module::Signature and the dependency modules are
773 installed using the standard <application>Perl</application>
774 module <xref linkend="perl-standard-install"/>.</para>
775
776 <itemizedlist spacing='compact'>
777 <listitem>
778 <para><ulink
779 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
780 Module-Signature-&Module-Signature-version;</ulink></para>
781
782 <itemizedlist>
783 <listitem>
784 <para><xref linkend="perl-text-diff"/></para>
785 </listitem>
786 <listitem>
787 <para id="perl-par-dist"><ulink
788 url="http://cpan.org/authors/id/S/SM/SMUELLER/PAR-Dist-&PAR-Dist-version;.tar.gz">
789 PAR-Dist-&PAR-Dist-version;</ulink></para>
790 <indexterm zone="perl-modules perl-par-dist">
791 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
792 </indexterm>
793
794 <itemizedlist>
795 <listitem>
796 <para><xref linkend="perl-archive-zip"/></para>
797 </listitem>
798 <listitem>
799 <para><xref linkend="perl-lwp"/></para>
800 </listitem>
801 <listitem>
802 <para><xref linkend="perl-module-signature"/></para>
803 </listitem>
804 </itemizedlist>
805
806 </listitem>
807 <listitem>
808 <para id="perl-digest-sha"><ulink
809 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
810 Digest-SHA-&Digest-SHA-version;</ulink></para>
811 <indexterm zone="perl-modules perl-digest-sha">
812 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
813 </indexterm>
814
815 <itemizedlist>
816 <listitem>
817 <para><xref linkend="perl-test-pod-coverage"/>
818 (optionally used during the tests)</para>
819 </listitem>
820 </itemizedlist>
821
822 </listitem>
823 <listitem>
824 <para><xref linkend="gnupg"/></para>
825 </listitem>
826 </itemizedlist>
827
828 </listitem>
829 </itemizedlist>
830
831 <!-- Net::DNS -->
832 <bridgehead renderas="sect3" id="perl-net-dns"
833 xreflabel="Net-DNS-&Net-DNS-version;">
834 Net::DNS-&Net-DNS-version;</bridgehead>
835
836 <indexterm zone="perl-modules perl-net-dns">
837 <primary sortas="g-Net-DNS">Net::DNS</primary>
838 </indexterm>
839
840 <para>Net::DNS is a DNS resolver implemented in
841 <application>Perl</application>. It can be used to perform nearly any type
842 of DNS query from a <application>Perl</application> script. The Net::DNS
843 module and all its dependencies are installed using the standard
844 <application>Perl</application> module
845 <xref linkend="perl-standard-install"/>.</para>
846
847 <itemizedlist spacing='compact'>
848 <listitem>
849 <para><ulink
850 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
851 Net-DNS-&Net-DNS-version;</ulink></para>
852
853 <itemizedlist>
854 <listitem>
855 <para id="perl-digest-hmac"><ulink
856 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
857 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
858 <indexterm zone="perl-modules perl-digest-hmac">
859 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
860 </indexterm>
861
862 <itemizedlist>
863 <listitem>
864 <para id="perl-digest-sha1"><ulink
865 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
866 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
867 <indexterm zone="perl-modules perl-digest-sha1">
868 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
869 </indexterm>
870 </listitem>
871 </itemizedlist>
872
873 </listitem>
874 <listitem>
875 <para id="perl-net-ip"><ulink
876 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
877 Net-IP-&Net-IP-version;</ulink></para>
878 <indexterm zone="perl-modules perl-net-ip">
879 <primary sortas="g-Net-IP">Net::IP</primary>
880 </indexterm>
881 </listitem>
882 <listitem>
883 <para id="perl-io-socket-inet6"><ulink
884 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
885 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
886 IPv6 support)</para>
887 <indexterm zone="perl-modules perl-io-socket-inet6">
888 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
889 </indexterm>
890
891 <itemizedlist>
892 <listitem>
893 <para id="perl-socket6"><ulink
894 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
895 Socket6-&Socket6-version;</ulink></para>
896 <indexterm zone="perl-modules perl-socket6">
897 <primary sortas="g-Socket6">Socket6</primary>
898 </indexterm>
899 </listitem>
900 </itemizedlist>
901
902 </listitem>
903 <listitem>
904 <para id="perl-digest-bubblebabble"><ulink
905 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
906 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink></para>
907 <indexterm zone="perl-modules perl-digest-bubblebabble">
908 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
909 </indexterm>
910 </listitem>
911 <listitem>
912 <para><xref linkend="perl-test-pod"/> (optional, only used during the test suite)</para>
913 </listitem>
914 </itemizedlist>
915
916 </listitem>
917 </itemizedlist>
918
919
920 <!-- Pod::Coverage -->
921 <bridgehead renderas="sect3" id="perl-pod-coverage"
922 xreflabel="Pod::Coverage-&Pod-Coverage-version;">
923 Pod::Coverage-&Pod-Coverage-version;</bridgehead>
924
925 <indexterm zone="perl-modules perl-pod-coverage">
926 <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
927 </indexterm>
928
929 <para>The Pod::Coverage module is a <application>Perl</application> library
930 used to check if the documentation of a module is comprehensive. This
931 module can use the Module::Build
932 <xref linkend="perl-module-build-install"/>, but is not required. All the
933 dependencies are installed using the standard
934 <application>Perl</application> module
935 <xref linkend="perl-standard-install"/>.</para>
936
937 <itemizedlist spacing='compact'>
938 <listitem>
939 <para><ulink
940 url="http://cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-&Pod-Coverage-version;.tar.gz">
941 Pod-Coverage-&Pod-Coverage-version;</ulink></para>
942
943 <itemizedlist>
944 <listitem>
945 <para id="perl-devel-symdump"><ulink
946 url="http://cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
947 Devel-Symdump-&Devel-Symdump-version;</ulink></para>
948 <indexterm zone="perl-modules perl-devel-symdump">
949 <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
950 </indexterm>
951
952 <itemizedlist>
953 <listitem>
954 <para><xref linkend="perl-test-pod-coverage"/>
955 (optionally used during the tests, and is a circular
956 dependency)</para>
957 </listitem>
958 <listitem>
959 <para><xref linkend="perl-test-pod"/>
960 (optionally used during the tests)</para>
961 </listitem>
962 </itemizedlist>
963
964 </listitem>
965 <listitem>
966 <para><xref linkend="perl-module-build"/> (optional)</para>
967 </listitem>
968 </itemizedlist>
969
970 </listitem>
971 </itemizedlist>
972
973 <!-- SGMLSpm -->
974 <bridgehead renderas="sect3" id="perl-sgmlspm"
975 xreflabel="SGMLSpm-&SGMLSpm-version;">
976 SGMLSpm-&SGMLSpm-version;</bridgehead>
977
978 <indexterm zone="perl-modules perl-sgmlspm">
979 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
980 </indexterm>
981
982 <para>The SGMLSpm module is a <application>Perl</application> library
983 used for parsing the output from James Clark's SGMLS and NSGMLS
984 parsers. This module requires modified installation instructions, shown
985 below.</para>
986
987 <itemizedlist spacing='compact'>
988 <listitem>
989 <para><ulink
990 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
991 SGMLSpm-&SGMLSpm-version;</ulink></para>
992 </listitem>
993 </itemizedlist>
994
995 <para>If your system's <application>Perl</application> version is different
996 than &lfs-perl-version;, you'll need to modify the <command>sed</command>
997 command below to reflect the version you have installed.</para>
998
999<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
1000 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&lfs-perl-version;@" \
1001 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
1002 Makefile</userinput></screen>
1003
1004 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1005
1006<screen role="root"><userinput>make install &amp;&amp;
1007install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
1008make install_html &amp;&amp;
1009rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
1010install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
1011
1012 <!-- Test::Pod -->
1013 <bridgehead renderas="sect3" id="perl-test-pod"
1014 xreflabel="Test::Pod-&Test-Pod-version;">
1015 Test::Pod-&Test-Pod-version;</bridgehead>
1016
1017 <indexterm zone="perl-modules perl-test-pod">
1018 <primary sortas="g-Test-Pod">Test::Pod</primary>
1019 </indexterm>
1020
1021 <para>The Test:Pod module is (most of the time, optionally) used by other
1022 modules during the build process to check the validity of POD (Plain Old
1023 Documentation) files. The Test::Pod module is typically included by module
1024 authors to automatically find and check all POD files in a module
1025 distribution. This module and all the dependencies are installed using
1026 the standard <application>Perl</application> module
1027 <xref linkend="perl-standard-install"/>.</para>
1028
1029 <itemizedlist spacing='compact'>
1030 <listitem>
1031 <para><ulink
1032 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
1033 Test-Pod-&Test-Pod-version;</ulink></para>
1034
1035 <itemizedlist>
1036 <listitem>
1037 <para id="perl-pod-simple"><ulink
1038 url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
1039 Pod-Simple-&Pod-Simple-version;</ulink></para>
1040 <indexterm zone="perl-modules perl-pod-simple">
1041 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
1042 </indexterm>
1043
1044 <itemizedlist>
1045 <listitem>
1046 <para id="perl-pod-escapes"><ulink
1047 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
1048 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
1049 <indexterm zone="perl-modules perl-pod-escapes">
1050 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
1051 </indexterm>
1052 </listitem>
1053 </itemizedlist>
1054
1055 </listitem>
1056 <listitem>
1057 <para><xref linkend="perl-test-simple"/></para>
1058 </listitem>
1059 </itemizedlist>
1060
1061 </listitem>
1062 </itemizedlist>
1063
1064 <!-- Test::Pod::Coverage -->
1065 <bridgehead renderas="sect3" id="perl-test-pod-coverage"
1066 xreflabel="Test::Pod::Coverage-&Test-Pod-Coverage-version;">
1067 Test::Pod::Coverage-&Test-Pod-Coverage-version;</bridgehead>
1068
1069 <indexterm zone="perl-modules perl-test-pod-coverage">
1070 <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
1071 </indexterm>
1072
1073 <para>The Test::Pod::Coverage module is used to check files in a
1074 distribution for POD coverage. It is normally used by developers to
1075 ensure their projects are adequately covered with POD and it is also used
1076 in the test suites of many module distributions. This module and all the
1077 dependencies are installed using the standard
1078 <application>Perl</application> module
1079 <xref linkend="perl-standard-install"/>.</para>
1080
1081 <itemizedlist spacing='compact'>
1082 <listitem>
1083 <para><ulink
1084 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
1085 Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink></para>
1086
1087 <itemizedlist>
1088 <listitem>
1089 <para id="perl-test-builder-tester">
1090 <xref linkend="perl-test-simple"/> or
1091 <ulink
1092 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
1093 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
1094 <indexterm zone="perl-modules perl-test-builder-tester">
1095 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
1096 </indexterm>
1097 </listitem>
1098 <listitem>
1099 <para><xref linkend="perl-pod-coverage"/></para>
1100 </listitem>
1101 </itemizedlist>
1102
1103 </listitem>
1104 </itemizedlist>
1105
1106 <!-- Test::Simple -->
1107 <bridgehead renderas="sect3" id="perl-test-simple"
1108 xreflabel="Test::Simple-&Test-Simple-version;">
1109 Test::Simple-&Test-Simple-version;</bridgehead>
1110
1111 <indexterm zone="perl-modules perl-test-simple">
1112 <primary sortas="g-Test-Simple">Test::Simple</primary>
1113 </indexterm>
1114
1115 <para>The Test::Simple module contains utilities designed to assist
1116 developers in creating tests. A version of Test::Simple was installed
1117 during LFS with the <application>Perl</application>-&lfs-perl-version;
1118 installation, however, some of the sub-modules contained in Test::Simple
1119 have been updated (notably, the Test::More module) and these updated
1120 modules are now required by other modules. This updated version of
1121 Test::Simple also now includes the Test:Builder:Tester module, required by
1122 many of the modules on this page. Note that installing this updated
1123 version of Test::Simple will overwrite some files from the original
1124 <application>Perl</application> installation, but there's really nothing to
1125 be alarmed about as these modules are only used by developers creating
1126 tests, or for running the test suites during additional module
1127 installations.</para>
1128
1129 <itemizedlist spacing='compact'>
1130 <listitem>
1131 <para><ulink
1132 url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
1133 Test-Simple-&Test-Simple-version;</ulink>
1134 (uses the standard <xref linkend="perl-standard-install"/>)</para>
1135
1136 <itemizedlist>
1137 <listitem>
1138 <para><xref linkend="perl-module-signature"/>
1139 (optionally used during the tests)</para>
1140 </listitem>
1141 <listitem>
1142 <para><xref linkend="perl-test-pod-coverage"/>
1143 (optionally used during the tests, and is circular)</para>
1144 </listitem>
1145 <listitem>
1146 <para><xref linkend="perl-pod-coverage"/>
1147 (optionally used during the tests, and is circular)</para>
1148 </listitem>
1149 </itemizedlist>
1150
1151 </listitem>
1152 </itemizedlist>
1153
1154 <!-- Text::Diff -->
1155 <bridgehead renderas="sect3" id="perl-text-diff"
1156 xreflabel="Text::Diff-&Text-Diff-version;">
1157 Text::Diff-&Text-Diff-version;</bridgehead>
1158
1159 <indexterm zone="perl-modules perl-text-diff">
1160 <primary sortas="g-Text-Diff">Text::Diff</primary>
1161 </indexterm>
1162
1163 <para>Text::Diff is used to perform diffs on files and record sets. It
1164 provides a basic set of services akin to the GNU <command>diff</command>
1165 utility. It is not anywhere near as feature complete as GNU
1166 <command>diff</command>, but it is better integrated with
1167 <application>Perl</application> and available on all platforms. Text::Diff
1168 is often faster than shelling out to a system's <command>diff</command>
1169 executable for small files, and generally slower on larger files. The
1170 modules listed below are installed using the standard
1171 <application>Perl</application> module
1172 <xref linkend="perl-standard-install"/>.</para>
1173
1174 <itemizedlist spacing='compact'>
1175 <listitem>
1176 <para><ulink
1177 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
1178 Text-Diff-&Text-Diff-version;</ulink></para>
1179
1180 <itemizedlist>
1181 <listitem>
1182 <para id="perl-algorithm-diff"><ulink
1183 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
1184 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
1185 <indexterm zone="perl-modules perl-algorithm-diff">
1186 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
1187 </indexterm>
1188 </listitem>
1189 </itemizedlist>
1190
1191 </listitem>
1192 </itemizedlist>
1193
1194 <!-- Tk -->
1195 <bridgehead renderas="sect3" id="tk-perl"
1196 xreflabel="Tk-Perl-&Tk-Perl-version;">
1197 Tk-&Tk-Perl-version;</bridgehead>
1198
1199 <indexterm zone="perl-modules tk-perl">
1200 <primary sortas="g-Tk">Tk</primary>
1201 </indexterm>
1202
1203 <para>The <application>Tk</application> module is a
1204 <application>Perl</application> interface to the
1205 <application>Tk</application> package. The goal of this release is Unicode
1206 support via <application>Perl</application>'s and
1207 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
1208 builds and loads into a threaded <application>Perl</application> but is NOT
1209 yet thread safe. The module is installed using the standard
1210 <application>Perl</application> module
1211 <xref linkend="perl-standard-install"/>.</para>
1212
1213 <itemizedlist spacing='compact'>
1214 <listitem>
1215 <para><ulink
1216 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Tk-Perl-version;.tar.gz">
1217 Tk-&Tk-Perl-version;</ulink></para>
1218
1219 <itemizedlist>
1220 <listitem>
1221 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
1222 </listitem>
1223 </itemizedlist>
1224
1225 </listitem>
1226 </itemizedlist>
1227
1228 <!-- XML::Parser -->
1229 <bridgehead renderas="sect3" id="perl-xml-parser"
1230 xreflabel="XML::Parser-&XML-Parser-version;">
1231 XML::Parser-&XML-Parser-version;</bridgehead>
1232
1233 <indexterm zone="perl-modules perl-xml-parser">
1234 <primary sortas="g-XML-Parser">XML::Parser</primary>
1235 </indexterm>
1236
1237 <para>The XML::Parser module is a <application>Perl</application> extension
1238 interface to James Clark's XML parser,
1239 <application>expat</application>. The module is installed using the
1240 standard <application>Perl</application> module
1241 <xref linkend="perl-standard-install"/>.</para>
1242
1243 <itemizedlist spacing='compact'>
1244 <listitem>
1245 <para><ulink
1246 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
1247 XML-Parser-&XML-Parser-version;</ulink></para>
1248
1249 <itemizedlist>
1250 <listitem>
1251 <para><xref linkend="expat"/></para>
1252 </listitem>
1253 </itemizedlist>
1254 <itemizedlist>
1255 <listitem>
1256 <para><xref linkend="perl-lwp"/>
1257 (optionally used during the tests)</para>
1258 </listitem>
1259 </itemizedlist>
1260
1261 </listitem>
1262 </itemizedlist>
1263
1264 <!-- XML::Simple -->
1265 <bridgehead renderas="sect3" id="perl-xml-simple"
1266 xreflabel="XML::Simple-&XML-Simple-version;">
1267 XML::Simple-&XML-Simple-version;</bridgehead>
1268
1269 <indexterm zone="perl-modules perl-xml-simple">
1270 <primary sortas="g-XML-Simple">XML::Simple</primary>
1271 </indexterm>
1272
1273 <para>The XML::Simple module is a <application>Perl</application> extension
1274 that provides an easy API to read and write XML (especially config files).
1275 The module and all dependencies are installed using the standard
1276 <application>Perl</application> module
1277 <xref linkend="perl-standard-install"/>.</para>
1278
1279 <itemizedlist spacing='compact'>
1280 <listitem>
1281 <para><ulink
1282 url="http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">
1283 XML-Simple-&XML-Simple-version;</ulink></para>
1284
1285 <itemizedlist>
1286 <listitem>
1287 <para>One of the following four modules must be installed:</para>
1288
1289 <itemizedlist>
1290 <listitem>
1291 <para id="perl-xml-sax"><ulink
1292 url="http://cpan.org/authors/id/G/GR/GRANTM/XML-SAX-&XML-SAX-version;.tar.gz">
1293 XML-SAX-&XML-SAX-version;</ulink></para>
1294 <indexterm zone="perl-modules perl-xml-sax">
1295 <primary sortas="g-XML-SAX">XML::SAX</primary>
1296 </indexterm>
1297
1298 <itemizedlist>
1299 <listitem>
1300 <para id="perl-xml-namespacesupport"><ulink
1301 url="http://cpan.org/authors/id/R/RB/RBERJON/XML-NamespaceSupport-&XML-NamespaceSupport-version;.tar.gz">
1302 XML-NamespaceSupport-&XML-NamespaceSupport-version;</ulink></para>
1303 <indexterm zone="perl-modules perl-xml-namespacesupport">
1304 <primary sortas="g-XML-NamespaceSupport">XML::NamespaceSupport</primary>
1305 </indexterm>
1306 </listitem>
1307 </itemizedlist>
1308
1309 </listitem>
1310 <listitem>
1311 <para id="perl-xml-sax-expat"><ulink
1312 url="http://cpan.org/authors/id/B/BJ/BJOERN/XML-SAX-Expat-&XML-SAX-Expat-version;.tar.gz">
1313 XML-SAX-Expat-&XML-SAX-Expat-version;</ulink></para>
1314 <indexterm zone="perl-modules perl-xml-sax-expat">
1315 <primary sortas="g-XML-SAX-Expat">XML::SAX::Expat</primary>
1316 </indexterm>
1317 </listitem>
1318 <listitem>
1319 <para id="perl-xml-libxml"><ulink
1320 url="http://cpan.org/authors/id/P/PA/PAJAS/XML-LibXML-&XML-LibXML-version;.tar.gz">
1321 XML-LibXML-&XML-LibXML-version;</ulink></para>
1322 <indexterm zone="perl-modules perl-xml-libxml">
1323 <primary sortas="g-XML-LibXML">XML::LibXML</primary>
1324 </indexterm>
1325 </listitem>
1326 <listitem>
1327 <para><xref linkend="perl-xml-parser"/></para>
1328 </listitem>
1329 </itemizedlist>
1330
1331 </listitem>
1332 <listitem>
1333 <para id="perl-tie-ixhash"><ulink
1334 url="http://cpan.org/authors/id/G/GS/GSAR/Tie-IxHash-&Tie-IxHash-version;.tar.gz">
1335 Tie-IxHash-&Tie-IxHash-version;</ulink></para>
1336 <indexterm zone="perl-modules perl-tie-ixhash">
1337 <primary sortas="g-Tie-IxHash">Tie::IxHash</primary>
1338 </indexterm>
1339 </listitem>
1340 </itemizedlist>
1341
1342 </listitem>
1343 </itemizedlist>
1344
1345 <!-- YAML -->
1346 <bridgehead renderas="sect3" id="perl-yaml"
1347 xreflabel="YAML-&YAML-version;">
1348 YAML-&YAML-version;</bridgehead>
1349
1350 <indexterm zone="perl-modules perl-yaml">
1351 <primary sortas="g-YAML">YAML</primary>
1352 </indexterm>
1353
1354 <para>The <application>YAML</application> modules implement a
1355 <application>YAML</application> Loader and Dumper based on the
1356 <application>YAML</application> 1.0 specification
1357 <ulink url="http://www.yaml.org/spec/"/>.
1358 <application>YAML</application> is a generic data serialization language
1359 that is optimized for human readability. It can be used to express the data
1360 structures of most modern programming languages. The module and
1361 dependencies are installed using the standard
1362 <application>Perl</application> module
1363 <xref linkend="perl-standard-install"/>.</para>
1364
1365 <note>
1366 <para>The <application>YAML</application>,
1367 <application>Test::Base</application> and
1368 <application>Spiffy</application> modules will install UTF-8
1369 encoded manual pages. To modify the manual pages so that non-UTF-8
1370 encoded pages are installed, issue the following commands (before
1371 any other build commands):</para>
1372
1373<screen><literal>For <application>Spiffy</application>: <command>sed -i 's,\xc3\xb6,o,' lib/Spiffy.pm</command>
1374
1375For <application>Test::Base</application>: <command>sed -i 's,\xc3\xb6,o,' \
1376 lib/Test/Base{,/Filter}.pm \
1377 lib/Module/Install/TestBase.pm</command>
1378
1379For <application>YAML</application>: <command>sed -i 's,\xc3\xb6,o,' \
1380 ysh \
1381 lib{,/Test}/YAML.pm \
1382 lib/YAML/{Types,Node,Error,Marshall,Tag,Base}.pm \
1383 lib/YAML/{Loader,Dumper}{,/Base}.pm</command></literal></screen>
1384
1385 </note>
1386
1387 <itemizedlist spacing='compact'>
1388 <listitem>
1389 <para><ulink
1390 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1391 YAML-&YAML-version;</ulink></para>
1392
1393 <itemizedlist>
1394 <listitem>
1395 <para id="perl-test-base"><ulink
1396 url="http://cpan.org/authors/id/I/IN/INGY/Test-Base-&Test-Base-version;.tar.gz">
1397 Test-Base-&Test-Base-version;</ulink>
1398 (optionally used during the tests)</para>
1399 <indexterm zone="perl-modules perl-test-base">
1400 <primary sortas="g-Test-Base">Test::Base</primary>
1401 </indexterm>
1402
1403 <itemizedlist>
1404 <listitem>
1405 <para id="perl-spiffy"><ulink
1406 url="http://cpan.org/authors/id/I/IN/INGY/Spiffy-&Spiffy-version;.tar.gz">
1407 Spiffy-&Spiffy-version;</ulink></para>
1408 <indexterm zone="perl-modules perl-spiffy">
1409 <primary sortas="g-Spiffy">Spiffy</primary>
1410 </indexterm>
1411 </listitem>
1412 </itemizedlist>
1413
1414 </listitem>
1415 <listitem>
1416 <para><xref linkend="perl-text-diff"/>
1417 (optionally used during the tests)</para>
1418 </listitem>
1419 <listitem>
1420 <para><xref linkend="perl-test-simple"/>
1421 (optionally used during the tests)</para>
1422 </listitem>
1423 </itemizedlist>
1424
1425 </listitem>
1426 </itemizedlist>
1427
1428 </sect2>
1429
1430 <sect2 role="installation" id="perl-standard-install"
1431 xreflabel="build and installation instructions">
1432 <title>Standard Installation of Perl Modules</title>
1433
1434 <para>Install <application>Perl</application> modules by running the
1435 following commands:</para>
1436
1437<screen><userinput>perl Makefile.PL &amp;&amp;
1438make &amp;&amp;
1439make test</userinput></screen>
1440
1441 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1442
1443<screen role="root"><userinput>make install</userinput></screen>
1444
1445 </sect2>
1446
1447 <sect2 role="installation">
1448 <title>(Alternate) Auto Installation of Perl Modules.</title>
1449
1450 <para>There is an alternate way of installing the modules using the
1451 <command>cpan</command> shell <command>install</command> command. The
1452 command automatically downloads the source from the CPAN archive, extracts
1453 it, runs the compilation, testing and installation commands mentioned
1454 above, and removes the build source tree. You may still need to install
1455 dependent library packages before running the automated installation
1456 method.</para>
1457
1458 <para>The first time you run <command>cpan</command>, you'll be prompted
1459 to enter some information regarding download locations and methods. This
1460 information is retained in files located in
1461 <filename class='directory'>~/.cpan</filename>. Start the
1462 <command>cpan</command> shell by issuing '<command>cpan</command>' as the
1463 <systemitem class="username">root</systemitem> user. Any module may now be
1464 installed from the
1465 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1466 prompt with the command:</para>
1467
1468<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>
1469
1470 <para>For additional commands and help, issue '<command>help</command>'
1471 from the
1472 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1473 prompt.</para>
1474
1475 <para>Alternatively, for scripted or non-interactive installations, use the
1476 following syntax as the
1477 <systemitem class="username">root</systemitem> user to install one or more
1478 modules:</para>
1479
1480<screen role="root"><userinput>cpan -i <replaceable>&lt;Module1::Name&gt; &lt;Module2::Name&gt;</replaceable></userinput></screen>
1481
1482 <para>Review the <filename>cpan.1</filename> man page for additional
1483 parameters you can pass to <command>cpan</command> on the command
1484 line.</para>
1485
1486 </sect2>
1487
1488</sect1>
Note: See TracBrowser for help on using the repository browser.