AIX命令参考大全，卷 5，s - u

troff 命令

用途

为在排版设备上打印而对文本进行格式化。

语法

troff [  -a ] [  -i ] [  -q ] [  -z ] [  -F Directory ] [  -n Number ] [  -o List ] [  -r ANumber ] [  -s Number ] [  -T Name ] [  -mm | -me | -mptx | -ms | -man | -mv ] [ -M Media ] [ File ... |  - ]

描述

troff 命令读取一个或多个文件并将文本格式化，以便在照排机或者其它兼容的设备上打印。然后，需要使用后处理器来对 troff 命令到目标设备的输出进行后处理。请参阅下文的示例。

如果没有指定任何文件，或者最后一个参数不是 -（减号）标志，则缺省值就是读取标准输入。

对于 3812、3816 和 Hewlett-Packard LaserJet 系列 II 打印机来说，缺省的字体是打印机本地字体。这些打印机也可以使用其它字体，这些字体可以通过使用 troff .fp 伪指令来装入。这些字体储存在主机的 /usr/lib/font/devPrinter/bitmaps 目录下,可以在需要的时候下载到打印机。

字型

以四种样式提供三种不同字型。下表展示了字型、样式和 troff 命令用于存取字体的名称之间的关系。

字型          常规        斜体        粗体        斜体

Roman         cr          cR           Cr          CR

Sans Serif    cs          cS           Cs          CS

Typewriter    ct          cT           Ct          CT

troff special sp

15 种标准 troff 大小提供了所有这些字体：6，7，8，9，10，11，12，14，16，18，20，22，24，28 和 36 磅。

例如 .fp 1 Cr 将罗马粗体字体装入位置 1。

标志

请参阅《宏软件包之格式化工具》一书，以了解更多有关宏的信息。

环境变量

示例

以下是一个 troff 命令的示例：

troff -Tibm3812 File | ibm3812 | qprt

宏软件包之格式化工具

以下的宏软件包是《文本格式化系统中的格式化工具》的一部分，在接下来的页中有更详细信息的描述：

用于 nroff 和 troff 命令的 man 宏软件包

man 宏软件包的提供，使用户可以依靠用 nroff 命令或 troff 命令处理过的联机手册页来创建自己的手册页。man 宏软件包与 nroff 命令或 troff 命令同时使用。

man 宏软件包内部包含特殊宏、字符串和数字寄存器，还有以下的格式化宏、字符串和寄存器的列表。除了由 troff 命令和 d、m 和 y 数字寄存器预定义的名称外，所有这样的内部名称都是 SymbolAlpha格式的，其中 Symbol 是 )、] 或 } 之一，Alpha 为任意一个字母数字字符。

man 宏软件包只使用罗马字体。如果某项的输入文本包含使用其它字体的请求（如 .I 格式化宏、.RB 请求或 \fI请求），就必须安装对应的字体。

格式化宏

以下宏用来修改使用 man 宏软件包格式化的手册页的特性。

在每个段落之前和处理字体和大小设置的宏之后（如 .I、.SM和 .B 格式化宏），输入字体和大小都将复位为缺省值。

除了.DT 和 .TH 格式化宏以外，其它格式化宏都不能够使用也不能够设置制表符停止位。

.B [Text]

使文本字体变为粗体。

Text 变量代表最多 6 个单词；使用 『 』（双引号）以包含单词中的空格字符。如果变量是空的，可以在下一个含有待打印文本的输入文本行应用该处理。例如：使用 .I 格式化宏使整个行变为斜体，或使用 .SM 和 .B 格式化宏使整个行的文字变为小粗体字体。缺省情况下，nroff 命令关闭连字符处理，而在 troff 命令中可以使用。

.DT

nroff 命令中每隔 5 ens 恢复一次缺省的制表符设置；在 troff 命令中每隔 7.2 ens 恢复一次。

.HP [Indent]

使得段落开头为悬挂式缩进，缩进尺寸由 Indent 变量指定。

如果省略 Indent 变量，则使用前一次设置的 Indent 值。此值的缺省值（对于 nroff 命令为 5 ens，对于 troff 命令为 7.2 ens）由 .TH、.P 和 .RS 格式化宏来设置； 值的恢复由 .RE 格式化宏来进行。Indent 的缺省单位是 ens。

