Переглянути джерело

chapter06: Translate perl and XML::Parser instruction

Xi Ruoyao 7 роки тому
батько
коміт
de12e889b4
2 змінених файлів з 85 додано та 88 видалено
  1. 81 84
      chapter06/perl.xml
  2. 4 4
      chapter06/xml-parser.xml

+ 81 - 84
chapter06/perl.xml

@@ -23,8 +23,7 @@
   <sect2 role="package">
   <sect2 role="package">
     <title/>
     <title/>
 
 
-    <para>The Perl package contains the Practical Extraction and Report
-    Language.</para>
+    <para>Perl 软件包包含实用报表提取语言。</para>
 
 
     <segmentedlist>
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
       <segtitle>&buildtime;</segtitle>
@@ -39,19 +38,21 @@
   </sect2>
   </sect2>
 
 
   <sect2 role="installation">
   <sect2 role="installation">
-    <title>安装Perl</title>
+    <title>安装 Perl</title>
 
 
-    <para>First create a basic <filename>/etc/hosts</filename> file to be
-    referenced in one of Perl's configuration files as well as the optional
-    test suite:</para>
+    <para>首先创建一个基本的 <filename>/etc/hosts</filename> 文件,
+    Perl 的一个配置文件和可选的测试套件都会引用它:</para>
 
 
 <screen><userinput remap="pre">echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
 <screen><userinput remap="pre">echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
 
 
-    <para>This version of Perl now builds the Compress::Raw::Zlib and 
+    <!--para>This version of Perl now builds the Compress::Raw::Zlib and 
     Compress::Raw::BZip2 modules. By
     Compress::Raw::BZip2 modules. By
     default Perl will use an internal copy of the sources for the build.
     default Perl will use an internal copy of the sources for the build.
     Issue the following command so that Perl will use the libraries
     Issue the following command so that Perl will use the libraries
-    installed on the system:</para>
+    installed on the system:</para-->
+    <para>该版本的 Perl 会构建 Compress::Raw::ZLib 和 Compress::Raw::BZip2
+		模块。默认情况下 Perl 会使用内部的 zlib 和 bzip2 源码副本构建它们,
+		执行下列命令,使得 Perl 使用系统中已经安装好的库:</para>
 
 
 <screen><userinput remap="pre">export BUILD_ZLIB=False
 <screen><userinput remap="pre">export BUILD_ZLIB=False
 export BUILD_BZIP2=0</userinput></screen>
 export BUILD_BZIP2=0</userinput></screen>
@@ -61,10 +62,13 @@ export BUILD_BZIP2=0</userinput></screen>
 
 
 <screen><userinput remap="pre">patch -Np1 -i ../&perl-gcc5-fixes-patch;</userinput></screen>
 <screen><userinput remap="pre">patch -Np1 -i ../&perl-gcc5-fixes-patch;</userinput></screen>
 -->
 -->
-    <para>To have full control over the way Perl is set up, you can remove the
+    <!--para>To have full control over the way Perl is set up, you can remove the
     <quote>-des</quote> options from the following command and hand-pick the way
     <quote>-des</quote> options from the following command and hand-pick the way
     this package is built. Alternatively, use the command exactly as below to
     this package is built. Alternatively, use the command exactly as below to
-    use the defaults that Perl auto-detects:</para>
+    use the defaults that Perl auto-detects:</para-->
+    <para>为了能够完全控制 Perl 的设置,您可以在下列命令中移除
+		<quote>-des</quote> 选项,并手动选择构建该软件包的方式。
+		或者,直接使用下面的命令,以使用 Perl 自动检测的默认值:</para>
 
 
 <screen><userinput remap="configure">sh Configure -des -Dprefix=/usr                 \
 <screen><userinput remap="configure">sh Configure -des -Dprefix=/usr                 \
                   -Dvendorprefix=/usr           \
                   -Dvendorprefix=/usr           \
@@ -75,21 +79,22 @@ export BUILD_BZIP2=0</userinput></screen>
                   -Dusethreads</userinput></screen>
                   -Dusethreads</userinput></screen>
 
 
     <variablelist>
     <variablelist>
