source: general/prog/new-perl-modules.xml@ c286c97

perl-modules
Last change on this file since c286c97 was 65fb5c2, checked in by Ken Moffat <ken@…>, 5 years ago

perl modules branch: Specify that the dependencies should be built in alphabetical order (dependencies of an earlier dependency of a package are not listed for the package), and if testing all tests for a module and its dependencies should be run (i.e. deps such as Test::Fatal are not listed for a module if already listed for one of its dependencies). Clean up dependencies in the DateTime area to match this pattern.

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