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

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

Updated to Finance::Quote-1.11

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