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

12.1 ken/TL2024 lazarus rahul/power-profiles-daemon trunk xry111/llvm18
Last change on this file since cb7d0f0 was ab4fdfc, checked in by Pierre Labastie <pierre.labastie@…>, 4 months ago

Change all xml decl to encoding=utf-8

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