.I [Text]

使文本字体变为斜体。

Text 变量代表最多 6 个单词；使用 『 』（双引号）以包含单词中的空格字符。如果变量是空的，可以在下一个含有待打印文本的输入文本行应用该处理。例如：使用 .I 格式化宏使整个行变为斜体，或使用 .SM 和 .B 格式化宏使整个行的文字变为小粗体字体。缺省情况下，nroff 命令关闭连字符处理，而在 troff 命令中可以使用。

.IP [Tag] [Indent]

与 .TP Indent 宏对 Tag 变量的操作的效果是一样的；如果 Tag 变量的值是 NULL，则段落的开头是缩进的。该宏通常用来使段落缩进而不需再使用制表符。

如果省略 Indent 变量，则使用前一次设置的 Indent 值。该值（对于 nroff 命令为 5 ens，对于troff 命令为 7.2 ens），由 .TH、.P 和 .RS 格式化宏来设置为缺省值，由 .RE 格式化宏进行恢复。Indent 变量的缺省的单位是 ens。

.P

用正常字体、磅大小和缩进开始段落。.PP 宏就是 mm 宏软件包中的 .P 宏。

.PD [Number]

将段落间距设置为 Number 参数指定的垂直间距数。缺省的 Number 变量值在 troff 命令中是 0.4v，在 nroff 命令中是 1v。

.PM [Indicator]

设置的专利标记如下：

指示符	标记
P	专用
N	注意事项
无指定的指示符	关闭专利标记。

.RE [Number]

结束由 Number 变量指定的缩进级别位置的相对缩进（.RS）。如果省略了 Number 变量值，则返回到最近的低一级的缩进级别。

.RI Character1Character2...

将罗马体的 Character1 和斜体的 Character2 并置；改变两种字体，得到 6 种 Character1Character2 集。类似的可以改变罗马体、斜体和粗体，形成任两种组合在一起的宏包括：.IR、.RB、.BR、 .IB和 .BI宏。

.RS [Indent]

增加相关缩进量（初始为零）。将所有输出按照 Indent 变量指定的缩进量从左空白缩进额外的单元数。

如果省略了 Indent 变量，则使用前一 Indent 值。该值（对于 nroff 命令为 5 ens，对于 troff 命令为 7.2 ens）由 .TH、.P 和 .RS 格式化宏来设置为缺省值，由 .RE 格式化宏来进行恢复。Indent 变量的缺省单位是 ens。

.SH [Text]

放置副标题文本。

Text 变量代表最多 6 个单词；使用 『 』（双引号）以包含单词中的空格字符。如果该变量是空的，可以在下一个含有待打印文本的输入文本行应用该处理。例如：使用 .I 格式化宏使整个行变为斜体，或使用 .SM 和 .B 格式化宏使整个行的文字变为小粗体字体。缺省情况下，nroff 命令关闭连字符处理，而在 troff 命令中可以使用。

.SM [Text]

使文本字大小比缺省值小 1 磅。

Text 变量代表最多 6 个单词；使用 『 』（双引号）以包含单词中的空格字符。如果该变量是空的，可以在下一个含有待打印文本的输入文本行应用该处理。例如：使用 .I 格式化宏使整个行变为斜体，或使用 .SM 和 .B 格式化宏使整个行的文字变为小粗体字体。缺省情况下，nroff 命令关闭连字符处理，而在 troff 命令中可以使用。

.SS [Text]

放置副标题文本。

Text 变量代表最多 6 个单词；使用 『 』（双引号）以包含单词中的空格字符。如果该变量是空的，可以在下一个含有待打印文本的输入文本行应用该处理。例如：使用 .I 格式化宏使整个行变为斜体，或使用 .SM 和 .B 格式化宏使整个行的文字变为小粗体字体。缺省情况下，nroff 命令关闭连字符处理，而在 troff 命令中可以使用。

.TH [Title][Section][Comme][Name]

设置标题和条目标题。该宏调用 .DT 格式化宏。

变量	标记
Title	标题
Section	节号
Commentary	外部注释
Name	新的手册名。

注:

如果 .TH 格式化宏值中包含字符空格，但是没有使用 『 』（双引号）将其扩起来的话，输出会显示不规则的点。

.TP [Indent]

以悬挂标记开始缩进段落。下一个包含文本的输入行就是标记。如果此标记不合适，会在另一行上被打印出来。

如果省略了 Indent 变量，则使用前一设置的 Indent 值。该值（对于 nroff 命令为 5 ens，对于 troff 命令为 7.2 ens）由 .TH、.P 和 .RS 格式化宏来设置为缺省值，由 .RE 格式化宏来进行恢复。Indent 变量的缺省单位是 ens。

字符串

寄存器

标志

示例

1. 要对文件 your.book 进行处理， 并在将其格式化后输出至本地行式打印机 qprt，请输入：

   nroff -Tlp -man your.book | qprt -dp 

2. 要对包含表格的文件 my.book 和 dept.book 进行处理， 并在将其格式化后输出至本地行式打印机 qprt，请输入：

   tbl my.book dept.book | nroff -Tlp -man | col -Tlp | qprt -dp

   注:
   在输出被发送到 qprt 之前，首先要由 col 命令对其进行过滤，以便对 tbl 命令使用过的反向换行进行处理。
3. 要处理包含图片、图表和表格的文件组， 准备预格式化输出以在 IBM 3816 打印机上对其进行处理，请输入：

   grap group | pic | tbl | troff -Tibm3816 -man \
     | ibm3816 | qprt -dp

1. 如果用 man 宏软件包创建的手册页意在用于联机设备上，则应避免使用需要 troff 命令的组件，如 grap 或 pic 命令。
2. grap 命令在 pic 命令之前运行，因为它是 pic 命令的预处理程序；否则不能进行正确的格式化。
3. col 命令不需要作为 tbl 命令的过滤器；排版后的文档不需要反向换行。

用于 nroff 和 troff 命令的 me 宏软件包

nroff 和 troff 命令的宏定义的 me 软件包以不同格式为技术论文提供了格式化实用程序。某些情况下，可能需要 col 命令对 nroff 输出进行后处理。

宏请求在下一节的 me 请求 中定义。许多 nroff/troff 请求在同该软件包合用的时候可能会产生不可预测的结果。但是，以下请求可以在第一个 .pp 请求后使用：

用于方程式和表格上的 eqn、neqn、refer 和 tbl 命令的预处理器输出可以当作输入使用。

me 请求

以下列表中包括在 me 宏中所有有效的宏、字符串和数字寄存器。还包括选中的 troff 命令、寄存器和各种功能。

有关更多信息，请参阅 -ME Reference Manual，作者 E. P. Allman。

用于 mm，mmt，nroff 和 troff 命令的 mm 宏软件包

mm 宏软件包提供能够对多种文档格式的文本，如备忘录、信件和报告等进行格式化的宏。用户输入和编辑文档的方式本质上与该文档将稍后在终端上还是在照相排版机上被格式化无关。

可能需要 col 命令对 nroff 输出进行后处理。特定的要求请参阅 col 命令。

mm 宏和附加信息被概述为以下标题：

• 正式备忘录的开始宏
• 商业信函宏
• 结束宏（后缀信息）
• 段落
• 节标题
• 列表
• 显示、表格、等式和脚注
• 页眉和页脚
• 其它宏
• mm 寄存器
• mm 字符串
• 字符串名称
• 保留名称。

正式备忘录的开始宏

商业信函宏

结束宏（后缀信息）

段落

节标题

列表

如果最后的选项 [1] 出现在列表启动宏中，则在各项之间没有空格。

显示、表格、等式和脚注

.DS [{0 1 2 3 }] [{0 1}] [Number]

.DS [{L I C CB}] [{N F}] [Number]

启动静态显示：

0 或 L

无缩进

1 或 I

左缩进

2 或 C

将每一行居中对齐

3 或 CB

作为一个块居中对齐

0 或 N

不填充

1 或 F

填充。

Number

右缩进，空格的个数由 Number 参数来指定。

.DF [{0 1 2 3 }] [{0 1}] [Number]

.DF [{L I C CB}] [{N F}] [Number]

启动浮动显示：

0 或 L

无缩进

1 或 I

左缩进

2 或 C

将每一行居中对齐

3 或 CB

作为一个块居中对齐

0 或 N

不填充

1 或 F

填充。

Number

右缩进，空格的个数由 Number 参数来指定。

 

.DE

结束显示。

.FG [Title] [Override] [0 1 2]

Override 变量的值替换或提高缺省的编号。指定图形题注：

0

Override 值被用作前缀。

1

Override 值成为后缀。

2

替换 Override 值成为替换值。

 

.TS [H]

启动表格：

H

多页表格。

 

.TH [N]

在指定选项 H 到 .TS 的时候必须使用：

N

除了在新页的顶部外，禁止表格标题。

.TE

结束表格。

.TB [Title] [Override] [0 1 2]

Override 变量的值替换或提高缺省的编号。指定表格的题注：

0

Override 值被用作前缀。

1

Override 值成为后缀。

2

替换 Override 值成为更新值。

.EX [Title] [Override] [0 1 2]

Override 变量的值替换或提高缺省的编号。指定展示题注：

0

Override 值被用作前缀。

1

Override 值成为后缀。

2

替换 Override 值成为替换值。

.EQ [Label]

使用指定的标号启动等式显示。

.EN

结束等式显示。

.EC [Title] [Override] [0 1 2]

Override 变量的值替换或提高缺省的编号。指定等式的题注：

0

Override 值被用作前缀。

1

Override 值成为后缀。

2

替换 Override 值成为替换值。

.FS [Label]

使用指定的标号作为指示符开始脚注。缺省是编号了的脚注。

.FE

结束脚注。

.FD [{0 1 2 3 4 ... 11}] [1]

设置脚注格式：

第一选项：

设置脚注文本的格式化样式。mmt 命令的缺省值为 0。mm 命令的缺省值为 10。有关值请参阅以下表格。

第二选项：

复位第一级标题的脚注计数器。

.FD Arg.	连字符	调整	缩进格式的文本	对齐的标号
0	.nh	.ad	是	左侧
1	.hy	.ad	是	左侧
2	.nh	.na	是	左侧
3	.hy	.na	是	左侧
4	.nh	.ad	否	左侧
5	.hy	.ad	否	左侧
6	.nh	.na	否	左侧
7	.hy	.na	否	左侧
8	.nh	.ad	是	右侧
9	.hy	.ad	是	右侧
10	.nh	.na	是	右侧
11	.hy	.na	是	右侧

页眉和页脚

其它宏

以下的宏是用来修改字体的，都有 1 到 6 个选项：

mm 寄存器

如果一个注册名称后面紧跟着一个 *（星号），则有两种方式来对注册器进行设置：在命令行中进行（请参阅 mm 命令中的示例）或在格式化程序读取 mm 宏定义之前。以下列表中括号内的数字为缺省值。

mm 字符串

使用以下的转义序列打印特殊字符串 ：

字符串名称

保留名称

如果要自定义字符串、宏和寄存器，只能使用单个小写字母或者一个小写字母后跟一个非小写字母字符来命名。名称 c2 和 nP 是本规则的例外情况；他们是保留名称。

用于 nroff 和 troff 命令的 mptx 宏软件包

mptx 宏软件包为 .xx 宏提供了定义，该宏是用来为由 ptx 命令生成的改序索引进行格式化的。mptx 宏软件包不提供任何其它的格式化能力，如页眉和页脚等。mptx 宏软件包必须同 mm 宏软件包共同使用才能提供这些能力。在此情况下，在 -mm 调用后调用 -mptx 选项，方法如下:

nroff -mm -mptx File... | Printer

用于 nroff 和 troff 命令的 ms 宏软件包

nroff 和 troff 命令宏定义的 ms 宏语句包为各种样式的文章、论文和书籍提供了格式化设施。在某些情况下，后处理输出可能会需要用到 col 命令。

宏请求在 ms 请求段中定义。同该软件包在一起，许多 nroff 和 troff 命令请求可能会产生无法预料的结果。但是，以下列表中的头四个请求可以在初始化之后使用，最后两个请求可以在初始化之前使用。

允许使用 \f 和 \s 宏来更改字体和磅值。例如，\fIword\fR  用斜体字显示 word。用于等式、表格和引用的 tbl、eqn 和 refer 命令预处理程序的输出可以被接受作为输入。

通过内置数字寄存器可以在 ms 宏内对格式化距离进行控制。例如，以下数字寄存器将行长度设置为 6.5 英寸：

.nr LL 6.5i

有关 ms 宏寄存器的更多信息，请参阅 ms 寄存器。

ms 请求

以下是外部 ms 宏请求：

ms 寄存器

以下是一个数字寄存器及其缺省值的列表：

当重新设置数字寄存器的值的时候，请确保已经指定了合适的单位。设置行长度为 7i，而不是仅仅是 7，后者将会导致每行只输出一个字符。将 FF 寄存器设置为 1（一）可以禁止脚注上标。将其设置为 2 也可以禁止首行缩进。将 FF 寄存器设置为 3 可以生成同 .IP请求相似的脚注段落。

以下是一个 ms 宏中的可用字符串寄存器列表。这些字符串寄存器可以用于文本中的任何地方。

当和 .AM 请求一起使用可用的扩展重音符定义时，这些字符串应该在要加重音的字母之后，而不是在这些字母之前。

1. 一定要注意：浮动保持和常规保持可以转换为相同的空格，所以他们不能混合。
2. 日期格式仅限于美国英语格式。

用于 mvt 和 troff 命令的 mv 宏软件包

该软件包简化了视图的排版，以及不同大小的投影幻灯片。虽然若干个宏可以完成制造透明度所需的大多数格式化任务，但是由 troff、tbl、pic 和 grap 命令组成的整个设施可以用来完成更为困难的任务。

输出可以在多数终端中进行预览，特别是 Tektronix 4014。对于该设备，请指定 -rX1 标志（它在 mvt 命令带 -D4014 标志被调用时自动指定）。要预览其它终端上的输出，请指定 -a 标志。

mv 宏在以下的标题下进行汇总：

• Foil-Start 宏
• 级别宏
• 文本控制宏
• 缺省设置宏。

Foil-start 宏

在以下九个宏中，名称的第一个字符（V 或 S）分别指视图和幻灯片。第二个字符表示片是否是方的（S）、小宽度（w）、小高度（h）、大宽度（W）或者大高度（H）。幻灯片比相应的视图要窄。幻灯片的长短比例要大于视图。结果是，幻灯片可以作为视图使用，但是视图不能作为幻灯片使用。另一方面，视图可以容纳稍多的文本。

级别宏

文本控制宏

缺省设置宏

.S、.DF、.DV 和 .U 宏不会造成中断。.I 宏只有在被超过一个的变量调用时才会造成中断。其它所有的宏都会造成中断。

mv 宏软件包还能识别对应于以下小写 troff 命令请求的大写同义词：

• .AD
• .BR
• .CE
• .FI
• .HY
• .NA
• .NF
• .NH
• .NX
• .SO
• .SP
• .TA
• .TI

Tm 字符串产生商标符号。

环境变量

用于 nroff 和 troff 命令的 nroff 和 troff 请求

以下的 nroff 和 troff 请求包括在指定的工作文件或者标准输入中。当文件或者标准输入被使用 nroff 或 troff 命令处理时，nroff 和 troff 请求控制格式化输出的特性。nroff 和troff 请求按功能分组，在以下各部分中：

• 数值参数输入
• 字体和字符大小控制
• 页面控制
• 文本填充、调节和居中
• 垂直间距
• 行长度和缩进
• 宏、字符串、转换和位置陷阱
• 数字寄存器
• 制表符、引导符和字段
• 输入和输出约定以及字符转换
• 连字符处理
• 三部分标题
• 输出行编号
• 输入的有条件接受
• 环境转换
• 从标准输入插入
• 输入和输出文件转换
• 杂项

对于写成 +Number 的数字变量，可以如下表示：

• Number 变量本身是一个绝对值。
• +Number 变量增加当前的设置值。
• -Number 变量相对于当前值减小变量。
  注:
  所有的数字参数都只能使用 ASCII 阿拉伯数字来表示。

该命令结尾注释在特定的适用的请求中被引用。

数字参数输入

nroff 和 troff 请求都接受带有附加量度指示符的数字输入，如下表所示，其中 S 是当前输入磅值，V 当前垂直行间距（按基本单位计算）。C 是正常字符宽度（按基本单位计算）。

在 nroff 请求中，em 和 en 都等于 C，具体值由输出设备决定；最常用的值为 1/10 和 1/12 英寸。nroff 请求中的实际字符宽度不需要都是相同的，使用 - > 等预定义字符串构建的字符的宽度经常会超出宽度范围。

日语支持：在 nroff 命令的输出中，所有双宽度的日本字符，如所有日语汉字和一些片假名字符等都有一个等于 2 C 的固定宽度值。所有的单宽度日本字符，如一些片假名字符，有等于 C 的固定宽度。

水平方向控制字符、垂直方向控制字符以及请求 .nr、.if 和 .ie 的缩放如下：

方向        缺省         请求或功能                     测量

水平        Em （m）     .ll, .in, .ta, .lt,                                        .po, .mc, \h, \l

垂直        垂直行       .pl, .wh, .ch, .dt, 
                    空格（v）     .sp, .sv, .ne, .rt, \v                                         \x, \L

寄存器方向  基本单位（u）.nr、.if. .ie
或者有条件  
杂项       点（p）           .ps, .vs, \H, \s

所有其它请求都会忽略缩放指示符。当对已经包含有合适的缩放数字的数字寄存器进行解释以提供数字输入的时候， 可能需要附加单位缩放指示符 u 来防止多余的不合适的缺省缩放。Number 可以指定为十进制分数的形式，但是最终存储的参数会被四舍五入为基本单位的整数。

字体和字符大小控制

页面控制

文本填充、调整和居中

日语支持：

垂直间距

行长度和缩进

宏、字符串、转换和位置陷阱

.ds {c ^A2 41^A』ERROR: (%1$s) input line \
%2$s『 ^A\n(.F^B\n(.c

错误： (paper.doc)输入 行 123

.ds {c ^A2 41
/* Without optional default message */

.ds {c ^A2 41^A』错误：（%1$s）输入文件 \
%2$s『 /* Without optional arguments */

.ds DT^A0 0

.ds DT^A0 0^A』今天是 %B %d, %Y『

数字寄存器

制表符、引导符和字段

输入/输出约定和字符翻译

.tr aAbBc<C,> 

.tr aabbcc

连字符连接

三部分标题

输出行编号

有条件的输入接收

Condition 变量指定以下单字符名称中的一个：

环境切换

标准输入的插入内容

输入、输出文件切换

其它项

troff: 用户 异常终止， 行编号 文件 文件名

.ab ^A2 42^A』Processing has been terminated \
 at line %1$s.『^A\n(c.

处理 已经 被 终止 在 行 123.

.Dt 』%A, %B %d, %Y (%T)『

星期四， 1 月 31 日，1991（10:40:00）

.sy date > /tmp/today
今天 是
.so /tmp/today

.tm ^A2 23^A』The typesetter is %1$s.On line 
%2$s.『^A\*(.T^B\n(c.

The typesetter is psc. On line 538.

注释

以下的注释在 nroff 和 troff 请求中应用。他们以应用处的请求编号作参考。

1. .L 字符串寄存器包含所有目录的当前程序语言环境值。
2. .m 字符串寄存器包含着 LC_MESSAGES 目录中的语言环境值。
3. .t 字符串寄存器包含着 LC_TIME 目录中的语言环境值。
4. .L、.t 和 .m字符串寄存器提供对一些环境值的访问，同时还可以使用一项更为通用的技术来对其它的环境变量进行访问。例如：如果 TED 环境变量被导出，则接下来的 troff 命令：

   .sy echo .ds z $TED >x
   .so x
   .sy rm x

设置 z 字符串寄存器中包含 $TED 值。

环境变量

文件

相关信息

col 命令、eqn 命令 grap 命令、hplj 命令、ibm3812 命令、ibm3816 命令、mm 命令、mmt 命令、mvt 命令、neqn 命令、nroff 命令、pic 命令、ptx 命令、refer 命令、tbl 命令、tc 命令、xpreview 命令。