Changeset 3f0c882 for chapter06/perl.xml
- Timestamp:
- 12/21/2004 07:38:32 PM (19 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 3d36131c
- Parents:
- aaa3260
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/perl.xml
raaa3260 r3f0c882 11 11 12 12 <sect2 role="package"><title/> 13 <para>The Perl package contains the Practical Extraction and Report Language.</para>14 13 15 14 <segmentedlist> … … 19 18 </segmentedlist> 20 19 21 <segmentedlist>22 <segtitle>Perl installation depends on</segtitle>23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,24 Gawk, GCC, Glibc, Grep, Make, Sed</seg></seglistitem>25 </segmentedlist>26 20 </sect2> 27 21 … … 29 23 <title>Installation of Perl</title> 30 24 31 <para>If you want full control over the way Perl is set up, you can run the 32 interactive <command>Configure</command> script and hand-pick the way this 33 package is built. If you think you can live with the (sensible) 34 defaults it auto-detects, then prepare Perl for compilation with:</para> 25 <para>Prepare Perl for compilation:</para> 35 26 36 27 <screen><userinput>./configure.gnu --prefix=/usr -Dpager="/bin/less -isR"</userinput></screen> 37 38 <para>The meaning of the configure option:</para>39 40 <variablelist>41 <varlistentry>42 <term><parameter>-Dpager="/bin/less -isR"</parameter></term>43 <listitem><para>This corrects an error in the <command>perldoc</command> code with the invocation44 of the <command>less</command> program.</para></listitem>45 </varlistentry>46 </variablelist>47 28 48 29 <para>Compile the package:</para> … … 50 31 <screen><userinput>make</userinput></screen> 51 32 52 <para>If you wish to run the test suite, you first have to create a basic 53 <filename>/etc/hosts</filename> file, which is needed by a couple of tests to 54 resolve the name <emphasis>localhost</emphasis>:</para> 33 <para>Create a basic <filename>/etc/hosts</filename> file:</para> 55 34 56 35 <screen><userinput>echo "127.0.0.1 localhost $(hostname)" > /etc/hosts</userinput></screen> 57 36 58 <para> Now run the tests, if you wish:</para>37 <para>Run the tests:</para> 59 38 60 39 <screen><userinput>make test</userinput></screen> 61 40 62 <para> Finally, install the package:</para>41 <para>Install the package:</para> 63 42 64 43 <screen><userinput>make install</userinput></screen> … … 69 48 <sect2 id="contents-perl" role="content"><title>Contents of Perl</title> 70 49 71 <segmentedlist> 72 <segtitle>Installed programs</segtitle> 73 <segtitle>Installed libraries</segtitle> 74 <seglistitem><seg>a2p, c2ph, dprofpp, enc2xs, 75 find2perl, h2ph, h2xs, libnetcfg, perl, perl&perl-version; (link to perl), 76 perlbug, perlcc, perldoc, perlivp, piconv, pl2pm, pod2html, pod2latex, pod2man, 77 pod2text, pod2usage, podchecker, podselect, psed (link to s2p), pstruct (link 78 to c2ph), s2p, splain and xsubpp</seg> 79 <seg>(too many to name)</seg></seglistitem> 80 </segmentedlist> 81 82 <variablelist><title>Short descriptions</title> 83 84 <varlistentry id="a2p"> 85 <term><command>a2p</command></term> 86 <listitem> 87 <indexterm zone="ch-system-perl a2p"><primary sortas="b-a2p">a2p</primary></indexterm> 88 <para>translates awk to Perl.</para> 89 </listitem> 90 </varlistentry> 91 92 <varlistentry id="c2ph"> 93 <term><command>c2ph</command></term> 94 <listitem> 95 <indexterm zone="ch-system-perl c2ph"><primary sortas="b-c2ph">c2ph</primary></indexterm> 96 <para>dumps C structures as generated from <quote>cc -g -S</quote> stabs.</para> 97 </listitem> 98 </varlistentry> 99 100 <varlistentry id="dprofpp"> 101 <term><command>dprofpp</command></term> 102 <listitem> 103 <indexterm zone="ch-system-perl dprofpp"><primary sortas="b-dprofpp">dprofpp</primary></indexterm> 104 <para>displays Perl profile data.</para> 105 </listitem> 106 </varlistentry> 107 108 <varlistentry id="en2cxs"> 109 <term><command>en2cxs</command></term> 110 <listitem> 111 <indexterm zone="ch-system-perl en2cxs"><primary sortas="b-en2cxs">en2cxs</primary></indexterm> 112 <para>builds a Perl extension for the Encode module, 113 from either Unicode Character Mappings or Tcl Encoding Files.</para> 114 </listitem> 115 </varlistentry> 116 117 <varlistentry id="find2perl"> 118 <term><command>find2perl</command></term> 119 <listitem> 120 <indexterm zone="ch-system-perl find2perl"><primary sortas="b-find2perl">find2perl</primary></indexterm> 121 <para>translates find commands to Perl.</para> 122 </listitem> 123 </varlistentry> 124 125 <varlistentry id="h2ph"> 126 <term><command>h2ph</command></term> 127 <listitem> 128 <indexterm zone="ch-system-perl h2ph"><primary sortas="b-h2ph">h2ph</primary></indexterm> 129 <para>converts <filename class="extension">.h</filename> C header files to 130 <filename class="extension">.ph</filename> Perl header files.</para> 131 </listitem> 132 </varlistentry> 133 134 <varlistentry id="h2xs"> 135 <term><command>h2xs</command></term> 136 <listitem> 137 <indexterm zone="ch-system-perl h2xs"><primary sortas="b-h2xs">h2xs</primary></indexterm> 138 <para>converts <filename class="extension">.h</filename> C header files to Perl extensions.</para> 139 </listitem> 140 </varlistentry> 141 142 <varlistentry id="libnetcfg"> 143 <term><command>libnetcfg</command></term> 144 <listitem> 145 <indexterm zone="ch-system-perl libnetcfg"><primary sortas="b-libnetcfg">libnetcfg</primary></indexterm> 146 <para>can be used to configure the <filename class="libraryfile">libnet</filename>.</para> 147 </listitem> 148 </varlistentry> 149 150 <varlistentry id="perl"> 151 <term><command>perl</command></term> 152 <listitem> 153 <indexterm zone="ch-system-perl perl"><primary sortas="b-perl">perl</primary></indexterm> 154 <para>combines some of the best features of C, sed, 155 awk and sh into a single swiss-army language.</para> 156 </listitem> 157 </varlistentry> 158 159 <varlistentry id="perlbug"> 160 <term><command>perlbug</command></term> 161 <listitem> 162 <indexterm zone="ch-system-perl perlbug"><primary sortas="b-perlbug">perlbug</primary></indexterm> 163 <para>is used to generate bug reports about 164 Perl or the modules that come with it, and mail them.</para> 165 </listitem> 166 </varlistentry> 167 168 <varlistentry id="perlcc"> 169 <term><command>perlcc</command></term> 170 <listitem> 171 <indexterm zone="ch-system-perl perlcc"><primary sortas="b-perlcc">perlcc</primary></indexterm> 172 <para>generates executables from Perl programs.</para> 173 </listitem> 174 </varlistentry> 175 176 <varlistentry id="perldoc"> 177 <term><command>perldoc</command></term> 178 <listitem> 179 <indexterm zone="ch-system-perl perldoc"><primary sortas="b-perldoc">perldoc</primary></indexterm> 180 <para>displays a piece of documentation in pod 181 format that is embedded in the Perl installation tree or in a Perl script.</para> 182 </listitem> 183 </varlistentry> 184 185 <varlistentry id="perlivp"> 186 <term><command>perlivp</command></term> 187 <listitem> 188 <indexterm zone="ch-system-perl perlivp"><primary sortas="b-perlivp">perlivp</primary></indexterm> 189 <para>is the Perl Installation Verification Procedure. It can be used to verify that 190 Perl and its libraries have been installed correctly.</para> 191 </listitem> 192 </varlistentry> 193 194 <varlistentry id="piconv"> 195 <term><command>piconv</command></term> 196 <listitem> 197 <indexterm zone="ch-system-perl piconv"><primary sortas="b-piconv">piconv</primary></indexterm> 198 <para>is a Perl version of the character encoding 199 converter <command>iconv</command>.</para> 200 </listitem> 201 </varlistentry> 202 203 <varlistentry id="pl2pm"> 204 <term><command>pl2pm</command></term> 205 <listitem> 206 <indexterm zone="ch-system-perl pl2pm"><primary sortas="b-pl2pm">pl2pm</primary></indexterm> 207 <para>is a rough tool for converting Perl4 <filename class="extension">.pl</filename> 208 files to Perl5 <filename class="extension">.pm</filename> modules.</para> 209 </listitem> 210 </varlistentry> 211 212 <varlistentry id="pod2html"> 213 <term><command>pod2html</command></term> 214 <listitem> 215 <indexterm zone="ch-system-perl pod2html"><primary sortas="b-pod2html">pod2html</primary></indexterm> 216 <para>converts files from pod format to HTML format.</para> 217 </listitem> 218 </varlistentry> 219 220 <varlistentry id="pod2latex"> 221 <term><command>pod2latex</command></term> 222 <listitem> 223 <indexterm zone="ch-system-perl pod2latex"><primary sortas="b-pod2latex">pod2latex</primary></indexterm> 224 <para>converts files from pod format to LaTeX format.</para> 225 </listitem> 226 </varlistentry> 227 228 <varlistentry id="pod2man"> 229 <term><command>pod2man</command></term> 230 <listitem> 231 <indexterm zone="ch-system-perl pod2man"><primary sortas="b-pod2man">pod2man</primary></indexterm> 232 <para>converts pod data to formatted *roff input.</para> 233 </listitem> 234 </varlistentry> 235 236 <varlistentry id="pod2text"> 237 <term><command>pod2text</command></term> 238 <listitem> 239 <indexterm zone="ch-system-perl pod2text"><primary sortas="b-pod2text">pod2text</primary></indexterm> 240 <para>converts pod data to formatted ASCII text.</para> 241 </listitem> 242 </varlistentry> 243 244 <varlistentry id="pod2usage"> 245 <term><command>pod2usage</command></term> 246 <listitem> 247 <indexterm zone="ch-system-perl pod2usage"><primary sortas="b-pod2usage">pod2usage</primary></indexterm> 248 <para>prints usage messages from embedded pod docs in files.</para> 249 </listitem> 250 </varlistentry> 251 252 <varlistentry id="podchecker"> 253 <term><command>podchecker</command></term> 254 <listitem> 255 <indexterm zone="ch-system-perl podchecker"><primary sortas="b-podchecker">podchecker</primary></indexterm> 256 <para>checks the syntax of pod format documentation files.</para> 257 </listitem> 258 </varlistentry> 259 260 <varlistentry id="podselect"> 261 <term><command>podselect</command></term> 262 <listitem> 263 <indexterm zone="ch-system-perl podselect"><primary sortas="b-podselect">podselect</primary></indexterm> 264 <para>displays selected sections of pod documentation.</para> 265 </listitem> 266 </varlistentry> 267 268 <varlistentry id="psed"> 269 <term><command>psed</command></term> 270 <listitem> 271 <indexterm zone="ch-system-perl psed"><primary sortas="b-psed">psed</primary></indexterm> 272 <para>is a Perl version of the stream editor <command>sed</command>.</para> 273 </listitem> 274 </varlistentry> 275 276 <varlistentry id="pstruct"> 277 <term><command>pstruct</command></term> 278 <listitem> 279 <indexterm zone="ch-system-perl pstruct"><primary sortas="b-pstruct">pstruct</primary></indexterm> 280 <para>dumps C structures as generated from <quote>cc -g -S</quote> stabs.</para> 281 </listitem> 282 </varlistentry> 283 284 <varlistentry id="s2p"> 285 <term><command>s2p</command></term> 286 <listitem> 287 <indexterm zone="ch-system-perl s2p"><primary sortas="b-s2p">s2p</primary></indexterm> 288 <para>translates sed to Perl.</para> 289 </listitem> 290 </varlistentry> 291 292 <varlistentry id="splain"> 293 <term><command>splain</command></term> 294 <listitem> 295 <indexterm zone="ch-system-perl splain"><primary sortas="b-splain">splain</primary></indexterm> 296 <para>is used to force verbose warning 297 diagnostics in Perl.</para> 298 </listitem> 299 </varlistentry> 300 301 <varlistentry id="xsubpp"> 302 <term><command>xsubpp</command></term> 303 <listitem> 304 <indexterm zone="ch-system-perl xsubpp"><primary sortas="b-xsubpp">xsubpp</primary></indexterm> 305 <para>converts Perl XS code into C code.</para> 306 </listitem> 307 </varlistentry> 308 </variablelist> 50 <para>See testing</para> 309 51 310 52 </sect2>
Note:
See TracChangeset
for help on using the changeset viewer.