chapter06: Translate groff instruction

chapter06/groff.xml

@@ -23,8 +23,7 @@
   <sect2 role="package">
     <title/>
 
-    <para>The Groff package contains programs for processing and formatting
-    text.</para>
+    <para>Groff 软件包包含处理和格式化文本的程序。</para>
 
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
@@ -39,21 +38,20 @@
   </sect2>
 
   <sect2 role="installation">
-    <title>安装Groff</title>
+    <title>安装 Groff</title>
 
-    <para>Groff expects the environment variable <envar>PAGE</envar> to
-    contain the default paper size. For users in the United States,
-    <parameter>PAGE=letter</parameter> is appropriate. Elsewhere,
-    <parameter>PAGE=A4</parameter> may be more suitable. While the default
-    paper size is configured during compilation, it can be overridden later
-    by echoing either <quote>A4</quote> or <quote>letter</quote> to the
-    <filename>/etc/papersize</filename> file.</para>
+    <para>Groff 期望环境变量 <envar>PAGE</envar> 包含默认纸张大小。
+		对于美国用户来说，<parameter>PAGE=letter</parameter> 是正确的。
+		对于其他地方的用户，<parameter>PAGE=A4</parameter> 可能更好。
+		尽管在编译时配置了默认纸张大小，可以通过向
+		<filename>/etc/papersize</filename> 文件写入
+		<quote>A4</quote> 或 <quote>letter</quote> 覆盖默认值。</para>
 
     <para>准备安装 Groff：</para>
 
 <screen><userinput remap="configure">PAGE=<replaceable>&lt;paper_size&gt;</replaceable> ./configure --prefix=/usr</userinput></screen>
 
-    <para>This package does not support parallel build. 编译该软件包：</para>
+    <para>该软件包不支持并行构建。编译该软件包：</para>
 
 <screen><userinput remap="make">make -j1</userinput></screen>
 
@@ -78,7 +76,7 @@
         grolj4, gropdf, grops, grotty, hpftodit, indxbib, lkbib, lookbib,
         mmroff, neqn, nroff, pdfmom, pdfroff, pfbtops, pic, pic2graph,
         post-grohtml, preconv, pre-grohtml, refer, roff2dvi, roff2html,
-        roff2pdf, roff2ps, roff2text, roff2x, soelim, tbl, tfmtodit, and
+        roff2pdf, roff2ps, roff2text, roff2x, soelim, tbl, tfmtodit, 以及
         troff</seg>
         <seg>/usr/lib/groff and /usr/share/doc/groff-&groff-version;,
         /usr/share/groff</seg>
@@ -93,8 +91,8 @@
       <varlistentry id="addftinfo">
         <term><command>addftinfo</command></term>
         <listitem>
-          <para>Reads a troff font file and adds some additional font-metric
-          information that is used by the <command>groff</command> system</para>
+          <para>读取 troff 字体文件并为其添加 <command>groff</command>
+          系统使用的一些额外字体规格信息</para>
           <indexterm zone="ch-system-groff addftinfo">
             <primary sortas="b-addftinfo">addftinfo</primary>
           </indexterm>
@@ -104,8 +102,8 @@
       <varlistentry id="afmtodit">
         <term><command>afmtodit</command></term>
         <listitem>
-          <para>Creates a font file for use with <command>groff</command> and
-          <command>grops</command></para>
+          <para>创建供 <command>groff</command> 和
+          <command>grops</command> 使用的字体文件</para>
           <indexterm zone="ch-system-groff afmtodit">
             <primary sortas="b-afmtodit">afmtodit</primary>
           </indexterm>
@@ -115,7 +113,7 @@
       <varlistentry id="chem">
         <term><command>chem</command></term>
         <listitem>
-          <para>Groff preprocessor for producing chemical structure diagrams</para>
+          <para>产生化学结构式的 groff 预处理器</para>
           <indexterm zone="ch-system-groff chem">
             <primary sortas="b-chem">chem</primary>
           </indexterm>
@@ -125,9 +123,8 @@
       <varlistentry id="eqn">
         <term><command>eqn</command></term>
         <listitem>
-          <para>Compiles descriptions of equations embedded within troff
-          input files into commands that are understood by
-          <command>troff</command></para>
+          <para>将 troff 输入文件中嵌入的公式描述编译成
+          <command>troff</command> 理解的命令</para>
           <indexterm zone="ch-system-groff eqn">
             <primary sortas="b-eqn">eqn</primary>
           </indexterm>
@@ -137,7 +134,7 @@
       <varlistentry id="eqn2graph">
         <term><command>eqn2graph</command></term>
         <listitem>
-          <para>Converts a troff EQN (equation) into a cropped image</para>
+          <para>将 troff EQN （公式）转换成裁减好的图像</para>
           <indexterm zone="ch-system-groff eqn2graph">
             <primary sortas="b-eqn2graph">eqn2graph</primary>
           </indexterm>
@@ -147,7 +144,7 @@
       <varlistentry id="gdiffmk">
         <term><command>gdiffmk</command></term>
         <listitem>
-          <para>Marks differences between groff/nroff/troff files</para>
+			<para>标出 groff/nroff/troff 文件的区别</para>
           <indexterm zone="ch-system-groff gdiffmk">
             <primary sortas="b-gdiffmk">gdiffmk</primary>
           </indexterm>
@@ -157,8 +154,7 @@
       <varlistentry id="glilypond">
         <term><command>glilypond</command></term>
         <listitem>
-          <para>Transforms sheet music written in the lilypond language into
-          the groff language</para>
+          <para>将 lilypond 语言写成的乐谱转换为 groff 语言</para>
           <indexterm zone="ch-system-groff glilypond">
             <primary sortas="b-glilypond">glilypond</primary>
           </indexterm>
@@ -168,8 +164,7 @@
       <varlistentry id="gperl">
         <term><command>gperl</command></term>
         <listitem>
-          <para>Preprocesor for groff, allowing addition of perl code
-          into groff files</para>
+          <para>groff 预处理器，允许在 groff 文件中增加 perl 代码</para>
           <indexterm zone="ch-system-groff gperl">
             <primary sortas="b-gperl">gperl</primary>
           </indexterm>
@@ -179,8 +174,7 @@
       <varlistentry id="gpinyin">
         <term><command>gpinyin</command></term>
         <listitem>
-          <para>Preprocesor for groff, allowing addition of Chinese
-          European-like language Pinyin into groff files.</para>
+          <para>groff 的预处理器，允许在 groff 文件中增加汉语拼音</para>
           <indexterm zone="ch-system-groff gpinyin">
             <primary sortas="b-gpinyin">gpinyin</primary>
           </indexterm>
@@ -190,7 +184,7 @@
       <varlistentry id="grap2graph">
         <term><command>grap2graph</command></term>
         <listitem>
-          <para>Converts a grap diagram into a cropped bitmap image</para>
+          <para>将 grap 图形转换成裁减好的位图图像</para>
           <indexterm zone="ch-system-groff grap2graph">
             <primary sortas="b-grap2graph">grap2graph</primary>
           </indexterm>
@@ -200,7 +194,7 @@
       <varlistentry id="grn">
         <term><command>grn</command></term>
         <listitem>
-          <para>A <command>groff</command> preprocessor for gremlin files</para>
+          <para>用于 gremlin 文件的<command>groff</command> 预处理器</para>
           <indexterm zone="ch-system-groff grn">
             <primary sortas="b-grn">grn</primary>
           </indexterm>
@@ -210,8 +204,8 @@
       <varlistentry id="grodvi">
         <term><command>grodvi</command></term>
         <listitem>
-          <para>A driver for <command>groff</command> that produces TeX dvi
-          format</para>
+          <para><command>groff</command> 的驱动程序，
+          	  生成 TeX dvi 格式</para>
           <indexterm zone="ch-system-groff grodvi">
             <primary sortas="b-grodvi">grodvi</primary>
           </indexterm>
@@ -221,9 +215,9 @@
       <varlistentry id="groff">
         <term><command>groff</command></term>
         <listitem>
-          <para>A front-end to the groff document formatting system; normally, it
-          runs the <command>troff</command> program and a post-processor
-          appropriate for the selected device</para>
+          <para>groff 文档格式化系统的前端；一般来说，它运行
+          <command>troff</command> 程序和一个适用于选定设备的后处理器
+          </para>
           <indexterm zone="ch-system-groff groff">
             <primary sortas="b-groff">groff</primary>
           </indexterm>
@@ -233,7 +227,7 @@
       <varlistentry id="groffer">
         <term><command>groffer</command></term>
         <listitem>
-          <para>Displays groff files and man pages on X and tty terminals</para>
+          <para>在 X 和 tty 终端显示 groff 文件和 man 页面</para>
           <indexterm zone="ch-system-groff groffer">
             <primary sortas="b-groffer">groffer</primary>
           </indexterm>
@@ -243,12 +237,12 @@
       <varlistentry id="grog">
         <term><command>grog</command></term>
         <listitem>
-          <para>Reads files and guesses which of the <command>groff</command>
-          options <option>-e</option>, <option>-man</option>, <option>-me</option>,
+          <para>读取文件，并猜测 <command>groff</command> 选项
+          <option>-e</option>, <option>-man</option>, <option>-me</option>,
           <option>-mm</option>, <option>-ms</option>, <option>-p</option>,
-          <option>-s</option>, and <option>-t</option> are required for printing
-          files, and reports the <command>groff</command> command including those
-          options</para>
+		  <option>-s</option>, 以及 <option>-t</option>
+		  中哪一个在打印文件时时必须的，并报告包含这些选项的
+		  <command>groff</command> 命令</para>
           <indexterm zone="ch-system-groff grog">
             <primary sortas="b-grog">grog</primary>
           </indexterm>
@@ -258,8 +252,9 @@
       <varlistentry id="grolbp">
         <term><command>grolbp</command></term>
         <listitem>
-          <para>Is a <command>groff</command> driver for Canon CAPSL printers
-          (LBP-4 and LBP-8 series laser printers)</para>
+			<para>是一个用于 Canon CAPSL 打印机
+				（LBP-4 和 LBP-8 系列激光打印机）的
+				<command>groff</command> 驱动程序</para>
           <indexterm zone="ch-system-groff grolbp">
             <primary sortas="b-grolbp">grolbp</primary>
           </indexterm>
@@ -269,8 +264,8 @@
       <varlistentry id="grolj4">
         <term><command>grolj4</command></term>
         <listitem>
-          <para>Is a driver for <command>groff</command> that produces output
-          in PCL5 format suitable for an HP LaserJet 4 printer</para>
+          <para>是一个生成用于 HP LaserJet 4 打印机的 PCL5 格式的
+			  <command>groff</command> 驱动程序</para>
           <indexterm zone="ch-system-groff grolj4">
             <primary sortas="b-grolj4">grolj4</primary>
           </indexterm>
@@ -280,8 +275,7 @@
       <varlistentry id="gropdf">
         <term><command>gropdf</command></term>
         <listitem>
-          <para>Translates the output of GNU <command>troff</command> to
-          PDF</para>
+          <para>将 <command>troff</command> 输出转换成 PDF</para>
           <indexterm zone="ch-system-groff gropdf">
             <primary sortas="b-gropdf">gropdf</primary>
           </indexterm>
@@ -291,8 +285,7 @@
       <varlistentry id="grops">
         <term><command>grops</command></term>
         <listitem>
-          <para>Translates the output of GNU <command>troff</command> to
-          PostScript</para>
+          <para>将 <command>troff</command> 输出转换成 PostScript</para>
           <indexterm zone="ch-system-groff grops">
             <primary sortas="b-grops">grops</primary>
           </indexterm>
@@ -302,8 +295,8 @@
       <varlistentry id="grotty">
         <term><command>grotty</command></term>
         <listitem>
-          <para>Translates the output of GNU <command>troff</command> into
-          a form suitable for typewriter-like devices</para>
+          <para>将 <command>troff</command>
+			  输出转换成用于打字机类设备的形式</para>
           <indexterm zone="ch-system-groff grotty">
             <primary sortas="b-grotty">grotty</primary>
           </indexterm>
@@ -313,8 +306,8 @@
       <varlistentry id="hpftodit">
         <term><command>hpftodit</command></term>
         <listitem>
-          <para>Creates a font file for use with <command>groff -Tlj4</command>
-          from an HP-tagged font metric file</para>
+          <para>根据 HP 标签的字体规格文件，
+          	  创建用于 <command>groff -Tlj4</command>的字体文件</para>
           <indexterm zone="ch-system-groff hpftodit">
             <primary sortas="b-hpftodit">hpftodit</primary>
           </indexterm>
@@ -324,9 +317,9 @@
       <varlistentry id="indxbib">
         <term><command>indxbib</command></term>
         <listitem>
-          <para>Creates an inverted index for the bibliographic databases with a
-          specified file for use with <command>refer</command>,
-          <command>lookbib</command>, and <command>lkbib</command></para>
+          <para>创建用于给定文件文献数据库的反向索引，
+          	  以供 <command>refer</command>、<command>lookbib</command>
+          	  以及 <command>lkbib</command> 使用</para>
           <indexterm zone="ch-system-groff indxbib">
             <primary sortas="b-indxbib">indxbib</primary>
           </indexterm>
@@ -336,8 +329,8 @@
       <varlistentry id="lkbib">
         <term><command>lkbib</command></term>
         <listitem>
-          <para>Searches bibliographic databases for references that contain
-          specified keys and reports any references found</para>
+          <para>在文献数据库中搜索包含指定关键字的引用，
+          	  并报告找到的所有引用</para>
           <indexterm zone="ch-system-groff lkbib">
             <primary sortas="b-lkbib">lkbib</primary>
           </indexterm>
@@ -347,12 +340,16 @@
       <varlistentry id="lookbib">
         <term><command>lookbib</command></term>
         <listitem>
-          <para>Prints a prompt on the standard error (unless the standard input
+          <!--para>Prints a prompt on the standard error (unless the standard input
           is not a terminal), reads a line containing a set of keywords from the
           standard input, searches the bibliographic databases in a specified file
           for references containing those keywords, prints any references found
           on the standard output, and repeats this process until the end of
-          input</para>
+          input</para-->
+          <para>在标准错误输出上显示命令提示符（除非标准输入不是终端），
+			  读取包含一组关键字的行，
+			  在给定文件的文献数据库中搜索包含这些关键字的引用，
+			  将它们打印到标准输出，重复这一过程直到输入结束</para>
           <indexterm zone="ch-system-groff lookbib">
             <primary sortas="b-lookbib">lookbib</primary>
           </indexterm>
@@ -362,7 +359,7 @@
       <varlistentry id="mmroff">
         <term><command>mmroff</command></term>
         <listitem>
-          <para>A simple preprocessor for <command>groff</command></para>
+          <para><command>groff</command> 的简单预处理器</para>
           <indexterm zone="ch-system-groff mmroff">
             <primary sortas="b-mmroff">mmroff</primary>
           </indexterm>
@@ -372,8 +369,7 @@
       <varlistentry id="neqn">
         <term><command>neqn</command></term>
         <listitem>
-          <para>Formats equations for American Standard Code for Information
-          Interchange (ASCII) output</para>
+          <para>将公式格式化为美国标准信息交换代码（ASCII）输出</para>
           <indexterm zone="ch-system-groff neqn">
             <primary sortas="b-neqn">neqn</primary>
           </indexterm>
@@ -383,8 +379,8 @@
       <varlistentry id="nroff">
         <term><command>nroff</command></term>
         <listitem>
-          <para>A script that emulates the <command>nroff</command> command
-          using <command>groff</command></para>
+          <para>一个使用 <command>groff</command> 仿真
+          <command>nroff</command> 命令的脚本</para>
           <indexterm zone="ch-system-groff nroff">
             <primary sortas="b-nroff">nroff</primary>
           </indexterm>
@@ -394,8 +390,8 @@
       <varlistentry id="pdfmom">
         <term><command>pdfmom</command></term>
         <listitem>
-          <para>Is a wrapper around groff that facilitates the production of PDF
-          documents from files formatted with the mom macros.</para>
+          <para>一个 groff 包装器，提供从 mom 宏包编码的文件转换为 PDF
+          文档的功能</para>
           <indexterm zone="ch-system-groff pdfmom">
             <primary sortas="b-pdfmom">pdfmom</primary>
           </indexterm>
@@ -405,7 +401,7 @@
       <varlistentry id="pdfroff">
         <term><command>pdfroff</command></term>
         <listitem>
-          <para>Creates pdf documents using groff</para>
+          <para>用 groff 创建 PDF 文档</para>
           <indexterm zone="ch-system-groff pdfroff">
             <primary sortas="b-pdfroff">pdfroff</primary>
           </indexterm>
@@ -415,8 +411,8 @@
       <varlistentry id="pfbtops">
         <term><command>pfbtops</command></term>
         <listitem>
-          <para>Translates a PostScript font in <filename
-          class="extension">.pfb</filename> format to ASCII</para>
+          <para>将 <filename class="extension">.pfb</filename>
+          	  格式的 PostScript 字体转换为 ASCII</para>
           <indexterm zone="ch-system-groff pfbtops">
             <primary sortas="b-pfbtops">pfbtops</primary>
           </indexterm>
@@ -426,9 +422,8 @@
       <varlistentry id="pic">
         <term><command>pic</command></term>
         <listitem>
-          <para>Compiles descriptions of pictures embedded within troff or
-          TeX input files into commands understood by TeX or
-          <command>troff</command></para>
+          <para>将 troff 或 TeX 输入文件中嵌入的图片描述编译成
+          	  TeX 或 <command>troff</command> 理解的命令</para>
           <indexterm zone="ch-system-groff pic">
             <primary sortas="b-pic">pic</primary>
           </indexterm>
@@ -438,7 +433,7 @@
       <varlistentry id="pic2graph">
         <term><command>pic2graph</command></term>
         <listitem>
-          <para>Converts a PIC diagram into a cropped image</para>
+          <para>将 PIC 图示转换成裁切好的图像</para>
           <indexterm zone="ch-system-groff pic2graph">
             <primary sortas="b-pic2graph">pic2graph</primary>
           </indexterm>
@@ -448,8 +443,7 @@
       <varlistentry id="post-grohtml">
         <term><command>post-grohtml</command></term>
         <listitem>
-          <para>Translates the output of GNU <command>troff</command> to
-          HTML</para>
+          <para>将 GNU <command>troff</command> 的输出翻译成 HTML</para>
           <indexterm zone="ch-system-groff post-grohtml">
             <primary sortas="b-post-grohtml">post-grohtml</primary>
           </indexterm>
@@ -459,8 +453,8 @@
       <varlistentry id="preconv">
         <term><command>preconv</command></term>
         <listitem>
-          <para>Converts encoding of input files to something GNU
-          <command>troff</command> understands</para>
+          <para>将输入文件的编码转换成 GNU
+          <command>troff</command> 理解的格式</para>
           <indexterm zone="ch-system-groff preconv">
             <primary sortas="b-preconv">preconv</primary>
           </indexterm>
@@ -470,8 +464,7 @@
       <varlistentry id="pre-grohtml">
         <term><command>pre-grohtml </command></term>
         <listitem>
-          <para>Translates the output of GNU <command>troff</command> to
-          HTML</para>
+          <para>将 GNU <command>troff</command> 输出翻译成 HTML</para>
           <indexterm zone="ch-system-groff pre-grohtml">
             <primary sortas="b-pre-grohtml">pre-grohtml</primary>
           </indexterm>
@@ -481,11 +474,11 @@
       <varlistentry id="refer">
         <term><command>refer</command></term>
         <listitem>
-          <para>Copies the contents of a file to the standard output, except
-          that lines between <emphasis>.[</emphasis> and <emphasis>.]</emphasis>
-          are interpreted as citations, and lines between <emphasis>.R1</emphasis>
-          and <emphasis>.R2</emphasis> are interpreted as commands for how
-          citations are to be processed</para>
+          <para>将文件内容复制到标准输出，除了在
+			  <emphasis>.[</emphasis> 和 <emphasis>.]</emphasis>
+			  之间的行被解释为文献引用，
+			  <emphasis>.R1</emphasis> 和 <emphasis>.R2</emphasis>
+		      之间的行被解释为处理文献引用的方式</para>
           <indexterm zone="ch-system-groff refer">
             <primary sortas="b-refer">refer</primary>
           </indexterm>
@@ -495,7 +488,7 @@
       <varlistentry id="roff2dvi">
         <term><command>roff2dvi</command></term>
         <listitem>
-          <para>Transforms roff files into DVI format</para>
+          <para>将 roff 文件转换成 DVI 格式</para>
           <indexterm zone="ch-system-groff roff2dvi">
             <primary sortas="b-roff2dvi">roff2dvi</primary>
           </indexterm>
@@ -505,7 +498,7 @@
       <varlistentry id="roff2html">
         <term><command>roff2html</command></term>
         <listitem>
-          <para>Transforms roff files into HTML format</para>
+          <para>将 roff 文件转换成 HTML 格式</para>
           <indexterm zone="ch-system-groff roff2html">
             <primary sortas="b-roff2html">roff2html</primary>
           </indexterm>
@@ -515,7 +508,7 @@
       <varlistentry id="roff2pdf">
         <term><command>roff2pdf</command></term>
         <listitem>
-          <para>Transforms roff files into PDFs</para>
+          <para>将 roff 文件转换成 PDF</para>
           <indexterm zone="ch-system-groff roff2pdf">
             <primary sortas="b-roff2pdf">roff2pdf</primary>
           </indexterm>
@@ -525,7 +518,7 @@
       <varlistentry id="roff2ps">
         <term><command>roff2ps</command></term>
         <listitem>
-          <para>Transforms roff files into ps files</para>
+          <para>将 roff 文件转换成 ps 文件</para>
           <indexterm zone="ch-system-groff roff2ps">
             <primary sortas="b-roff2ps">roff2ps</primary>
           </indexterm>
@@ -535,7 +528,7 @@
       <varlistentry id="roff2text">
         <term><command>roff2text</command></term>
         <listitem>
-          <para>Transforms roff files into text files</para>
+          <para>将 roff 文件转换成文本文件</para>
           <indexterm zone="ch-system-groff roff2text">
             <primary sortas="b-roff2text">roff2text</primary>
           </indexterm>
@@ -545,7 +538,7 @@
       <varlistentry id="roff2x">
         <term><command>roff2x</command></term>
         <listitem>
-          <para>Transforms roff files into other formats</para>
+          <para>将 roff 文件转换成其他格式s</para>
           <indexterm zone="ch-system-groff roff2x">
             <primary sortas="b-roff2x">roff2x</primary>
           </indexterm>
@@ -555,8 +548,8 @@
       <varlistentry id="soelim">
         <term><command>soelim</command></term>
         <listitem>
-          <para>Reads files and replaces lines of the form <emphasis>.so
-          file</emphasis> by the contents of the mentioned
+          <para>读取文件，将 <emphasis>.so file</emphasis>
+			  形式的行替换为提到的 <emphasis>file</emphasis> 文件
           <emphasis>file</emphasis></para>
           <indexterm zone="ch-system-groff soelim">
             <primary sortas="b-soelim">soelim</primary>
@@ -567,9 +560,8 @@
       <varlistentry id="tbl">
         <term><command>tbl</command></term>
         <listitem>
-          <para>Compiles descriptions of tables embedded within troff input
-          files into commands that are understood by
-          <command>troff</command></para>
+          <para>将 troff 输入中嵌入的表格描述编译成 <command>troff</command>
+          	  理解的命令</para>
           <indexterm zone="ch-system-groff tbl">
             <primary sortas="b-tbl">tbl</primary>
           </indexterm>
@@ -579,8 +571,7 @@
       <varlistentry id="tfmtodit">
         <term><command>tfmtodit</command></term>
         <listitem>
-          <para>Creates a font file for use with <command>groff
-          -Tdvi</command></para>
+          <para>创建用于 <command>groff -Tdvi</command> 的字体文件</para>
           <indexterm zone="ch-system-groff tfmtodit">
             <primary sortas="b-tfmtodit">tfmtodit</primary>
           </indexterm>
@@ -590,10 +581,9 @@
       <varlistentry id="troff">
         <term><command>troff</command></term>
         <listitem>
-          <para>Is highly compatible with Unix <command>troff</command>; it
-          should usually be invoked using the <command>groff</command> command,
-          which will also run preprocessors and post-processors in the
-          appropriate order and with the appropriate options</para>
+          <para>和 UNIX <command>troff</command> 高度兼容；
+			  它应该由 <command>groff</command> 命令调用，
+			  后者也会以正确的顺序和选项运行预处理器和后处理器</para>
           <indexterm zone="ch-system-groff troff">
             <primary sortas="b-troff">troff</primary>
           </indexterm>