-      <title>The meaning of the configure options:</title>
+      <title>配置选项的含义</title>
 
 
       <varlistentry>
       <varlistentry>
         <term><parameter>-Dvendorprefix=/usr</parameter></term>
         <term><parameter>-Dvendorprefix=/usr</parameter></term>
         <listitem>
         <listitem>
-          <para>This ensures <command>perl</command> knows how to
-          tell packages where they should install their perl modules.</para>
+		  <para>这保证 <command>perl</command>
+		  	  知道如何告知软件包应该在哪里安装它们的 perl 模块。</para>
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
       <varlistentry>
       <varlistentry>
         <term><parameter>-Dpager="/usr/bin/less -isR"</parameter></term>
         <term><parameter>-Dpager="/usr/bin/less -isR"</parameter></term>
         <listitem>
         <listitem>
-          <para>This ensures that <userinput>less</userinput> is used instead 
-          of <userinput>more</userinput>.</para>
+		  <para>这保证该软件包使用<userinput>less</userinput>
+		  	  对输出进行分页,而不是使用 <userinput>more</userinput>。
+		  </para>
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
@@ -97,23 +102,22 @@ export BUILD_BZIP2=0</userinput></screen>
         <term><parameter>-Dman1dir=/usr/share/man/man1
         <term><parameter>-Dman1dir=/usr/share/man/man1
         -Dman3dir=/usr/share/man/man3</parameter></term>
         -Dman3dir=/usr/share/man/man3</parameter></term>
         <listitem>
         <listitem>
-          <para>Since Groff is not installed yet, <command>Configure</command>
-          thinks that we do not want man pages for Perl.  Issuing these
-          parameters overrides this decision.</para>
+          <para>由于 Groff 还没有安装,<command>Configure</command>
+          认为我们不需要 Perl 的 man 页面。这些参数覆盖这个判断。</para>
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
       <varlistentry>
       <varlistentry>
         <term><parameter>-Duseshrplib</parameter></term>
         <term><parameter>-Duseshrplib</parameter></term>
         <listitem>
         <listitem>
-          <para>Build a shared libperl needed by some perl modules.</para>
+          <para>构建 libperl 共享库,一些 perl 模块需要它。</para>
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
       <varlistentry>
       <varlistentry>
         <term><parameter>-Dusethreads</parameter></term>
         <term><parameter>-Dusethreads</parameter></term>
         <listitem>
         <listitem>
-          <para>Build perl with support for threads.</para>
+          <para>构建带有线程支持的 perl。</para>
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
@@ -123,14 +127,14 @@ export BUILD_BZIP2=0</userinput></screen>
 
 
 <screen><userinput remap="make">make</userinput></screen>
 <screen><userinput remap="make">make</userinput></screen>
 
 
-    <para>To test the results (approximately 2.5 SBU), issue:</para>
+    <para>为了测试编译结果 (需要约 2.5 SBU),执行下列命令:</para>
 
 
 <screen><userinput remap="test">make -k test</userinput></screen>
 <screen><userinput remap="test">make -k test</userinput></screen>
 
 
-    <note><para>Several tests related to zlib will fail due to using
-    the system version of zlib instead of the internal version.</para></note>
+    <note><para>若干和 zlib 相关的测试会失败,因为使用了系统的 zlib,
+    而不是内部版本。</para></note>
 
 
-    <para>Install the package and clean up:</para>
+    <para>安装该软件包,并清理环境变量:</para>
 
 
 <screen><userinput remap="install">make install
 <screen><userinput remap="install">make install
 unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
 unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
@@ -147,12 +151,12 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
 
 
       <seglistitem>
       <seglistitem>
         <seg>c2ph, corelist, cpan, enc2xs, encguess, h2ph, h2xs, instmodsh,
         <seg>c2ph, corelist, cpan, enc2xs, encguess, h2ph, h2xs, instmodsh,
