source: general/prog/perl-modules.xml@ 307b7b7a

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

Removed Perl Module Compress::Zlib as it is now a core module

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