source: clfs-sysroot/BOOK/final-system/arm/perl.xml@ c0cd0ca

Last change on this file since c0cd0ca was 6176b00, checked in by Joe Ciccone <jciccone@…>, 18 years ago

Re-arranged the perl sed.

  • Property mode set to 100644
File size: 13.8 KB
Line 
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
28 <para os="p1">The following patch fixes issues with perl and
29 cross-compiling:</para>
30
31<screen os="p2"><userinput>patch -Np1 -i ../&perl-cross_compile-patch;</userinput></screen>
32
33 <para os="s1">The following sed causes <filename>DynaLoader.a</filename>
34 to be built with -fPIC so it can be linked into a shared library
35 later:</para>
36
37<screen os="s2"><userinput>sed -i -e "s@pldlflags=''@pldlflags=\"\$cccdlflags\"@g" \
38 -e "s@static_target='static'@static_target='static_pic'@g" Makefile.SH</userinput></screen>
39
40 <para os="a">The Cross directory contains a Makefile for cross-compiling.</para>
41
42<screen os="b"><userinput>cd Cross</userinput></screen>
43
44 <para os="c">Compile the package:</para>
45
46<screen os="d"><userinput>make ARCH=arm CROSS_COMPILE="${CLFS_TARGET}-"</userinput></screen>
47
48 <para os="e">Install the package:</para>
49
50<screen os="f"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
51
52 </sect2>
53
54 <sect2 id="contents-perl" role="content">
55 <title>Contents of Perl</title>
56
57 <segmentedlist>
58 <segtitle>Installed programs</segtitle>
59 <segtitle>Installed libraries</segtitle>
60
61 <seglistitem>
62 <seg>a2p, c2ph, cpan, dprofpp, enc2xs, find2perl, h2ph, h2xs, instmodsh, libnetcfg,
63 perl, perl&perl-version; (link to perl), perlbug, perlcc, perldoc,
64 perlivp, piconv, pl2pm, pod2html, pod2latex, pod2man, pod2text,
65 pod2usage, podchecker, podselect, prove, psed (link to s2p), pstruct (link
66 to c2ph), s2p, splain, and xsubpp</seg>
67 <seg>Several hundred which cannot all be listed here</seg>
68 </seglistitem>
69 </segmentedlist>
70
71 <variablelist>
72 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
73 <?dbfo list-presentation="list"?>
74 <?dbhtml list-presentation="table"?>
75
76 <varlistentry id="a2p">
77 <term><command>a2p</command></term>
78 <listitem>
79 <para>Translates awk to Perl</para>
80 <indexterm zone="ch-system-perl a2p">
81 <primary sortas="b-a2p">a2p</primary>
82 </indexterm>
83 </listitem>
84 </varlistentry>
85
86 <varlistentry id="c2ph">
87 <term><command>c2ph</command></term>
88 <listitem>
89 <para>Dumps C structures as generated from
90 <command>cc -g -S</command></para>
91 <indexterm zone="ch-system-perl c2ph">
92 <primary sortas="b-c2ph">c2ph</primary>
93 </indexterm>
94 </listitem>
95 </varlistentry>
96
97 <varlistentry id="cpan">
98 <term><command>cpan</command></term>
99 <listitem>
100 <para>Shell script that provides a command interface to CPAN.pm</para>
101 <indexterm zone="ch-system-perl cpan">
102 <primary sortas="b-cpan">cpan</primary>
103 </indexterm>
104 </listitem>
105 </varlistentry>
106
107 <varlistentry id="dprofpp">
108 <term><command>dprofpp</command></term>
109 <listitem>
110 <para>Displays Perl profile data</para>
111 <indexterm zone="ch-system-perl dprofpp">
112 <primary sortas="b-dprofpp">dprofpp</primary>
113 </indexterm>
114 </listitem>
115 </varlistentry>
116
117 <varlistentry id="enc2xs">
118 <term><command>enc2xs</command></term>
119 <listitem>
120 <para>Builds a Perl extension for the Encode module from either
121 Unicode Character Mappings or Tcl Encoding Files</para>
122 <indexterm zone="ch-system-perl enc2xs">
123 <primary sortas="b-enc2xs">enc2xs</primary>
124 </indexterm>
125 </listitem>
126 </varlistentry>
127
128 <varlistentry id="find2perl">
129 <term><command>find2perl</command></term>
130 <listitem>
131 <para>Translates <command>find</command> commands to Perl</para>
132 <indexterm zone="ch-system-perl find2perl">
133 <primary sortas="b-find2perl">find2perl</primary>
134 </indexterm>
135 </listitem>
136 </varlistentry>
137
138 <varlistentry id="h2ph">
139 <term><command>h2ph</command></term>
140 <listitem>
141 <para>Converts <filename class="extension">.h</filename> C header
142 files to <filename class="extension">.ph</filename> Perl header
143 files</para>
144 <indexterm zone="ch-system-perl h2ph">
145 <primary sortas="b-h2ph">h2ph</primary>
146 </indexterm>
147 </listitem>
148 </varlistentry>
149
150 <varlistentry id="h2xs">
151 <term><command>h2xs</command></term>
152 <listitem>
153 <para>Converts <filename class="extension">.h</filename> C header
154 files to Perl extensions</para>
155 <indexterm zone="ch-system-perl h2xs">
156 <primary sortas="b-h2xs">h2xs</primary>
157 </indexterm>
158 </listitem>
159 </varlistentry>
160
161 <varlistentry id="libnetcfg">
162 <term><command>libnetcfg</command></term>
163 <listitem>
164 <para>Can be used to configure the
165 <filename class="libraryfile">libnet</filename></para>
166 <indexterm zone="ch-system-perl libnetcfg">
167 <primary sortas="b-libnetcfg">libnetcfg</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="instmodsh">
173 <term><command>instmodsh</command></term>
174 <listitem>
175 <para>A shell script for examining installed Perl modules,
176 and can even create a tarball from an installed module</para>
177 <indexterm zone="ch-system-perl instmodsh">
178 <primary sortas="b-instmodsh">instmodsh</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry id="perl">
184 <term><command>perl</command></term>
185 <listitem>
186 <para>Combines some of the best features of C, <command>sed</command>,
187 <command>awk</command> and <command>sh</command> into a single
188 swiss-army-knife language</para>
189 <indexterm zone="ch-system-perl perl">
190 <primary sortas="b-perl">perl</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 <varlistentry id="perl-version">
196 <term><command>perl&perl-version;</command></term>
197 <listitem>
198 <para>A hard link to <command>perl</command></para>
199 <indexterm zone="ch-system-perl perl-version">
200 <primary sortas="b-perl&perl-version;">perl&perl-version;</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="perlbug">
206 <term><command>perlbug</command></term>
207 <listitem>
208 <para>Used to generate bug reports about Perl, or the modules that come
209 with it, and mail them</para>
210 <indexterm zone="ch-system-perl perlbug">
211 <primary sortas="b-perlbug">perlbug</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="perlcc">
217 <term><command>perlcc</command></term>
218 <listitem>
219 <para>Generates executables from Perl programs</para>
220 <indexterm zone="ch-system-perl perlcc">
221 <primary sortas="b-perlcc">perlcc</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="perldoc">
227 <term><command>perldoc</command></term>
228 <listitem>
229 <para>Displays a piece of documentation in pod format that is embedded
230 in the Perl installation tree or in a Perl script</para>
231 <indexterm zone="ch-system-perl perldoc">
232 <primary sortas="b-perldoc">perldoc</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="perlivp">
238 <term><command>perlivp</command></term>
239 <listitem>
240 <para>The Perl Installation Verification Procedure; it can be used to
241 verify that Perl and its libraries have been installed
242 correctly</para>
243 <indexterm zone="ch-system-perl perlivp">
244 <primary sortas="b-perlivp">perlivp</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="piconv">
250 <term><command>piconv</command></term>
251 <listitem>
252 <para>A Perl version of the character encoding converter
253 <command>iconv</command></para>
254 <indexterm zone="ch-system-perl piconv">
255 <primary sortas="b-piconv">piconv</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="pl2pm">
261 <term><command>pl2pm</command></term>
262 <listitem>
263 <para>A rough tool for converting Perl4
264 <filename class="extension">.pl</filename> files to Perl5
265 <filename class="extension">.pm</filename> modules</para>
266 <indexterm zone="ch-system-perl pl2pm">
267 <primary sortas="b-pl2pm">pl2pm</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="pod2html">
273 <term><command>pod2html</command></term>
274 <listitem>
275 <para>Converts files from pod format to HTML format</para>
276 <indexterm zone="ch-system-perl pod2html">
277 <primary sortas="b-pod2html">pod2html</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="pod2latex">
283 <term><command>pod2latex</command></term>
284 <listitem>
285 <para>Converts files from pod format to LaTeX format</para>
286 <indexterm zone="ch-system-perl pod2latex">
287 <primary sortas="b-pod2latex">pod2latex</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="pod2man">
293 <term><command>pod2man</command></term>
294 <listitem>
295 <para>Converts pod data to formatted *roff input</para>
296 <indexterm zone="ch-system-perl pod2man">
297 <primary sortas="b-pod2man">pod2man</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
301
302 <varlistentry id="pod2text">
303 <term><command>pod2text</command></term>
304 <listitem>
305 <para>Converts pod data to formatted ASCII text</para>
306 <indexterm zone="ch-system-perl pod2text">
307 <primary sortas="b-pod2text">pod2text</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="pod2usage">
313 <term><command>pod2usage</command></term>
314 <listitem>
315 <para>Prints usage messages from embedded pod docs in files</para>
316 <indexterm zone="ch-system-perl pod2usage">
317 <primary sortas="b-pod2usage">pod2usage</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="podchecker">
323 <term><command>podchecker</command></term>
324 <listitem>
325 <para>Checks the syntax of pod format documentation files</para>
326 <indexterm zone="ch-system-perl podchecker">
327 <primary sortas="b-podchecker">podchecker</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="podselect">
333 <term><command>podselect</command></term>
334 <listitem>
335 <para>Displays selected sections of pod documentation</para>
336 <indexterm zone="ch-system-perl podselect">
337 <primary sortas="b-podselect">podselect</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="prove">
343 <term><command>prove</command></term>
344 <listitem>
345 <para>A command-line tool for running tests against Test::Harness</para>
346 <indexterm zone="ch-system-perl prove">
347 <primary sortas="b-prove">prove</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="psed">
353 <term><command>psed</command></term>
354 <listitem>
355 <para>A Perl version of the stream editor <command>sed</command></para>
356 <indexterm zone="ch-system-perl psed">
357 <primary sortas="b-psed">psed</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="pstruct">
363 <term><command>pstruct</command></term>
364 <listitem>
365 <para>Dumps C structures as generated from <command>cc -g -S</command>
366 stabs</para>
367 <indexterm zone="ch-system-perl pstruct">
368 <primary sortas="b-pstruct">pstruct</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="s2p">
374 <term><command>s2p</command></term>
375 <listitem>
376 <para>Translates <command>sed</command> to Perl</para>
377 <indexterm zone="ch-system-perl s2p">
378 <primary sortas="b-s2p">s2p</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="splain">
384 <term><command>splain</command></term>
385 <listitem>
386 <para>Is used to force verbose warning diagnostics in Perl</para>
387 <indexterm zone="ch-system-perl splain">
388 <primary sortas="b-splain">splain</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="xsubpp">
394 <term><command>xsubpp</command></term>
395 <listitem>
396 <para>Converts Perl XS code into C code</para>
397 <indexterm zone="ch-system-perl xsubpp">
398 <primary sortas="b-xsubpp">xsubpp</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 </variablelist>
404
405 </sect2>
406
407</sect1>
Note: See TracBrowser for help on using the repository browser.