-        json_pp, libnetcfg, perl, perl&perl-version; (hard link to perl),
-        perlbug, perldoc, perlivp, perlthanks (hard link to perlbug), piconv,
+        json_pp, libnetcfg, perl, perl&perl-version; (指向 perl 的硬链接),
+        perlbug, perldoc, perlivp, perlthanks (指向 perlbug 的硬链接), piconv,
         pl2pm, pod2html, pod2man, pod2text, pod2usage, podchecker, podselect,
         pl2pm, pod2html, pod2man, pod2text, pod2usage, podchecker, podselect,
-        prove, pstruct (hard link to c2ph), ptar, ptardiff, ptargrep, shasum,
-        splain, xsubpp, and zipdetails</seg>
-        <seg>Many which cannot all be listed here</seg>
+        prove, pstruct (指向 c2ph 的硬链接), ptar, ptardiff, ptargrep, shasum,
+        splain, xsubpp, 以及 zipdetails</seg>
+        <seg>很多,无法在这里列出</seg>
         <seg>/usr/lib/perl5</seg>
         <seg>/usr/lib/perl5</seg>
       </seglistitem>
       </seglistitem>
     </segmentedlist>
     </segmentedlist>
@@ -165,8 +169,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="c2ph">
       <varlistentry id="c2ph">
         <term><command>c2ph</command></term>
         <term><command>c2ph</command></term>
         <listitem>
         <listitem>
-          <para>Dumps C structures as generated from
-          <command>cc -g -S</command></para>
+          <para>转储如同
+          <command>cc -g -S</command>生成的 C 结构体</para>
           <indexterm zone="ch-system-perl c2ph">
           <indexterm zone="ch-system-perl c2ph">
             <primary sortas="b-c2ph">c2ph</primary>
             <primary sortas="b-c2ph">c2ph</primary>
           </indexterm>
           </indexterm>
@@ -176,7 +180,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="corelist">
       <varlistentry id="corelist">
         <term><command>corelist</command></term>
         <term><command>corelist</command></term>
         <listitem>
         <listitem>
-          <para>A commandline frontend to Module::CoreList</para>
+          <para>Module::CoreList 的命令行前端</para>
           <indexterm zone="ch-system-perl corelist">
           <indexterm zone="ch-system-perl corelist">
             <primary sortas="b-corelist">corelist</primary>
             <primary sortas="b-corelist">corelist</primary>
           </indexterm>
           </indexterm>
@@ -186,8 +190,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="cpan">
       <varlistentry id="cpan">
         <term><command>cpan</command></term>
         <term><command>cpan</command></term>
         <listitem>
         <listitem>
-          <para>Interact with the Comprehensive Perl Archive Network (CPAN)
-          from the command line</para>
+          <para>通过命令行与综合 Perl 归档网络 (CPAN) 交互</para>
           <indexterm zone="ch-system-perl cpan">
           <indexterm zone="ch-system-perl cpan">
             <primary sortas="b-cpan">cpan</primary>
             <primary sortas="b-cpan">cpan</primary>
           </indexterm>
           </indexterm>
@@ -197,8 +200,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="enc2xs">
       <varlistentry id="enc2xs">
         <term><command>enc2xs</command></term>
         <term><command>enc2xs</command></term>
         <listitem>
         <listitem>
-          <para>Builds a Perl extension for the Encode module from either
-          Unicode Character Mappings or Tcl Encoding Files</para>
+          <para>从 Unicode 字符映射或 Tcl 编码文件构建 Encode 模块使用的
+          Perl 扩展</para>
           <indexterm zone="ch-system-perl enc2xs">
           <indexterm zone="ch-system-perl enc2xs">
             <primary sortas="b-enc2xs">enc2xs</primary>
             <primary sortas="b-enc2xs">enc2xs</primary>
           </indexterm>
           </indexterm>
@@ -208,7 +211,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="encguess">
       <varlistentry id="encguess">
         <term><command>encguess</command></term>
         <term><command>encguess</command></term>
         <listitem>
         <listitem>
-          <para>Guess the encoding type of one or several files</para>
+          <para>猜测一些文件的编码格式</para>
           <indexterm zone="ch-system-perl encguess">
           <indexterm zone="ch-system-perl encguess">
             <primary sortas="b-encguess">encguess</primary>
             <primary sortas="b-encguess">encguess</primary>
           </indexterm>
           </indexterm>
@@ -218,9 +221,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="h2ph">
       <varlistentry id="h2ph">
         <term><command>h2ph</command></term>
         <term><command>h2ph</command></term>
         <listitem>
         <listitem>
-          <para>Converts <filename class="extension">.h</filename> C header
-          files to <filename class="extension">.ph</filename> Perl header
-          files</para>
+          <para>将 <filename class="extension">.h</filename> C 头文件转化为
+          <filename class="extension">.ph</filename> Perl 头文件</para>
           <indexterm zone="ch-system-perl h2ph">
           <indexterm zone="ch-system-perl h2ph">
             <primary sortas="b-h2ph">h2ph</primary>
             <primary sortas="b-h2ph">h2ph</primary>
           </indexterm>
           </indexterm>
@@ -230,8 +232,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="h2xs">
       <varlistentry id="h2xs">
         <term><command>h2xs</command></term>
         <term><command>h2xs</command></term>
         <listitem>
         <listitem>
-          <para>Converts <filename class="extension">.h</filename> C header
-          files to Perl extensions</para>
+          <para>将 <filename class="extension">.h</filename> C 头文件转化为
+          Perl 扩展</para>
           <indexterm zone="ch-system-perl h2xs">
           <indexterm zone="ch-system-perl h2xs">
             <primary sortas="b-h2xs">h2xs</primary>
             <primary sortas="b-h2xs">h2xs</primary>
           </indexterm>
           </indexterm>
@@ -241,8 +243,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="instmodsh">
       <varlistentry id="instmodsh">
         <term><command>instmodsh</command></term>
         <term><command>instmodsh</command></term>
         <listitem>
         <listitem>
-          <para>Shell script for examining installed Perl modules,
-          and can create a tarball from an installed module</para>
+          <para>用于检验安装好的 Perl 模块的 shell 脚本,
+          可以从安装好的模块创建压缩包</para>
           <indexterm zone="ch-system-perl instmodsh">
           <indexterm zone="ch-system-perl instmodsh">
             <primary sortas="b-instmodsh">instmodsh</primary>
             <primary sortas="b-instmodsh">instmodsh</primary>
           </indexterm>
           </indexterm>
@@ -252,7 +254,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="json_pp">
       <varlistentry id="json_pp">
         <term><command>json_pp</command></term>
         <term><command>json_pp</command></term>
         <listitem>
         <listitem>
-          <para>Converts data between certain input and output formats</para>
+          <para>在特定输入输出格式之间转化数据</para>
           <indexterm zone="ch-system-perl json_pp">
           <indexterm zone="ch-system-perl json_pp">
             <primary sortas="b-json_pp">json_pp</primary>
             <primary sortas="b-json_pp">json_pp</primary>
           </indexterm>
           </indexterm>
@@ -262,8 +264,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="libnetcfg">
       <varlistentry id="libnetcfg">
         <term><command>libnetcfg</command></term>
         <term><command>libnetcfg</command></term>
         <listitem>
         <listitem>
-          <para>Can be used to configure the
-          <filename class="libraryfile">libnet</filename> Perl module</para>
+          <para>可以被用于配置
+          <filename class="libraryfile">libnet</filename> Perl 模块</para>
           <indexterm zone="ch-system-perl libnetcfg">
           <indexterm zone="ch-system-perl libnetcfg">
             <primary sortas="b-libnetcfg">libnetcfg</primary>
             <primary sortas="b-libnetcfg">libnetcfg</primary>
           </indexterm>
           </indexterm>
@@ -273,9 +275,9 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perl">
       <varlistentry id="perl">
         <term><command>perl</command></term>
         <term><command>perl</command></term>
         <listitem>
         <listitem>
-          <para>Combines some of the best features of C, <command>sed</command>,
-          <command>awk</command> and <command>sh</command> into a single
-          swiss-army language</para>
+          <para>由 C 语言、<command>sed</command>、
+          <command>awk</command> 和 <command>sh</command>
+          的最好特性结合成的一门瑞士军刀式语言</para>
           <indexterm zone="ch-system-perl perl">
           <indexterm zone="ch-system-perl perl">
             <primary sortas="b-perl">perl</primary>
             <primary sortas="b-perl">perl</primary>
           </indexterm>
           </indexterm>
@@ -285,7 +287,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perl-version">
       <varlistentry id="perl-version">
         <term><command>perl&perl-version;</command></term>
         <term><command>perl&perl-version;</command></term>
         <listitem>
         <listitem>
-          <para>A hard link to <command>perl</command></para>
+          <para>指向 <command>perl</command> 的硬链接</para>
           <indexterm zone="ch-system-perl perl-version">
           <indexterm zone="ch-system-perl perl-version">
             <primary sortas="b-perl&perl-version;">perl&perl-version;</primary>
             <primary sortas="b-perl&perl-version;">perl&perl-version;</primary>
           </indexterm>
           </indexterm>
@@ -295,8 +297,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perlbug">
       <varlistentry id="perlbug">
         <term><command>perlbug</command></term>
         <term><command>perlbug</command></term>
         <listitem>
         <listitem>
-          <para>Used to generate bug reports about Perl, or the modules that come
-          with it, and mail them</para>
+          <para>用于创建关于 Perl 或者它附带的模块的 bug 报告,
+          并用邮件发送它们</para>
           <indexterm zone="ch-system-perl perlbug">
           <indexterm zone="ch-system-perl perlbug">
             <primary sortas="b-perlbug">perlbug</primary>
             <primary sortas="b-perlbug">perlbug</primary>
           </indexterm>
           </indexterm>
@@ -306,8 +308,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perldoc">
       <varlistentry id="perldoc">
         <term><command>perldoc</command></term>
         <term><command>perldoc</command></term>
         <listitem>
         <listitem>
-          <para>Displays a piece of documentation in pod format that is embedded
-          in the Perl installation tree or in a Perl script</para>
+          <para>显示集成在 Perl 安装目录树或某个 Perl 脚本中的一页
+          pod 格式文档</para>
           <indexterm zone="ch-system-perl perldoc">
           <indexterm zone="ch-system-perl perldoc">
             <primary sortas="b-perldoc">perldoc</primary>
             <primary sortas="b-perldoc">perldoc</primary>
           </indexterm>
           </indexterm>
@@ -317,9 +319,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perlivp">
       <varlistentry id="perlivp">
         <term><command>perlivp</command></term>
         <term><command>perlivp</command></term>
         <listitem>
         <listitem>
-          <para>The Perl Installation Verification Procedure; it can be used to
-          verify that Perl and its libraries have been installed
-          correctly</para>
+          <para>Perl 安装检验程序;它可以被用于确认 Perl
+          	  和它的库都安装正确</para>
           <indexterm zone="ch-system-perl perlivp">
           <indexterm zone="ch-system-perl perlivp">
             <primary sortas="b-perlivp">perlivp</primary>
             <primary sortas="b-perlivp">perlivp</primary>
           </indexterm>
           </indexterm>
@@ -329,8 +330,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="perlthanks">
       <varlistentry id="perlthanks">
         <term><command>perlthanks</command></term>
         <term><command>perlthanks</command></term>
         <listitem>
         <listitem>
-          <para>Used to generate thank you messages to mail to the Perl
-          developers</para>
+          <para>用于生成发送给 Perl 开发者的感谢信</para>
           <indexterm zone="ch-system-perl perlthanks">
           <indexterm zone="ch-system-perl perlthanks">
             <primary sortas="b-perlthanks">perlthanks</primary>
             <primary sortas="b-perlthanks">perlthanks</primary>
           </indexterm>
           </indexterm>
@@ -340,8 +340,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="piconv">
       <varlistentry id="piconv">
         <term><command>piconv</command></term>
         <term><command>piconv</command></term>
         <listitem>
         <listitem>
-          <para>A Perl version of the character encoding converter
-          <command>iconv</command></para>
+          <para>字符编码转换器
+          <command>iconv</command> 的 Perl 版本</para>
           <indexterm zone="ch-system-perl piconv">
           <indexterm zone="ch-system-perl piconv">
             <primary sortas="b-piconv">piconv</primary>
             <primary sortas="b-piconv">piconv</primary>
           </indexterm>
           </indexterm>
@@ -351,9 +351,9 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pl2pm">
       <varlistentry id="pl2pm">
         <term><command>pl2pm</command></term>
         <term><command>pl2pm</command></term>
         <listitem>
         <listitem>
-          <para>A rough tool for converting Perl4
-          <filename class="extension">.pl</filename> files to Perl5
-          <filename class="extension">.pm</filename> modules</para>
+          <para>一个用于将 Perl4
+          <filename class="extension">.pl</filename> 文件转换成 Perl5
+          <filename class="extension">.pm</filename> 模块的粗糙工具</para>
           <indexterm zone="ch-system-perl pl2pm">
           <indexterm zone="ch-system-perl pl2pm">
             <primary sortas="b-pl2pm">pl2pm</primary>
             <primary sortas="b-pl2pm">pl2pm</primary>
           </indexterm>
           </indexterm>
@@ -363,7 +363,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pod2html">
       <varlistentry id="pod2html">
         <term><command>pod2html</command></term>
         <term><command>pod2html</command></term>
         <listitem>
         <listitem>
-          <para>Converts files from pod format to HTML format</para>
+          <para>将 pod 格式的文件转换为 HTML 格式</para>
           <indexterm zone="ch-system-perl pod2html">
           <indexterm zone="ch-system-perl pod2html">
             <primary sortas="b-pod2html">pod2html</primary>
             <primary sortas="b-pod2html">pod2html</primary>
           </indexterm>
           </indexterm>
@@ -373,7 +373,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pod2man">
       <varlistentry id="pod2man">
         <term><command>pod2man</command></term>
         <term><command>pod2man</command></term>
         <listitem>
         <listitem>
-          <para>Converts pod data to formatted *roff input</para>
+          <para>将 pod 数据转换为格式化的 *roff 输入</para>
           <indexterm zone="ch-system-perl pod2man">
           <indexterm zone="ch-system-perl pod2man">
             <primary sortas="b-pod2man">pod2man</primary>
             <primary sortas="b-pod2man">pod2man</primary>
           </indexterm>
           </indexterm>
@@ -383,7 +383,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pod2text">
       <varlistentry id="pod2text">
         <term><command>pod2text</command></term>
         <term><command>pod2text</command></term>
         <listitem>
         <listitem>
-          <para>Converts pod data to formatted ASCII text</para>
+          <para>将 pod 数据转化为格式化的 ASCII 文本</para>
           <indexterm zone="ch-system-perl pod2text">
           <indexterm zone="ch-system-perl pod2text">
             <primary sortas="b-pod2text">pod2text</primary>
             <primary sortas="b-pod2text">pod2text</primary>
           </indexterm>
           </indexterm>
@@ -393,7 +393,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pod2usage">
       <varlistentry id="pod2usage">
         <term><command>pod2usage</command></term>
         <term><command>pod2usage</command></term>
         <listitem>
         <listitem>
-          <para>Prints usage messages from embedded pod docs in files</para>
+          <para>输出文件中嵌入的 pod 文档中的使用方法信息</para>
           <indexterm zone="ch-system-perl pod2usage">
           <indexterm zone="ch-system-perl pod2usage">
             <primary sortas="b-pod2usage">pod2usage</primary>
             <primary sortas="b-pod2usage">pod2usage</primary>
           </indexterm>
           </indexterm>
@@ -403,7 +403,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="podchecker">
       <varlistentry id="podchecker">
         <term><command>podchecker</command></term>
         <term><command>podchecker</command></term>
         <listitem>
         <listitem>
-          <para>Checks the syntax of pod format documentation files</para>
+          <para>检查 pod 格式文档文件的语法</para>
           <indexterm zone="ch-system-perl podchecker">
           <indexterm zone="ch-system-perl podchecker">
             <primary sortas="b-podchecker">podchecker</primary>
             <primary sortas="b-podchecker">podchecker</primary>
           </indexterm>
           </indexterm>
@@ -413,7 +413,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="podselect">
       <varlistentry id="podselect">
         <term><command>podselect</command></term>
         <term><command>podselect</command></term>
         <listitem>
         <listitem>
-          <para>Displays selected sections of pod documentation</para>
+          <para>显示 pod 文档中的指定章节</para>
           <indexterm zone="ch-system-perl podselect">
           <indexterm zone="ch-system-perl podselect">
             <primary sortas="b-podselect">podselect</primary>
             <primary sortas="b-podselect">podselect</primary>
           </indexterm>
           </indexterm>
@@ -423,8 +423,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="prove">
       <varlistentry id="prove">
         <term><command>prove</command></term>
         <term><command>prove</command></term>
         <listitem>
         <listitem>
-          <para>Command line tool for running tests against the Test::Harness
-          module</para>
+          <para>用于运行使用 Test::Harness 模块的测试</para>
           <indexterm zone="ch-system-perl prove">
           <indexterm zone="ch-system-perl prove">
             <primary sortas="b-prove">prove</primary>
             <primary sortas="b-prove">prove</primary>
           </indexterm>
           </indexterm>
@@ -434,8 +433,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="pstruct">
       <varlistentry id="pstruct">
         <term><command>pstruct</command></term>
         <term><command>pstruct</command></term>
         <listitem>
         <listitem>
-          <para>Dumps C structures as generated from <command>cc -g -S</command>
-          stabs</para>
+          <para>转储如同 <command>cc -g -S</command>
+          生成的结构体符号表</para>
           <indexterm zone="ch-system-perl pstruct">
           <indexterm zone="ch-system-perl pstruct">
             <primary sortas="b-pstruct">pstruct</primary>
             <primary sortas="b-pstruct">pstruct</primary>
           </indexterm>
           </indexterm>
@@ -445,7 +444,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="ptar">
       <varlistentry id="ptar">
         <term><command>ptar</command></term>
         <term><command>ptar</command></term>
         <listitem>
         <listitem>
-          <para>A <command>tar</command>-like program written in Perl</para>
+          <para>一个 Perl 编写的类似 <command>tar</command> 的程序</para>
           <indexterm zone="ch-system-perl ptar">
           <indexterm zone="ch-system-perl ptar">
             <primary sortas="b-ptar">ptar</primary>
             <primary sortas="b-ptar">ptar</primary>
           </indexterm>
           </indexterm>
@@ -455,8 +454,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="ptardiff">
       <varlistentry id="ptardiff">
         <term><command>ptardiff</command></term>
         <term><command>ptardiff</command></term>
         <listitem>
         <listitem>
-          <para>A Perl program that compares an extracted archive with an
-          unextracted one</para>
+          <para>一个比较压缩档案和未压缩版本的 Perl 程序</para>
           <indexterm zone="ch-system-perl ptardiff">
           <indexterm zone="ch-system-perl ptardiff">
             <primary sortas="b-ptardiff">ptardiff</primary>
             <primary sortas="b-ptardiff">ptardiff</primary>
           </indexterm>
           </indexterm>
@@ -466,8 +464,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="ptargrep">
       <varlistentry id="ptargrep">
         <term><command>ptargrep</command></term>
         <term><command>ptargrep</command></term>
         <listitem>
         <listitem>
-          <para>A Perl program that applies pattern matching to the contents
-          of files in a tar archive</para>
+          <para>一个在 tar 档案中的文件内容上进行模式匹配的 Perl 程序</para>
           <indexterm zone="ch-system-perl ptargrep">
           <indexterm zone="ch-system-perl ptargrep">
             <primary sortas="b-ptargrep">ptargrep</primary>
             <primary sortas="b-ptargrep">ptargrep</primary>
           </indexterm>
           </indexterm>
@@ -477,7 +474,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="shasum">
       <varlistentry id="shasum">
         <term><command>shasum</command></term>
         <term><command>shasum</command></term>
         <listitem>
         <listitem>
-          <para>Prints or checks SHA checksums</para>
+          <para>打印或检查 SHA 校验和</para>
           <indexterm zone="ch-system-perl shasum">
           <indexterm zone="ch-system-perl shasum">
             <primary sortas="b-shasum">shasum</primary>
             <primary sortas="b-shasum">shasum</primary>
           </indexterm>
           </indexterm>
@@ -487,7 +484,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="splain">
       <varlistentry id="splain">
         <term><command>splain</command></term>
         <term><command>splain</command></term>
         <listitem>
         <listitem>
-          <para>Is used to force verbose warning diagnostics in Perl</para>
+          <para>被用于 Perl 的强制性详细警告诊断</para>
           <indexterm zone="ch-system-perl splain">
           <indexterm zone="ch-system-perl splain">
             <primary sortas="b-splain">splain</primary>
             <primary sortas="b-splain">splain</primary>
           </indexterm>
           </indexterm>
@@ -497,7 +494,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="xsubpp">
       <varlistentry id="xsubpp">
         <term><command>xsubpp</command></term>
         <term><command>xsubpp</command></term>
         <listitem>
         <listitem>
-          <para>Converts Perl XS code into C code</para>
+          <para>将 Perl XS 代码转换为 C 代码</para>
           <indexterm zone="ch-system-perl xsubpp">
           <indexterm zone="ch-system-perl xsubpp">
             <primary sortas="b-xsubpp">xsubpp</primary>
             <primary sortas="b-xsubpp">xsubpp</primary>
           </indexterm>
           </indexterm>
@@ -507,7 +504,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="zipdetails">
       <varlistentry id="zipdetails">
         <term><command>zipdetails</command></term>
         <term><command>zipdetails</command></term>
         <listitem>
         <listitem>
-          <para>Displays details about the internal structure of a Zip file</para>
+          <para>显示 Zip 文件内部结构的详细信息</para>
           <indexterm zone="ch-system-perl zipdetails">
           <indexterm zone="ch-system-perl zipdetails">
             <primary sortas="b-zipdetails">zipdetails</primary>
             <primary sortas="b-zipdetails">zipdetails</primary>
           </indexterm>
           </indexterm>

+ 4 - 4
chapter06/xml-parser.xml

@@ -23,8 +23,8 @@
   <sect2 role="package">
   <sect2 role="package">
     <title/>
     <title/>
 
 
-    <para>The XML::Parser module is a Perl interface to James Clark's
-    XML parser, Expat.</para>
+    <para>XML::Parser 模块是 James Clark 的 XML 解析器 Expat 的
+    Perl 接口。</para>
 
 
     <segmentedlist>
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
       <segtitle>&buildtime;</segtitle>
@@ -63,7 +63,7 @@
     <title>XML::Parser 的内容</title>
     <title>XML::Parser 的内容</title>
 
 
     <segmentedlist>
     <segmentedlist>
-      <segtitle>Installed module</segtitle>
+      <segtitle>安装的模块</segtitle>
 
 
       <seglistitem>
       <seglistitem>
         <seg>Expat.so</seg>
         <seg>Expat.so</seg>
@@ -78,7 +78,7 @@
       <varlistentry id="Expat">
       <varlistentry id="Expat">
         <term><filename class="libraryfile">Expat</filename></term>
         <term><filename class="libraryfile">Expat</filename></term>
         <listitem>
         <listitem>
-          <para>provides the Perl Expat interface</para>
+          <para>提供 Expat 的 Perl 接口</para>
           <indexterm zone="ch-system-xml-parser Expat">
           <indexterm zone="ch-system-xml-parser Expat">
             <primary sortas="c-Expat">Expat</primary>
             <primary sortas="c-Expat">Expat</primary>
           </indexterm>
           </indexterm>