Changeset 81fd230 for chapter06/perl.xml
- Timestamp:
- 02/19/2005 10:16:42 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:
- 3d31fc4
- Parents:
- 2f9131f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/perl.xml
r2f9131f r81fd230 4 4 %general-entities; 5 5 ]> 6 <sect1 id="ch-system-perl" xreflabel="Perl"role="wrap">6 <sect1 id="ch-system-perl" role="wrap"> 7 7 <title>Perl-&perl-version;</title> 8 8 <?dbhtml filename="perl.html"?> … … 11 11 12 12 <sect2 role="package"><title/> 13 <para>The Perl package contains the Practical Extraction and Report Language.</para> 13 14 14 15 <segmentedlist> … … 18 19 </segmentedlist> 19 20 21 <segmentedlist> 22 <segtitle>Perl installation depends on</segtitle> 23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, 24 Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> 25 </segmentedlist> 20 26 </sect2> 21 27 … … 23 29 <title>Installation of Perl</title> 24 30 25 <para>Prepare Perl for compilation:</para> 31 <para>To have full control over the way Perl is set up, run the 32 interactive <command>Configure</command> script and hand-pick the way 33 this package is built. If the defaults it auto-detects are suitable, 34 prepare Perl for compilation with:</para> 26 35 27 36 <screen><userinput>./configure.gnu --prefix=/usr -Dpager="/bin/less -isR"</userinput></screen> 28 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 invocation 44 of the <command>less</command> program.</para></listitem> 45 </varlistentry> 46 </variablelist> 47 29 48 <para>Compile the package:</para> 30 49 31 50 <screen><userinput>make</userinput></screen> 32 51 33 <para>Create a basic <filename>/etc/hosts</filename> file:</para> 52 <para>To run the test suite, first create a basic 53 <filename>/etc/hosts</filename> file which is needed by a couple of 54 tests to resolve the network name localhost:</para> 34 55 35 56 <screen><userinput>echo "127.0.0.1 localhost $(hostname)" > /etc/hosts</userinput></screen> 36 57 37 <para> Run the tests:</para>58 <para>Now run the tests, if desired:</para> 38 59 39 60 <screen><userinput>make test</userinput></screen> … … 48 69 <sect2 id="contents-perl" role="content"><title>Contents of Perl</title> 49 70 50 <para>See testing</para> 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>Several hundred which cannot all be listed here</seg></seglistitem> 80 </segmentedlist> 81 82 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> 83 <?dbfo list-presentation="list"?> 84 85 <varlistentry id="a2p"> 86 <term><command>a2p</command></term> 87 <listitem> 88 <para>Translates awk to Perl</para> 89 <indexterm zone="ch-system-perl a2p"><primary sortas="b-a2p">a2p</primary></indexterm> 90 </listitem> 91 </varlistentry> 92 93 <varlistentry id="c2ph"> 94 <term><command>c2ph</command></term> 95 <listitem> 96 <para>Dumps C structures as generated from <command>cc -g -S</command></para> 97 <indexterm zone="ch-system-perl c2ph"><primary sortas="b-c2ph">c2ph</primary></indexterm> 98 </listitem> 99 </varlistentry> 100 101 <varlistentry id="dprofpp"> 102 <term><command>dprofpp</command></term> 103 <listitem> 104 <para>Displays Perl profile data</para> 105 <indexterm zone="ch-system-perl dprofpp"><primary sortas="b-dprofpp">dprofpp</primary></indexterm> 106 </listitem> 107 </varlistentry> 108 109 <varlistentry id="en2cxs"> 110 <term><command>en2cxs</command></term> 111 <listitem> 112 <para>Builds a Perl extension for the Encode module from either 113 Unicode Character Mappings or Tcl Encoding Files</para> 114 <indexterm zone="ch-system-perl en2cxs"><primary sortas="b-en2cxs">en2cxs</primary></indexterm> 115 </listitem> 116 </varlistentry> 117 118 <varlistentry id="find2perl"> 119 <term><command>find2perl</command></term> 120 <listitem> 121 <para>Translates <command>find</command> commands to Perl</para> 122 <indexterm zone="ch-system-perl find2perl"><primary sortas="b-find2perl">find2perl</primary></indexterm> 123 </listitem> 124 </varlistentry> 125 126 <varlistentry id="h2ph"> 127 <term><command>h2ph</command></term> 128 <listitem> 129 <para>Converts <filename class="extension">.h</filename> C header files to 130 <filename class="extension">.ph</filename> Perl header files</para> 131 <indexterm zone="ch-system-perl h2ph"><primary sortas="b-h2ph">h2ph</primary></indexterm> 132 </listitem> 133 </varlistentry> 134 135 <varlistentry id="h2xs"> 136 <term><command>h2xs</command></term> 137 <listitem> 138 <para>Converts <filename class="extension">.h</filename> C header files to Perl extensions</para> 139 <indexterm zone="ch-system-perl h2xs"><primary sortas="b-h2xs">h2xs</primary></indexterm> 140 </listitem> 141 </varlistentry> 142 143 <varlistentry id="libnetcfg"> 144 <term><command>libnetcfg</command></term> 145 <listitem> 146 <para>Can be used to configure the <filename class="libraryfile">libnet</filename></para> 147 <indexterm zone="ch-system-perl libnetcfg"><primary sortas="b-libnetcfg">libnetcfg</primary></indexterm> 148 </listitem> 149 </varlistentry> 150 151 <varlistentry id="perl"> 152 <term><command>perl</command></term> 153 <listitem> 154 <para>Combines some of the best features of C, sed, awk and sh into a 155 single swiss-army language</para> 156 <indexterm zone="ch-system-perl perl"><primary sortas="b-perl">perl</primary></indexterm> 157 </listitem> 158 </varlistentry> 159 160 <varlistentry id="perl-version"> 161 <term><command>perl&perl-version;</command></term> 162 <listitem> 163 <para>A hard link to <command>perl</command></para> 164 <indexterm zone="ch-system-perl perl-version"><primary 165 sortas="b-perl&perl-version;">perl&perl-version;</primary></indexterm> 166 </listitem> 167 </varlistentry> 168 169 170 <varlistentry id="perlbug"> 171 <term><command>perlbug</command></term> 172 <listitem> 173 <para>Used to generate bug reports about Perl, or the modules that come 174 with it, and mail them</para> 175 <indexterm zone="ch-system-perl perlbug"><primary sortas="b-perlbug">perlbug</primary></indexterm> 176 </listitem> 177 </varlistentry> 178 179 <varlistentry id="perlcc"> 180 <term><command>perlcc</command></term> 181 <listitem> 182 <para>Generates executables from Perl programs</para> 183 <indexterm zone="ch-system-perl perlcc"><primary sortas="b-perlcc">perlcc</primary></indexterm> 184 </listitem> 185 </varlistentry> 186 187 <varlistentry id="perldoc"> 188 <term><command>perldoc</command></term> 189 <listitem> 190 <para>Displays a piece of documentation in pod format that is embedded 191 in the Perl installation tree or in a Perl script</para> 192 <indexterm zone="ch-system-perl perldoc"><primary sortas="b-perldoc">perldoc</primary></indexterm> 193 </listitem> 194 </varlistentry> 195 196 <varlistentry id="perlivp"> 197 <term><command>perlivp</command></term> 198 <listitem> 199 <para>The Perl Installation Verification Procedure; it can be used to 200 verify that Perl and its libraries have been installed 201 correctly</para> 202 <indexterm zone="ch-system-perl perlivp"><primary sortas="b-perlivp">perlivp</primary></indexterm> 203 </listitem> 204 </varlistentry> 205 206 <varlistentry id="piconv"> 207 <term><command>piconv</command></term> 208 <listitem> 209 <para>A Perl version of the character encoding converter 210 <command>iconv</command></para> 211 <indexterm zone="ch-system-perl piconv"><primary sortas="b-piconv">piconv</primary></indexterm> 212 </listitem> 213 </varlistentry> 214 215 <varlistentry id="pl2pm"> 216 <term><command>pl2pm</command></term> 217 <listitem> 218 <para>A rough tool for converting Perl4 <filename class="extension">.pl</filename> 219 files to Perl5 <filename class="extension">.pm</filename> modules</para> 220 <indexterm zone="ch-system-perl pl2pm"><primary sortas="b-pl2pm">pl2pm</primary></indexterm> 221 </listitem> 222 </varlistentry> 223 224 <varlistentry id="pod2html"> 225 <term><command>pod2html</command></term> 226 <listitem> 227 <para>Converts files from pod format to HTML format</para> 228 <indexterm zone="ch-system-perl pod2html"><primary sortas="b-pod2html">pod2html</primary></indexterm> 229 </listitem> 230 </varlistentry> 231 232 <varlistentry id="pod2latex"> 233 <term><command>pod2latex</command></term> 234 <listitem> 235 <para>Converts files from pod format to LaTeX format</para> 236 <indexterm zone="ch-system-perl pod2latex"><primary sortas="b-pod2latex">pod2latex</primary></indexterm> 237 </listitem> 238 </varlistentry> 239 240 <varlistentry id="pod2man"> 241 <term><command>pod2man</command></term> 242 <listitem> 243 <para>Converts pod data to formatted *roff input</para> 244 <indexterm zone="ch-system-perl pod2man"><primary sortas="b-pod2man">pod2man</primary></indexterm> 245 </listitem> 246 </varlistentry> 247 248 <varlistentry id="pod2text"> 249 <term><command>pod2text</command></term> 250 <listitem> 251 <para>Converts pod data to formatted ASCII text</para> 252 <indexterm zone="ch-system-perl pod2text"><primary sortas="b-pod2text">pod2text</primary></indexterm> 253 </listitem> 254 </varlistentry> 255 256 <varlistentry id="pod2usage"> 257 <term><command>pod2usage</command></term> 258 <listitem> 259 <para>Prints usage messages from embedded pod docs in files</para> 260 <indexterm zone="ch-system-perl pod2usage"><primary sortas="b-pod2usage">pod2usage</primary></indexterm> 261 </listitem> 262 </varlistentry> 263 264 <varlistentry id="podchecker"> 265 <term><command>podchecker</command></term> 266 <listitem> 267 <para>Checks the syntax of pod format documentation files</para> 268 <indexterm zone="ch-system-perl podchecker"><primary sortas="b-podchecker">podchecker</primary></indexterm> 269 </listitem> 270 </varlistentry> 271 272 <varlistentry id="podselect"> 273 <term><command>podselect</command></term> 274 <listitem> 275 <para>Displays selected sections of pod documentation</para> 276 <indexterm zone="ch-system-perl podselect"><primary sortas="b-podselect">podselect</primary></indexterm> 277 </listitem> 278 </varlistentry> 279 280 <varlistentry id="psed"> 281 <term><command>psed</command></term> 282 <listitem> 283 <para>A Perl version of the stream editor <command>sed</command></para> 284 <indexterm zone="ch-system-perl psed"><primary sortas="b-psed">psed</primary></indexterm> 285 </listitem> 286 </varlistentry> 287 288 <varlistentry id="pstruct"> 289 <term><command>pstruct</command></term> 290 <listitem> 291 <para>Dumps C structures as generated from <command>cc -g -S</command> stabs</para> 292 <indexterm zone="ch-system-perl pstruct"><primary sortas="b-pstruct">pstruct</primary></indexterm> 293 </listitem> 294 </varlistentry> 295 296 <varlistentry id="s2p"> 297 <term><command>s2p</command></term> 298 <listitem> 299 <para>Translates sed to Perl</para> 300 <indexterm zone="ch-system-perl s2p"><primary sortas="b-s2p">s2p</primary></indexterm> 301 </listitem> 302 </varlistentry> 303 304 <varlistentry id="splain"> 305 <term><command>splain</command></term> 306 <listitem> 307 <para>Is used to force verbose warning diagnostics in Perl</para> 308 <indexterm zone="ch-system-perl splain"><primary sortas="b-splain">splain</primary></indexterm> 309 </listitem> 310 </varlistentry> 311 312 <varlistentry id="xsubpp"> 313 <term><command>xsubpp</command></term> 314 <listitem> 315 <para>Converts Perl XS code into C code</para> 316 <indexterm zone="ch-system-perl xsubpp"><primary sortas="b-xsubpp">xsubpp</primary></indexterm> 317 </listitem> 318 </varlistentry> 319 </variablelist> 51 320 52 321 </sect2> 53 322 54 323 </sect1> 324
Note:
See TracChangeset
for help on using the changeset viewer.