source: chapter08/perl.xml

trunk
Last change on this file was 7152faa, checked in by Pierre Labastie <pierre.labastie@…>, 3 months ago

Change all xml files to utf-8 encoding

  • Property mode set to 100644
File size: 17.4 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="ch-system-perl" role="wrap">
9 <?dbhtml filename="perl.html"?>
10
11 <sect1info condition="script">
12 <productname>perl</productname>
13 <productnumber>&perl-version;</productnumber>
14 <address>&perl-url;</address>
15 </sect1info>
16
17 <title>Perl-&perl-version;</title>
18
19 <indexterm zone="ch-system-perl">
20 <primary sortas="a-Perl">Perl</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Perl package contains the Practical Extraction and Report
27 Language.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&perl-fin-sbu;</seg>
35 <seg>&perl-fin-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of Perl</title>
43<!--
44 <para>First, apply a patch that fixes an issue highlighted by recent
45 versions of gdbm:</para>
46
47<screen><userinput remap="pre">patch -Np1 -i ../&perl-fix-patch;</userinput></screen>
48-->
49 <para>This version of Perl builds the Compress::Raw::Zlib and
50 Compress::Raw::BZip2 modules. By
51 default Perl will use an internal copy of the sources for the build.
52 Issue the following command so that Perl will use the libraries
53 installed on the system:</para>
54
55<screen><userinput remap="pre">export BUILD_ZLIB=False
56export BUILD_BZIP2=0</userinput></screen>
57
58 <para>To have full control over the way Perl is set up, you can remove the
59 <quote>-des</quote> options from the following command and hand-pick the way
60 this package is built. Alternatively, use the command exactly as shown below to
61 use the defaults that Perl auto-detects:</para>
62
63 <screen><userinput remap="configure">sh Configure -des \
64 -Dprefix=/usr \
65 -Dvendorprefix=/usr \
66 -Dprivlib=/usr/lib/perl5/&perl-version-min;/core_perl \
67 -Darchlib=/usr/lib/perl5/&perl-version-min;/core_perl \
68 -Dsitelib=/usr/lib/perl5/&perl-version-min;/site_perl \
69 -Dsitearch=/usr/lib/perl5/&perl-version-min;/site_perl \
70 -Dvendorlib=/usr/lib/perl5/&perl-version-min;/vendor_perl \
71 -Dvendorarch=/usr/lib/perl5/&perl-version-min;/vendor_perl \
72 -Dman1dir=/usr/share/man/man1 \
73 -Dman3dir=/usr/share/man/man3 \
74 -Dpager="/usr/bin/less -isR" \
75 -Duseshrplib \
76 -Dusethreads</userinput></screen>
77
78 <variablelist>
79 <title>The meaning of the new Configure options:</title>
80
81 <varlistentry>
82 <term><parameter>-Dpager="/usr/bin/less -isR"</parameter></term>
83 <listitem>
84 <para>This ensures that <userinput>less</userinput> is used instead
85 of <userinput>more</userinput>.</para>
86 </listitem>
87 </varlistentry>
88
89 <varlistentry>
90 <term><parameter>-Dman1dir=/usr/share/man/man1
91 -Dman3dir=/usr/share/man/man3</parameter></term>
92 <listitem>
93 <para>Since Groff is not installed yet, <command>Configure</command>
94 will not create man pages for Perl. These
95 parameters override this behavior.</para>
96 </listitem>
97 </varlistentry>
98
99 <varlistentry>
100 <term><parameter>-Dusethreads</parameter></term>
101 <listitem>
102 <para>Build Perl with support for threads.</para>
103 </listitem>
104 </varlistentry>
105
106 </variablelist>
107
108 <para>Compile the package:</para>
109
110<screen><userinput remap="make">make</userinput></screen>
111
112 <para>To test the results (approximately 11 SBU), issue:</para>
113
114<screen><userinput remap="test">TEST_JOBS=$(nproc) make test_harness</userinput></screen>
115
116 <para>Install the package and clean up:</para>
117
118<screen><userinput remap="install">make install
119unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
120
121 </sect2>
122
123 <sect2 id="contents-perl" role="content">
124 <title>Contents of Perl</title>
125
126 <segmentedlist>
127 <segtitle>Installed programs</segtitle>
128 <segtitle>Installed libraries</segtitle>
129 <segtitle>Installed directory</segtitle>
130
131 <seglistitem>
132 <seg>corelist, cpan, enc2xs, encguess, h2ph, h2xs, instmodsh,
133 json_pp, libnetcfg, perl, perl&perl-version; (hard link to perl),
134 perlbug, perldoc, perlivp, perlthanks (hard link to perlbug), piconv,
135 pl2pm, pod2html, pod2man, pod2text, pod2usage, podchecker, podselect,
136 prove, ptar, ptardiff, ptargrep, shasum,
137 splain, xsubpp, and zipdetails</seg>
138 <seg>Many which cannot all be listed here</seg>
139 <seg>/usr/lib/perl5</seg>
140 </seglistitem>
141 </segmentedlist>
142
143 <variablelist>
144 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
145 <?dbfo list-presentation="list"?>
146 <?dbhtml list-presentation="table"?>
147<!--
148 <varlistentry id="c2ph">
149 <term><command>c2ph</command></term>
150 <listitem>
151 <para>Dumps C structures as generated from
152 <command>cc -g -S</command></para>
153 <indexterm zone="ch-system-perl c2ph">
154 <primary sortas="b-c2ph">c2ph</primary>
155 </indexterm>
156 </listitem>
157 </varlistentry>
158-->
159 <varlistentry id="corelist">
160 <term><command>corelist</command></term>
161 <listitem>
162 <para>A command line front end to Module::CoreList</para>
163 <indexterm zone="ch-system-perl corelist">
164 <primary sortas="b-corelist">corelist</primary>
165 </indexterm>
166 </listitem>
167 </varlistentry>
168
169 <varlistentry id="cpan">
170 <term><command>cpan</command></term>
171 <listitem>
172 <para>Interact with the Comprehensive Perl Archive Network (CPAN)
173 from the command line</para>
174 <indexterm zone="ch-system-perl cpan">
175 <primary sortas="b-cpan">cpan</primary>
176 </indexterm>
177 </listitem>
178 </varlistentry>
179
180 <varlistentry id="enc2xs">
181 <term><command>enc2xs</command></term>
182 <listitem>
183 <para>Builds a Perl extension for the Encode module from either
184 Unicode Character Mappings or Tcl Encoding Files</para>
185 <indexterm zone="ch-system-perl enc2xs">
186 <primary sortas="b-enc2xs">enc2xs</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 <varlistentry id="encguess">
192 <term><command>encguess</command></term>
193 <listitem>
194 <para>Guess the encoding type of one or several files</para>
195 <indexterm zone="ch-system-perl encguess">
196 <primary sortas="b-encguess">encguess</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="h2ph">
202 <term><command>h2ph</command></term>
203 <listitem>
204 <para>Converts <filename class="extension">.h</filename> C header
205 files to <filename class="extension">.ph</filename> Perl header
206 files</para>
207 <indexterm zone="ch-system-perl h2ph">
208 <primary sortas="b-h2ph">h2ph</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 <varlistentry id="h2xs">
214 <term><command>h2xs</command></term>
215 <listitem>
216 <para>Converts <filename class="extension">.h</filename> C header
217 files to Perl extensions</para>
218 <indexterm zone="ch-system-perl h2xs">
219 <primary sortas="b-h2xs">h2xs</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="instmodsh">
225 <term><command>instmodsh</command></term>
226 <listitem>
227 <para>Shell script for examining installed Perl modules;
228 it can create a tarball from an installed module</para>
229 <indexterm zone="ch-system-perl instmodsh">
230 <primary sortas="b-instmodsh">instmodsh</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="json_pp">
236 <term><command>json_pp</command></term>
237 <listitem>
238 <para>Converts data between certain input and output formats</para>
239 <indexterm zone="ch-system-perl json_pp">
240 <primary sortas="b-json_pp">json_pp</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="libnetcfg">
246 <term><command>libnetcfg</command></term>
247 <listitem>
248 <para>Can be used to configure the
249 <filename class="libraryfile">libnet</filename> Perl module</para>
250 <indexterm zone="ch-system-perl libnetcfg">
251 <primary sortas="b-libnetcfg">libnetcfg</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="perl">
257 <term><command>perl</command></term>
258 <listitem>
259 <para>Combines some of the best features of C, <command>sed</command>,
260 <command>awk</command> and <command>sh</command> into a single
261 Swiss Army language</para>
262 <indexterm zone="ch-system-perl perl">
263 <primary sortas="b-perl">perl</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="perl-version">
269 <term><command>perl&perl-version;</command></term>
270 <listitem>
271 <para>A hard link to <command>perl</command></para>
272 <indexterm zone="ch-system-perl perl-version">
273 <primary sortas="b-perl&perl-version;">perl&perl-version;</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="perlbug">
279 <term><command>perlbug</command></term>
280 <listitem>
281 <para>Used to generate bug reports about Perl, or the modules that come
282 with it, and mail them</para>
283 <indexterm zone="ch-system-perl perlbug">
284 <primary sortas="b-perlbug">perlbug</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="perldoc">
290 <term><command>perldoc</command></term>
291 <listitem>
292 <para>Displays a piece of documentation in pod format that is embedded
293 in the Perl installation tree or in a Perl script</para>
294 <indexterm zone="ch-system-perl perldoc">
295 <primary sortas="b-perldoc">perldoc</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="perlivp">
301 <term><command>perlivp</command></term>
302 <listitem>
303 <para>The Perl Installation Verification Procedure; it can be used to
304 verify that Perl and its libraries have been installed
305 correctly</para>
306 <indexterm zone="ch-system-perl perlivp">
307 <primary sortas="b-perlivp">perlivp</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="perlthanks">
313 <term><command>perlthanks</command></term>
314 <listitem>
315 <para>Used to generate thank you messages to mail to the Perl
316 developers</para>
317 <indexterm zone="ch-system-perl perlthanks">
318 <primary sortas="b-perlthanks">perlthanks</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="piconv">
324 <term><command>piconv</command></term>
325 <listitem>
326 <para>A Perl version of the character encoding converter
327 <command>iconv</command></para>
328 <indexterm zone="ch-system-perl piconv">
329 <primary sortas="b-piconv">piconv</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="pl2pm">
335 <term><command>pl2pm</command></term>
336 <listitem>
337 <para>A rough tool for converting Perl4
338 <filename class="extension">.pl</filename> files to Perl5
339 <filename class="extension">.pm</filename> modules</para>
340 <indexterm zone="ch-system-perl pl2pm">
341 <primary sortas="b-pl2pm">pl2pm</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="pod2html">
347 <term><command>pod2html</command></term>
348 <listitem>
349 <para>Converts files from pod format to HTML format</para>
350 <indexterm zone="ch-system-perl pod2html">
351 <primary sortas="b-pod2html">pod2html</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="pod2man">
357 <term><command>pod2man</command></term>
358 <listitem>
359 <para>Converts pod data to formatted *roff input</para>
360 <indexterm zone="ch-system-perl pod2man">
361 <primary sortas="b-pod2man">pod2man</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="pod2text">
367 <term><command>pod2text</command></term>
368 <listitem>
369 <para>Converts pod data to formatted ASCII text</para>
370 <indexterm zone="ch-system-perl pod2text">
371 <primary sortas="b-pod2text">pod2text</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="pod2usage">
377 <term><command>pod2usage</command></term>
378 <listitem>
379 <para>Prints usage messages from embedded pod docs in files</para>
380 <indexterm zone="ch-system-perl pod2usage">
381 <primary sortas="b-pod2usage">pod2usage</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="podchecker">
387 <term><command>podchecker</command></term>
388 <listitem>
389 <para>Checks the syntax of pod format documentation files</para>
390 <indexterm zone="ch-system-perl podchecker">
391 <primary sortas="b-podchecker">podchecker</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="podselect">
397 <term><command>podselect</command></term>
398 <listitem>
399 <para>Displays selected sections of pod documentation</para>
400 <indexterm zone="ch-system-perl podselect">
401 <primary sortas="b-podselect">podselect</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="prove">
407 <term><command>prove</command></term>
408 <listitem>
409 <para>Command line tool for running tests against the Test::Harness
410 module</para>
411 <indexterm zone="ch-system-perl prove">
412 <primary sortas="b-prove">prove</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416<!--
417 <varlistentry id="pstruct">
418 <term><command>pstruct</command></term>
419 <listitem>
420 <para>Dumps C structures as generated from <command>cc -g -S</command>
421 stabs</para>
422 <indexterm zone="ch-system-perl pstruct">
423 <primary sortas="b-pstruct">pstruct</primary>
424 </indexterm>
425 </listitem>
426 </varlistentry>
427-->
428 <varlistentry id="ptar">
429 <term><command>ptar</command></term>
430 <listitem>
431 <para>A <command>tar</command>-like program written in Perl</para>
432 <indexterm zone="ch-system-perl ptar">
433 <primary sortas="b-ptar">ptar</primary>
434 </indexterm>
435 </listitem>
436 </varlistentry>
437
438 <varlistentry id="ptardiff">
439 <term><command>ptardiff</command></term>
440 <listitem>
441 <para>A Perl program that compares an extracted archive with an
442 unextracted one</para>
443 <indexterm zone="ch-system-perl ptardiff">
444 <primary sortas="b-ptardiff">ptardiff</primary>
445 </indexterm>
446 </listitem>
447 </varlistentry>
448
449 <varlistentry id="ptargrep">
450 <term><command>ptargrep</command></term>
451 <listitem>
452 <para>A Perl program that applies pattern matching to the contents
453 of files in a tar archive</para>
454 <indexterm zone="ch-system-perl ptargrep">
455 <primary sortas="b-ptargrep">ptargrep</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="shasum">
461 <term><command>shasum</command></term>
462 <listitem>
463 <para>Prints or checks SHA checksums</para>
464 <indexterm zone="ch-system-perl shasum">
465 <primary sortas="b-shasum">shasum</primary>
466 </indexterm>
467 </listitem>
468 </varlistentry>
469
470 <varlistentry id="splain">
471 <term><command>splain</command></term>
472 <listitem>
473 <para>Is used to force verbose warning diagnostics in Perl</para>
474 <indexterm zone="ch-system-perl splain">
475 <primary sortas="b-splain">splain</primary>
476 </indexterm>
477 </listitem>
478 </varlistentry>
479
480 <varlistentry id="xsubpp">
481 <term><command>xsubpp</command></term>
482 <listitem>
483 <para>Converts Perl XS code into C code</para>
484 <indexterm zone="ch-system-perl xsubpp">
485 <primary sortas="b-xsubpp">xsubpp</primary>
486 </indexterm>
487 </listitem>
488 </varlistentry>
489
490 <varlistentry id="zipdetails">
491 <term><command>zipdetails</command></term>
492 <listitem>
493 <para>Displays details about the internal structure of a Zip file</para>
494 <indexterm zone="ch-system-perl zipdetails">
495 <primary sortas="b-zipdetails">zipdetails</primary>
496 </indexterm>
497 </listitem>
498 </varlistentry>
499
500 </variablelist>
501
502 </sect2>
503
504</sect1>
Note: See TracBrowser for help on using the repository browser.