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 |
|
---|
8 | <sect1 id="perl-modules" xreflabel="Perl Modules">
|
---|
9 | <?dbhtml filename="perl-modules.html" ?>
|
---|
10 |
|
---|
11 | <sect1info>
|
---|
12 | <date>$Date$</date>
|
---|
13 | </sect1info>
|
---|
14 |
|
---|
15 | <title>Perl Modules</title>
|
---|
16 |
|
---|
17 | <indexterm zone="perl-modules">
|
---|
18 | <primary sortas="a-perl-Modules">Perl Modules</primary>
|
---|
19 | </indexterm>
|
---|
20 |
|
---|
21 | <sect2 role="package">
|
---|
22 | <title>Introduction to Perl Modules</title>
|
---|
23 |
|
---|
24 | <!-- note for editors:
|
---|
25 | When testing the dependencies for a new/updated module, it is possible
|
---|
26 | to build the dependencies in a directory, then do DESTDIR installs.
|
---|
27 | For packages using Module::Build, supply \-\-destdir= (lower case!)
|
---|
28 | AFTER the command. Repeat as necessary. At any one time, ALL deps for
|
---|
29 | the module being tested need to be in the same DESTDIR - it may be
|
---|
30 | convenient to copy the contents, e.g.
|
---|
31 | cp -av MODULEA/usr/lib/perl5/site_perl/5.xx.y/* BATCH1/usr/lib/perl5/site_perl/5.xx.y/
|
---|
32 |
|
---|
33 | And then to use these deps (plus what is already installed),
|
---|
34 | export PERL5LIB=/ab/path/to/BATCH1/usr/lib/perl5/site_perl/5.xx.y
|
---|
35 |
|
---|
36 | Please be aware that not all non-core prerequisite deps are necessarily
|
---|
37 | needed. If 'use Foo::Bar' appears in one of the main files in lib/ or blib/
|
---|
38 | it is assumed to be needed. But if it only gets used in tests (t/) then
|
---|
39 | please try without it to see if the tests can still pass. -->
|
---|
40 |
|
---|
41 | <para>
|
---|
42 | The <application>Perl</application> module packages (also referred to as
|
---|
43 | Distributions, because each can contain multiple modules) add useful
|
---|
44 | objects to the <application>Perl</application> language. The packages
|
---|
45 | listed on this page are required or recommended for other packages in
|
---|
46 | the book. If they have dependent modules, those are either on this page
|
---|
47 | or else on the next page (<xref linkend="perl-deps"/>).
|
---|
48 | </para>
|
---|
49 |
|
---|
50 | <para>
|
---|
51 | In many cases, only the required or recommended dependencies are listed -
|
---|
52 | there might be other modules which allow more tests to be run, but
|
---|
53 | omitting them will still allow the tests to <literal>PASS</literal>.
|
---|
54 | </para>
|
---|
55 |
|
---|
56 | <para>
|
---|
57 | For a few modules, the BLFS editors have determined that other modules
|
---|
58 | still listed as prerequisites are not required, and omitted them.
|
---|
59 | </para>
|
---|
60 |
|
---|
61 | <para>
|
---|
62 | Where an alphabetically-earlier dependency of the same module pulls in a
|
---|
63 | dependency, it is not mentioned for the later dependencies of the same
|
---|
64 | module. You should build the listed dependencies in order.
|
---|
65 | </para>
|
---|
66 |
|
---|
67 | <para>
|
---|
68 | It is generally worth running the tests for perl modules, they often
|
---|
69 | can show problems such as missing dependencies which are required to
|
---|
70 | use the module. Here, the editors have attempted to separate those
|
---|
71 | dependencies which are only required for running testsuites, but they
|
---|
72 | will not be mentioned for a module where one of its dependencies uses
|
---|
73 | that module for its own testsuite. That is to say, if you intend to
|
---|
74 | run the testsuites, please run them for each dependency of the module.
|
---|
75 | </para>
|
---|
76 |
|
---|
77 | <para>
|
---|
78 | It is possible to automatically install the current versions of a module
|
---|
79 | and <emphasis>all</emphasis> missing or too-old dependencies
|
---|
80 | <emphasis>recommended by upstream</emphasis> using CPAN. See
|
---|
81 | <xref linkend="perl-alternatives"/> at the end of this page.
|
---|
82 | </para>
|
---|
83 |
|
---|
84 | <para>
|
---|
85 | Most of these modules only install files below <filename
|
---|
86 | class="directory">/usr/lib/perl5/site_perl/5.xx.y</filename> and those will
|
---|
87 | not be documented. One or two install programs (mostly, perl scripts), or
|
---|
88 | a library, into <filename class="directory">/usr/bin/</filename> or
|
---|
89 | <filename class="directory">/usr/lib/</filename> and these
|
---|
90 | <emphasis>are</emphasis> documented.
|
---|
91 | </para>
|
---|
92 |
|
---|
93 | <para condition="html" role="usernotes">User Notes:
|
---|
94 | <ulink url="&blfs-wiki;/perl-modules"/>
|
---|
95 | </para>
|
---|
96 |
|
---|
97 | <itemizedlist spacing="compact">
|
---|
98 | <listitem>
|
---|
99 | <para>
|
---|
100 | <xref linkend="perl-archive-zip"/>
|
---|
101 | </para>
|
---|
102 | </listitem>
|
---|
103 | <listitem>
|
---|
104 | <para>
|
---|
105 | <xref linkend="perl-autovivification"/>
|
---|
106 | </para>
|
---|
107 | </listitem>
|
---|
108 | <listitem>
|
---|
109 | <para>
|
---|
110 | <xref linkend="perl-business-isbn"/>
|
---|
111 | </para>
|
---|
112 | </listitem>
|
---|
113 | <listitem>
|
---|
114 | <para>
|
---|
115 | <xref linkend="perl-business-ismn"/>
|
---|
116 | </para>
|
---|
117 | </listitem>
|
---|
118 | <listitem>
|
---|
119 | <para>
|
---|
120 | <xref linkend="perl-business-issn"/>
|
---|
121 | </para>
|
---|
122 | </listitem>
|
---|
123 | <listitem>
|
---|
124 | <para>
|
---|
125 | <xref linkend="perl-class-accessor"/>
|
---|
126 | </para>
|
---|
127 | </listitem>
|
---|
128 | <listitem>
|
---|
129 | <para>
|
---|
130 | <xref linkend="perl-data-compare"/>
|
---|
131 | </para>
|
---|
132 | </listitem>
|
---|
133 | <listitem>
|
---|
134 | <para>
|
---|
135 | <xref linkend="perl-data-dump"/>
|
---|
136 | </para>
|
---|
137 | </listitem>
|
---|
138 | <listitem>
|
---|
139 | <para>
|
---|
140 | <xref linkend="perl-data-uniqid"/>
|
---|
141 | </para>
|
---|
142 | </listitem>
|
---|
143 | <listitem>
|
---|
144 | <para>
|
---|
145 | <xref linkend="perl-datetime-calendar-julian"/>
|
---|
146 | </para>
|
---|
147 | </listitem>
|
---|
148 | <listitem>
|
---|
149 | <para>
|
---|
150 | <xref linkend="perl-datetime-format-builder"/>
|
---|
151 | </para>
|
---|
152 | </listitem>
|
---|
153 | <listitem>
|
---|
154 | <para>
|
---|
155 | <xref linkend="perl-encode-eucjpascii"/>
|
---|
156 | </para>
|
---|
157 | </listitem>
|
---|
158 | <listitem>
|
---|
159 | <para>
|
---|
160 | <xref linkend="perl-encode-hanextra"/>
|
---|
161 | </para>
|
---|
162 | </listitem>
|
---|
163 | <listitem>
|
---|
164 | <para>
|
---|
165 | <xref linkend="perl-encode-jis2k"/>
|
---|
166 | </para>
|
---|
167 | </listitem>
|
---|
168 | <!--<listitem>
|
---|
169 | <para>
|
---|
170 | <xref linkend="perl-error"/>
|
---|
171 | </para>
|
---|
172 | </listitem>-->
|
---|
173 | <listitem>
|
---|
174 | <para>
|
---|
175 | <xref linkend="perl-file-slurper"/>
|
---|
176 | </para>
|
---|
177 | </listitem>
|
---|
178 | <listitem>
|
---|
179 | <para>
|
---|
180 | <xref linkend="perl-file-which"/>
|
---|
181 | </para>
|
---|
182 | </listitem>
|
---|
183 | <listitem>
|
---|
184 | <para>
|
---|
185 | <xref linkend="perl-html-parser"/>
|
---|
186 | </para>
|
---|
187 | </listitem>
|
---|
188 | <listitem>
|
---|
189 | <para>
|
---|
190 | <xref linkend="perl-http-daemon"/>
|
---|
191 | </para>
|
---|
192 | </listitem>
|
---|
193 | <listitem>
|
---|
194 | <para>
|
---|
195 | <xref linkend="perl-io-socket-ssl"/>
|
---|
196 | </para>
|
---|
197 | </listitem>
|
---|
198 | <listitem>
|
---|
199 | <para>
|
---|
200 | <xref linkend="perl-io-string"/>
|
---|
201 | </para>
|
---|
202 | </listitem>
|
---|
203 | <listitem>
|
---|
204 | <para>
|
---|
205 | <xref linkend="perl-ipc-run3"/>
|
---|
206 | </para>
|
---|
207 | </listitem>
|
---|
208 | <listitem>
|
---|
209 | <para>
|
---|
210 | <xref linkend="perl-json"/>
|
---|
211 | </para>
|
---|
212 | </listitem>
|
---|
213 | <listitem>
|
---|
214 | <para>
|
---|
215 | <xref linkend="perl-lingua-translit"/>
|
---|
216 | </para>
|
---|
217 | </listitem>
|
---|
218 | <listitem>
|
---|
219 | <para>
|
---|
220 | <xref linkend="perl-list-allutils"/>
|
---|
221 | </para>
|
---|
222 | </listitem>
|
---|
223 | <listitem>
|
---|
224 | <para>
|
---|
225 | <xref linkend="perl-list-moreutils"/>
|
---|
226 | </para>
|
---|
227 | </listitem>
|
---|
228 | <listitem>
|
---|
229 | <para>
|
---|
230 | <xref linkend="perl-log-log4perl"/>
|
---|
231 | </para>
|
---|
232 | </listitem>
|
---|
233 | <listitem>
|
---|
234 | <para>
|
---|
235 | <xref linkend="perl-lwp-protocol-https"/>
|
---|
236 | </para>
|
---|
237 | </listitem>
|
---|
238 | <listitem>
|
---|
239 | <para>
|
---|
240 | <xref linkend="perl-module-build"/>
|
---|
241 | </para>
|
---|
242 | </listitem>
|
---|
243 | <listitem>
|
---|
244 | <para>
|
---|
245 | <xref linkend="perl-net-dns"/>
|
---|
246 | </para>
|
---|
247 | </listitem>
|
---|
248 | <listitem>
|
---|
249 | <para>
|
---|
250 | <xref linkend="perl-parse-recdescent"/>
|
---|
251 | </para>
|
---|
252 | </listitem>
|
---|
253 | <listitem>
|
---|
254 | <para>
|
---|
255 | <xref linkend="perl-parse-yapp"/>
|
---|
256 | </para>
|
---|
257 | </listitem>
|
---|
258 | <listitem>
|
---|
259 | <para>
|
---|
260 | <xref linkend="perl-perlio-utf8_strict"/>
|
---|
261 | </para>
|
---|
262 | </listitem>
|
---|
263 | <listitem>
|
---|
264 | <para>
|
---|
265 | <xref linkend="perl-regexp-common"/>
|
---|
266 | </para>
|
---|
267 | </listitem>
|
---|
268 | <listitem>
|
---|
269 | <para>
|
---|
270 | <xref linkend="perl-sgmlspm"/>
|
---|
271 | </para>
|
---|
272 | </listitem>
|
---|
273 | <listitem>
|
---|
274 | <para>
|
---|
275 | <xref linkend="perl-sort-key"/>
|
---|
276 | </para>
|
---|
277 | </listitem>
|
---|
278 | <listitem>
|
---|
279 | <para>
|
---|
280 | <xref linkend="perl-test-command"/>
|
---|
281 | </para>
|
---|
282 | </listitem>
|
---|
283 | <listitem>
|
---|
284 | <para>
|
---|
285 | <xref linkend="perl-test-differences"/>
|
---|
286 | </para>
|
---|
287 | </listitem>
|
---|
288 | <listitem>
|
---|
289 | <para>
|
---|
290 | <xref linkend="perl-text-bibtex"/>
|
---|
291 | </para>
|
---|
292 | </listitem>
|
---|
293 | <listitem>
|
---|
294 | <para>
|
---|
295 | <xref linkend="perl-text-csv"/>
|
---|
296 | </para>
|
---|
297 | </listitem>
|
---|
298 | <listitem>
|
---|
299 | <para>
|
---|
300 | <xref linkend="perl-text-roman"/>
|
---|
301 | </para>
|
---|
302 | </listitem>
|
---|
303 | <listitem>
|
---|
304 | <para>
|
---|
305 | <xref linkend="perl-unicode-collate"/>
|
---|
306 | </para>
|
---|
307 | </listitem>
|
---|
308 | <listitem>
|
---|
309 | <para>
|
---|
310 | <xref linkend="perl-unicode-linebreak"/>
|
---|
311 | </para>
|
---|
312 | </listitem>
|
---|
313 | <listitem>
|
---|
314 | <para>
|
---|
315 | <xref linkend="perl-uri"/>
|
---|
316 | </para>
|
---|
317 | </listitem>
|
---|
318 | <listitem>
|
---|
319 | <para>
|
---|
320 | <xref linkend="perl-xml-libxml-simple"/>
|
---|
321 | </para>
|
---|
322 | </listitem>
|
---|
323 | <listitem>
|
---|
324 | <para>
|
---|
325 | <xref linkend="perl-xml-libxslt"/>
|
---|
326 | </para>
|
---|
327 | </listitem>
|
---|
328 | <listitem>
|
---|
329 | <para>
|
---|
330 | <xref linkend="perl-xml-simple"/>
|
---|
331 | </para>
|
---|
332 | </listitem>
|
---|
333 | <listitem>
|
---|
334 | <para>
|
---|
335 | <xref linkend="perl-xml-writer"/>
|
---|
336 | </para>
|
---|
337 | </listitem>
|
---|
338 | <!-- alternative cpan installation stays at the end -->
|
---|
339 | <listitem>
|
---|
340 | <para>
|
---|
341 | <xref linkend="perl-alternatives"/>
|
---|
342 | </para>
|
---|
343 | </listitem>
|
---|
344 | </itemizedlist>
|
---|
345 | </sect2>
|
---|
346 |
|
---|
347 | <!-- and keep these in the same order as above -->
|
---|
348 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
349 | href="perl-modules/perl-archive-zip.xml"/>
|
---|
350 |
|
---|
351 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
352 | href="perl-modules/perl-autovivification.xml"/>
|
---|
353 |
|
---|
354 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
355 | href="perl-modules/perl-business-isbn.xml"/>
|
---|
356 |
|
---|
357 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
358 | href="perl-modules/perl-business-ismn.xml"/>
|
---|
359 |
|
---|
360 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
361 | href="perl-modules/perl-business-issn.xml"/>
|
---|
362 |
|
---|
363 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
364 | href="perl-modules/perl-class-accessor.xml"/>
|
---|
365 |
|
---|
366 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
367 | href="perl-modules/perl-data-compare.xml"/>
|
---|
368 |
|
---|
369 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
370 | href="perl-modules/perl-data-dump.xml"/>
|
---|
371 |
|
---|
372 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
373 | href="perl-modules/perl-data-uniqid.xml"/>
|
---|
374 |
|
---|
375 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
376 | href="perl-modules/perl-datetime-calendar-julian.xml"/>
|
---|
377 |
|
---|
378 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
379 | href="perl-modules/perl-datetime-format-builder.xml"/>
|
---|
380 |
|
---|
381 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
382 | href="perl-modules/perl-encode-eucjpascii.xml"/>
|
---|
383 |
|
---|
384 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
385 | href="perl-modules/perl-encode-hanextra.xml"/>
|
---|
386 |
|
---|
387 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
388 | href="perl-modules/perl-encode-jis2k.xml"/>
|
---|
389 | <!--
|
---|
390 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
391 | href="perl-modules/perl-error.xml"/>
|
---|
392 | -->
|
---|
393 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
394 | href="perl-modules/perl-file-slurper.xml"/>
|
---|
395 |
|
---|
396 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
397 | href="perl-modules/perl-file-which.xml"/>
|
---|
398 |
|
---|
399 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
400 | href="perl-modules/perl-html-parser.xml"/>
|
---|
401 |
|
---|
402 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
403 | href="perl-modules/perl-http-daemon.xml"/>
|
---|
404 |
|
---|
405 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
406 | href="perl-modules/perl-io-socket-ssl.xml"/>
|
---|
407 |
|
---|
408 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
409 | href="perl-modules/perl-io-string.xml"/>
|
---|
410 |
|
---|
411 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
412 | href="perl-modules/perl-ipc-run3.xml"/>
|
---|
413 |
|
---|
414 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
415 | href="perl-modules/perl-json.xml"/>
|
---|
416 |
|
---|
417 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
418 | href="perl-modules/perl-lingua-translit.xml"/>
|
---|
419 |
|
---|
420 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
421 | href="perl-modules/perl-list-allutils.xml"/>
|
---|
422 |
|
---|
423 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
424 | href="perl-modules/perl-list-moreutils.xml"/>
|
---|
425 |
|
---|
426 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
427 | href="perl-modules/perl-log-log4perl.xml"/>
|
---|
428 |
|
---|
429 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
430 | href="perl-modules/perl-lwp-protocol-https.xml"/>
|
---|
431 |
|
---|
432 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
433 | href="perl-modules/perl-module-build.xml"/>
|
---|
434 |
|
---|
435 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
436 | href="perl-modules/perl-net-dns.xml"/>
|
---|
437 |
|
---|
438 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
439 | href="perl-modules/perl-parse-recdescent.xml"/>
|
---|
440 |
|
---|
441 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
442 | href="perl-modules/perl-parse-yapp.xml"/>
|
---|
443 |
|
---|
444 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
445 | href="perl-modules/perl-perlio-utf8_strict.xml"/>
|
---|
446 |
|
---|
447 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
448 | href="perl-modules/perl-regexp-common.xml"/>
|
---|
449 |
|
---|
450 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
451 | href="perl-modules/perl-sgmlspm.xml"/>
|
---|
452 |
|
---|
453 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
454 | href="perl-modules/perl-sort-key.xml"/>
|
---|
455 |
|
---|
456 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
457 | href="perl-modules/perl-test-command.xml"/>
|
---|
458 |
|
---|
459 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
460 | href="perl-modules/perl-test-differences.xml"/>
|
---|
461 |
|
---|
462 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
463 | href="perl-modules/perl-text-bibtex.xml"/>
|
---|
464 |
|
---|
465 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
466 | href="perl-modules/perl-text-csv.xml"/>
|
---|
467 |
|
---|
468 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
469 | href="perl-modules/perl-text-roman.xml"/>
|
---|
470 |
|
---|
471 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
472 | href="perl-modules/perl-unicode-collate.xml"/>
|
---|
473 |
|
---|
474 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
475 | href="perl-modules/perl-unicode-linebreak.xml"/>
|
---|
476 |
|
---|
477 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
478 | href="perl-modules/perl-uri.xml"/>
|
---|
479 |
|
---|
480 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
481 | href="perl-modules/perl-xml-libxml-simple.xml"/>
|
---|
482 |
|
---|
483 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
484 | href="perl-modules/perl-xml-libxslt.xml"/>
|
---|
485 |
|
---|
486 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
487 | href="perl-modules/perl-xml-simple.xml"/>
|
---|
488 |
|
---|
489 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
490 | href="perl-modules/perl-xml-writer.xml"/>
|
---|
491 |
|
---|
492 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
493 | href="perl-alternatives.xml"/>
|
---|
494 |
|
---|
495 | </sect1>
|
---|