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

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 0e161fb7 was 3508ede, checked in by Joe Ciccone <jciccone@…>, 17 years ago

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