Context Navigation

perl-modules.xml@ f9a969ac

Visit:

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal

Last change on this file since f9a969ac was f9a969ac, checked in by Randy McMurchy <randy@…>, 13 years ago

Updated Perl module Test::Pod::Coverage dependencies, allowing the removal of Test::Simple from the Perl Modules page as it is now a core module

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8721 af4574ff-66df-0310-9fd7-8a98e5e911e0

Property mode set to 100644

File size: 57.5 KB

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

Note: See TracBrowser for help on using the repository browser.

Context Navigation

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

Download in other formats: