source: clfs-sysroot/BOOK/final-system/common/perl.xml@ 82b662d

Last change on this file since 82b662d was 82b662d, checked in by Jim Gifford <clfs@…>, 18 years ago

r3918@server (orig r1762): jciccone | 2006-06-11 10:42:36 -0700
Updated to shadow-4.0.16 and linux-headers-2.6.16.20-06092006; Updated the list of installed programs for several packages; Fixed the install of module-init-tools.

  • Property mode set to 100644
File size: 14.8 KB
RevLine 
[02095ae]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 <title>Perl-&perl-version;</title>
12
13 <indexterm zone="ch-system-perl">
14 <primary sortas="a-Perl">Perl</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Perl package contains the Practical Extraction and Report
21 Language.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Perl</title>
27
[3349a3a]28 <important os="w1"><para>Information on cross-compiling perl has not been added yet.</para></important>
[02095ae]29
30 <para os="a00">Before starting to configure, create a basic
31 <filename>/etc/hosts</filename> file which will be referenced in one
32 of Perl's configuration files as well as being used used by the testsuite
33 if you run that.</para>
34
35<screen os="a01"><userinput>echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
36
37 <para os="a">To have full control over the way Perl is set up, run the
38 interactive <command>Configure</command> script and hand-pick the way
39 this package is built. If the defaults it auto-detects are suitable,
40 prepare Perl for compilation with:</para>
41
42<screen os="b"><userinput>./configure.gnu --prefix=/usr \
43 -Dman1dir=/usr/share/man/man1 \
44 -Dman3dir=/usr/share/man/man3 \
45 -Dpager="/bin/less -isR"</userinput></screen>
46
47 <variablelist os="c">
48 <title>The meaning of the configure option:</title>
49
50 <varlistentry os="c1">
51 <term><parameter>-Dpager="/bin/less -isR"</parameter></term>
52 <listitem>
53 <para>This corrects an error in the way that <command>perldoc</command>
54 invokes the <command>less</command> program.</para>
55 </listitem>
56 </varlistentry>
57 <varlistentry os="c2">
58 <term><parameter>-Dman1dir=/usr/share/man/man1 -Dman3dir=/usr/share/man/man3</parameter></term>
59 <listitem>
60 <para>Since Groff is not installed yet,
61 <command>configure.gnu</command> thinks that we do not want
62 man pages for Perl. Issuing these parameters overrides this decision.</para>
63 </listitem>
64 </varlistentry>
65 </variablelist>
66
67 <para os="d">Compile the package:</para>
68
69<screen os="e"><userinput>make</userinput></screen>
70
71 <para os="h">To test the results, issue:
72 <userinput>make test</userinput>.</para>
73
74 <para os="j">Install the package:</para>
75
76<screen os="k"><userinput>make install</userinput></screen>
77
78 </sect2>
79
80 <sect2 id="contents-perl" role="content">
81 <title>Contents of Perl</title>
82
83 <segmentedlist>
84 <segtitle>Installed programs</segtitle>
85 <segtitle>Installed libraries</segtitle>
86
87 <seglistitem>
[82b662d]88 <seg>a2p, c2ph, cpan, dprofpp, enc2xs, find2perl, h2ph, h2xs, instmodsh, libnetcfg,
[02095ae]89 perl, perl&perl-version; (link to perl), perlbug, perlcc, perldoc,
90 perlivp, piconv, pl2pm, pod2html, pod2latex, pod2man, pod2text,
[82b662d]91 pod2usage, podchecker, podselect, prove, psed (link to s2p), pstruct (link
[02095ae]92 to c2ph), s2p, splain, and xsubpp</seg>
93 <seg>Several hundred which cannot all be listed here</seg>
94 </seglistitem>
95 </segmentedlist>
96
97 <variablelist>
98 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
99 <?dbfo list-presentation="list"?>
100 <?dbhtml list-presentation="table"?>
101
102 <varlistentry id="a2p">
103 <term><command>a2p</command></term>
104 <listitem>
105 <para>Translates awk to Perl</para>
106 <indexterm zone="ch-system-perl a2p">
107 <primary sortas="b-a2p">a2p</primary>
108 </indexterm>
109 </listitem>
110 </varlistentry>
111
112 <varlistentry id="c2ph">
113 <term><command>c2ph</command></term>
114 <listitem>
115 <para>Dumps C structures as generated from
116 <command>cc -g -S</command></para>
117 <indexterm zone="ch-system-perl c2ph">
118 <primary sortas="b-c2ph">c2ph</primary>
119 </indexterm>
120 </listitem>
121 </varlistentry>
122
[82b662d]123 <varlistentry id="cpan">
124 <term><command>cpan</command></term>
125 <listitem>
126 <para>Shell script that provides a command interface to CPAN.pm</para>
127 <indexterm zone="ch-system-perl cpan">
128 <primary sortas="b-cpan">cpan</primary>
129 </indexterm>
130 </listitem>
131 </varlistentry>
132
[02095ae]133 <varlistentry id="dprofpp">
134 <term><command>dprofpp</command></term>
135 <listitem>
136 <para>Displays Perl profile data</para>
137 <indexterm zone="ch-system-perl dprofpp">
138 <primary sortas="b-dprofpp">dprofpp</primary>
139 </indexterm>
140 </listitem>
141 </varlistentry>
142
[82b662d]143 <varlistentry id="enc2xs">
144 <term><command>enc2xs</command></term>
145 <listitem>
146 <para>Builds a Perl extension for the Encode module from either
147 Unicode Character Mappings or Tcl Encoding Files</para>
148 <indexterm zone="ch-system-perl enc2xs">
149 <primary sortas="b-enc2xs">enc2xs</primary>
150 </indexterm>
151 </listitem>
152 </varlistentry>
153
[02095ae]154 <varlistentry id="find2perl">
155 <term><command>find2perl</command></term>
156 <listitem>
157 <para>Translates <command>find</command> commands to Perl</para>
158 <indexterm zone="ch-system-perl find2perl">
159 <primary sortas="b-find2perl">find2perl</primary>
160 </indexterm>
161 </listitem>
162 </varlistentry>
163
164 <varlistentry id="h2ph">
165 <term><command>h2ph</command></term>
166 <listitem>
167 <para>Converts <filename class="extension">.h</filename> C header
168 files to <filename class="extension">.ph</filename> Perl header
169 files</para>
170 <indexterm zone="ch-system-perl h2ph">
171 <primary sortas="b-h2ph">h2ph</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="h2xs">
177 <term><command>h2xs</command></term>
178 <listitem>
179 <para>Converts <filename class="extension">.h</filename> C header
180 files to Perl extensions</para>
181 <indexterm zone="ch-system-perl h2xs">
182 <primary sortas="b-h2xs">h2xs</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 <varlistentry id="libnetcfg">
188 <term><command>libnetcfg</command></term>
189 <listitem>
190 <para>Can be used to configure the
191 <filename class="libraryfile">libnet</filename></para>
192 <indexterm zone="ch-system-perl libnetcfg">
193 <primary sortas="b-libnetcfg">libnetcfg</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
[82b662d]198 <varlistentry id="instmodsh">
199 <term><command>instmodsh</command></term>
200 <listitem>
201 <para>A shell script for examining installed Perl modules,
202 and can even create a tarball from an installed module</para>
203 <indexterm zone="ch-system-perl instmodsh">
204 <primary sortas="b-instmodsh">instmodsh</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
[02095ae]209 <varlistentry id="perl">
210 <term><command>perl</command></term>
211 <listitem>
212 <para>Combines some of the best features of C, <command>sed</command>,
213 <command>awk</command> and <command>sh</command> into a single
[59fb197]214 swiss-army-knife language</para>
[02095ae]215 <indexterm zone="ch-system-perl perl">
216 <primary sortas="b-perl">perl</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="perl-version">
222 <term><command>perl&perl-version;</command></term>
223 <listitem>
224 <para>A hard link to <command>perl</command></para>
225 <indexterm zone="ch-system-perl perl-version">
226 <primary sortas="b-perl&perl-version;">perl&perl-version;</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="perlbug">
232 <term><command>perlbug</command></term>
233 <listitem>
234 <para>Used to generate bug reports about Perl, or the modules that come
235 with it, and mail them</para>
236 <indexterm zone="ch-system-perl perlbug">
237 <primary sortas="b-perlbug">perlbug</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="perlcc">
243 <term><command>perlcc</command></term>
244 <listitem>
245 <para>Generates executables from Perl programs</para>
246 <indexterm zone="ch-system-perl perlcc">
247 <primary sortas="b-perlcc">perlcc</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="perldoc">
253 <term><command>perldoc</command></term>
254 <listitem>
255 <para>Displays a piece of documentation in pod format that is embedded
256 in the Perl installation tree or in a Perl script</para>
257 <indexterm zone="ch-system-perl perldoc">
258 <primary sortas="b-perldoc">perldoc</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="perlivp">
264 <term><command>perlivp</command></term>
265 <listitem>
266 <para>The Perl Installation Verification Procedure; it can be used to
267 verify that Perl and its libraries have been installed
268 correctly</para>
269 <indexterm zone="ch-system-perl perlivp">
270 <primary sortas="b-perlivp">perlivp</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="piconv">
276 <term><command>piconv</command></term>
277 <listitem>
278 <para>A Perl version of the character encoding converter
279 <command>iconv</command></para>
280 <indexterm zone="ch-system-perl piconv">
281 <primary sortas="b-piconv">piconv</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="pl2pm">
287 <term><command>pl2pm</command></term>
288 <listitem>
289 <para>A rough tool for converting Perl4
290 <filename class="extension">.pl</filename> files to Perl5
291 <filename class="extension">.pm</filename> modules</para>
292 <indexterm zone="ch-system-perl pl2pm">
293 <primary sortas="b-pl2pm">pl2pm</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="pod2html">
299 <term><command>pod2html</command></term>
300 <listitem>
301 <para>Converts files from pod format to HTML format</para>
302 <indexterm zone="ch-system-perl pod2html">
303 <primary sortas="b-pod2html">pod2html</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="pod2latex">
309 <term><command>pod2latex</command></term>
310 <listitem>
311 <para>Converts files from pod format to LaTeX format</para>
312 <indexterm zone="ch-system-perl pod2latex">
313 <primary sortas="b-pod2latex">pod2latex</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="pod2man">
319 <term><command>pod2man</command></term>
320 <listitem>
321 <para>Converts pod data to formatted *roff input</para>
322 <indexterm zone="ch-system-perl pod2man">
323 <primary sortas="b-pod2man">pod2man</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="pod2text">
329 <term><command>pod2text</command></term>
330 <listitem>
331 <para>Converts pod data to formatted ASCII text</para>
332 <indexterm zone="ch-system-perl pod2text">
333 <primary sortas="b-pod2text">pod2text</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="pod2usage">
339 <term><command>pod2usage</command></term>
340 <listitem>
341 <para>Prints usage messages from embedded pod docs in files</para>
342 <indexterm zone="ch-system-perl pod2usage">
343 <primary sortas="b-pod2usage">pod2usage</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="podchecker">
349 <term><command>podchecker</command></term>
350 <listitem>
351 <para>Checks the syntax of pod format documentation files</para>
352 <indexterm zone="ch-system-perl podchecker">
353 <primary sortas="b-podchecker">podchecker</primary>
354 </indexterm>
355 </listitem>
356 </varlistentry>
357
358 <varlistentry id="podselect">
359 <term><command>podselect</command></term>
360 <listitem>
361 <para>Displays selected sections of pod documentation</para>
362 <indexterm zone="ch-system-perl podselect">
363 <primary sortas="b-podselect">podselect</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
[82b662d]368 <varlistentry id="prove">
369 <term><command>prove</command></term>
370 <listitem>
371 <para>A command-line tool for running tests against Test::Harness</para>
372 <indexterm zone="ch-system-perl prove">
373 <primary sortas="b-prove">prove</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
[02095ae]378 <varlistentry id="psed">
379 <term><command>psed</command></term>
380 <listitem>
381 <para>A Perl version of the stream editor <command>sed</command></para>
382 <indexterm zone="ch-system-perl psed">
383 <primary sortas="b-psed">psed</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <varlistentry id="pstruct">
389 <term><command>pstruct</command></term>
390 <listitem>
391 <para>Dumps C structures as generated from <command>cc -g -S</command>
392 stabs</para>
393 <indexterm zone="ch-system-perl pstruct">
394 <primary sortas="b-pstruct">pstruct</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="s2p">
400 <term><command>s2p</command></term>
401 <listitem>
402 <para>Translates <command>sed</command> to Perl</para>
403 <indexterm zone="ch-system-perl s2p">
404 <primary sortas="b-s2p">s2p</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="splain">
410 <term><command>splain</command></term>
411 <listitem>
412 <para>Is used to force verbose warning diagnostics in Perl</para>
413 <indexterm zone="ch-system-perl splain">
414 <primary sortas="b-splain">splain</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="xsubpp">
420 <term><command>xsubpp</command></term>
421 <listitem>
422 <para>Converts Perl XS code into C code</para>
423 <indexterm zone="ch-system-perl xsubpp">
424 <primary sortas="b-xsubpp">xsubpp</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 </variablelist>
430
431 </sect2>
432
433</sect1>
Note: See TracBrowser for help on using the repository browser.