Context Navigation

perl-modules.xml@ ea804bc

Visit:

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

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

Updated several package's broken download URLs

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

Property mode set to 100644

File size: 61.4 KB

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

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

Context Navigation

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

Download in other formats: