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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since de91b35 was de91b35, checked in by Randy McMurchy <randy@…>, 18 years ago

Readded the links in the Perl Modules instructions to the MD5sums of all the Perl Module source tarballs

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