source: BOOK/final-system/common/perl.xml@ de2b827

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since de2b827 was 040521bc, checked in by Jim Gifford <clfs@…>, 18 years ago

Sync up with 1.0 Book

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