以norff/troff标记(markup)写成的手册页manual page

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 命令用于存取字体的名称之间的关系。

注:
本套字体集基于 Donald E Knuth 开发的计算机现代字母格式。(请参阅 Knuth,Donald: Computer Modern Typefaces。Addison-Wesley, 1986。)

字型          常规        斜体        粗体        斜体

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 命令的输入中, .tl 请求不能在生成第一个中断的请求之前使用。

标志

-a将结果的可打印 ASCII 近似值发送到标准输出。
-FDirectory从 Directory/devName 目录而不是缺省的 /usr/lib/font/devName 目录(此目录下的 Name 由 -T 标志指定)存取字体信息。
-i在没有其它文件后读取标准输入。
-M Media指定纸张大小,进而确定纸上的可成像面积。Media 变量的有效值为:
A4
指定纸张大小为 8.3 X 11.7 英寸(210 X 297 厘米)。
A5
指定纸张大小为 5.83 X 8.27 英寸(148 X 210 厘米)。
B5
指定纸张大小为 6.9 X 9.8 英寸(176 X 250 厘米)。
EXEC
指定纸张大小为 7.25 X 10.5 英寸(184.2 X 266.7 厘米)。
LEGAL
指定纸张大小为 8.5 X 14 英寸(215.9 X 355.6 厘米)。
LETTER
指定纸张大小为 8.5 X 11 英寸(215.9 X 279.4 厘米)。此为缺省值。
注:
Media 变量不区分大小写。
-nNumber用 Number 变量指定的值来为第一打印页编号。
-oList只打印 List 变量指定的页,这样的页中包含一个以逗号隔开的页号和范围的列表:
  • 开始页-结束页范围表示打印从开始页结束页之间的页数。例如:9-15 表示打印第 9 页到第 15页。
  • 初始-结束页表示从开头打印到结束页。
  • 最终开始页-表示从开始页打印到结尾。
  • 打印页的编号和打印范围联合使用,来打印指定页。例如:-3,6-8,10,12- 打印从开头到第 3 页,从第 6 页到第 8 页,第 10 页以及第 12 页到结尾。
    注:
    在管道中使用该标志(例如:含有一个或多个  piceqn 或  tbl命令)时,如果文档的最后一页没有在  List 变量中指定,用户可能会接收到 中断管道消息。不过,该中断管道消息并不指示有任何问题,可以忽略不计。
-q调用 .rd 请求的同步输入和输出方式 。
-rANumber将由 A 变量指定的寄存器设置为指定的编号。A 变量值必须具有单字符的 ASCII 名称。
-sNumber生成输出,使排版机停止每一个指定页编号。
-TName为指定的打印设备准备输出。照排机或其它兼容打印设备在操作系统国际扩展字符上使用以下 Name 变量。缺省值为 ibm3816
注:
如果设备不支持指定的磅值,您就会收到 bad point size的消息。 troff 命令会使用最接近的有效的磅值来继续进行格式化。
canonls
Canon Lasershot LBP-B406S/D/E,A404/E,A304E。
ibm3812
3812 页式打印机 II。
ibm3816
3816 页式打印机。
hplj
Hewlett-Packard LaserJet II。
ibm5585H-T
5585-H01 繁体中文语言支持。
ibm5587G
5587-G01,5584-H02,5585-H01,5587-H01 和 5589-H01 日语汉字打印机,支持多字节语言。
psc
PostScript 打印机。
X100
AIXwindows 显示。
注:
也可以将  TYPESETTER 环境变量设置为前述值之一, 而不使用  troff 命令中的  -T  Name 标志。
-man选择 man 宏处理软件包。
-me选择 me 宏处理软件包。
-mm选择 mm 宏处理软件包。
-mptx选择 mptx 宏处理软件包。
-ms选择 ms 宏处理软件包。
-mv选择 mv 宏处理软件包。

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

-z只打印由 .tm(工作站消息)请求生成的消息。
-从标准输入强制读取输入。

环境变量

TYPESETTER包含特定打印设备的信息。

示例

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

troff -Tibm3812 File | ibm3812 | qprt

宏软件包之格式化工具

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

man使用户可以依靠联机手册页来创建自己的手册页。
me提供格式化页的宏。
mm使用 nroff 和 troff 格式化程序来格式化文档。
mptx格式化置换索引。
ms为不同样式的文章、论文和书籍提供格式化程序实用工具。
mv使用 troff 命令对英文视图和幻灯片进行排版。

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

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

man 宏软件包内部包含特殊宏、字符串和数字寄存器,还有以下的格式化宏字符串寄存器的列表。除了由 troff 命令和 dm 和 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。

字符串

\*R为 nroff 命令添加商标(Reg.),为 troff 命令添加注册商标符号。
\*S改为缺省类型大小。
\*(Tm添加商标指示符。
寄存器

IN相对于副标题缩进左空白。缺省值为 troff命令为 7.2 ens,nroff 命令为 5 ens。
LL行长度包括由 IN 寄存器指定的值。
PD当前的段落间距。
标志

-rs1将缺省的页面大小由 8.5×1 1英寸减为 6×9 英寸,缺省的文本面积由 6.5 ×10 英寸减为 4.75×8.375 英寸。该标记还将缺省的类型大小由 10 磅减为 9 磅,缺省的垂直行间距由 12 磅减为 10 磅。
示例
  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 请求后使用:

.bp开始新的页。
.br在此处中断输出行。
.ce [Number ]居中对齐下一个指定行号。缺省值为 1。
.ls [Number ]设置行间距。如果 Number 被设为 1,文本为单倍行距;如果该值被设为 2,则为双倍行距。
.na使右边界不对齐。
.sp [Number]插入指定数量的空白行。
.sz [+]Number增加指定数量的磅值。
.ul [Number]为下一个指定的行号加下划线。缺省值为 1。

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

me 请求

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

\(space)定义不可插入式空格(troff 命令的内置功能)。
\『对行结束的注释(troff 命令的内置功能)。
\*#表示可选的、延迟的文本标记字符串。
\$Number内插由 Number 变量指定的值( troff命令的内置功能)。
\n($0定义节的深度(数字寄存器)。
.$0在打印节标题后启动(用户可以自定义的宏)。
\n($1定义第一节的节号(数字寄存器)。
.$1在打印深度为 1 的节之前启动(用户可以自定义的宏)。
\n($2定义第二节的节号(数字寄存器)。
.$2在打印深度为 2 的节之前启动(用户可以自定义的宏)。
\n($3定义第三节的节号(数字寄存器)。
.$3在打印深度为 3 的节之前启动(用户可以自定义的宏)。
\n($4定义第四节的节号(数字寄存器)。
.$4在打印深度为 4 的节之前启动(用户可以自定义的宏)。
\n($5定义第五节的节号(数字寄存器)。
.$5在打印深度为 5 的节之前启动(用户可以自定义的宏)。
\n($6定义第六节的节号(数字寄存器)。
.$6在打印深度为 6 的节之前启动(用户可以自定义的宏)。
.$C在章的开头被调用(用户可以自定义的宏)。
.$H表示文本的页眉(用户可以自定义的宏)。
\n($R定义显示出来的相对垂直间距(按缺省值定义的数字寄存器,不建议更改)。
\n($c定义当前栏的页眉(数字寄存器)。
.$c打印章标题(按缺省值定义的宏;不建议更改)。
\n($d表示延迟的文本号(数字寄存器)。
\n($f表示脚注号(数字寄存器)。
.$f打印页脚(按缺省值定义的宏;不建议更改)。
.$h打印页眉(按缺省值定义的宏;不建议更改)。
\n($i定义段落的基准缩进(数字寄存器)。
\n($l定义列宽(数字寄存器)。
\n($m表示有效的栏数(数字寄存器)。
\*($n表示节的名称(字符串)。
\n($p定义已编号的段落数(数字寄存器)。
.$p打印节标题(按缺省值定义的宏;不建议更改)。
\n($r定义文本的相对垂直间距(按缺省值定义的数字寄存器;不建议更改)。
\n($s定义列缩进(数字寄存器)。
.$s将脚注从文本中分离(按缺省值定义的宏;不建议更改)。
\n%定义当前页的页号(按缺省值定义的数字寄存器;不建议更改)。
\&表示 0 宽度的字符;用来隐藏控件(troff命令的内置功能)。
\(XX内插由 XX 变量指定的特殊字符(troff命令的内置功能)。
.(b开始块(宏)。
.(c开始居中对齐的块(宏)。
.(d开始延迟的文本(宏)。
.(f开始脚注(宏)。
.(l开始列表(宏)。
.(q开始引用(宏)。
.(xIndex在指定的索引中开始索引项(宏)。
.(z开始浮动保持(宏)。
.).)b结束块(宏)。
.).)c结束居中对齐的块(宏)。
.).)d结束延迟的文本(宏)。
.).)f结束脚注(宏)。
.).)l结束列表(宏)。
.).)q结束引用(宏)。
.).)x结束索引项(宏)。
.).)z结束浮动保持(宏)。
\*String内插由 String 变量指定的值(troff 命令的内置功能)。
\*String1String2内插由 String1String2 变量指定的值(troff命令的内置功能)。
\**表示可选的脚注标记字符串。
.++mH定义论文章节的宏。由 m 变量指定的值定义的论文的各部分。 m 变量可以是以下值:
C
定义章。
A
定义附录。
P
定义初步信息,如摘要和目录。
B
定义书目。
RC
定义各章从每张的第一页开始重新编号。
RA
定义附录从第一页开始重新编号。

H参数定义新页眉。如果页眉中含有空格,则该页眉必须加引号。如果你希望在页眉中包含章号,则请使用字符串 \\\n(ch。例如,要将附录编号为 A.1、A.2...,请输入:.++ RA '''\\\n(ch.%'。 每部分(例如章和附录)的编号应该在 .+c 请求之前。

.+cTitle开始章(或附录,例如像 .++宏所设置的那样)。由 Title 变量指定的值就是章的标题(宏)。
\*,表示下加符号(字符串)。
\-表示减号(troff 命令的内置功能)。
\*-表示 3/4 单位长度的破折号(字符串)。
\0定义不可插入式的数字宽度的空格(troff 命令的内置功能)。
.1c还原为单栏输出(宏)。
.2c开始双列输出(宏)。
\*:表示变音符号(字符串)。
\*<打开下标(字符串)。
\*>结束下标(字符串)。
.EN结束等式。由 eqn 命令或 neqn 命令(宏)生成的等式后面的空格。
.EQXY开始等式;中断并添加空格。由 Y 变量指定的值就是等式的值。可选的 X 变量的值可能是以下数中的任一个:
I
缩进等式(缺省值)。
L
左对齐等式。
C
居中对齐等式(宏)。

\L'Distance'表示指定距离的垂直绘线型函数(troff 命令的内置功能)。
.PE结束 pic 图片(宏)。
.PF结束带有回扫的 pic 图片(宏)。
.PS启动 pic 图片(宏)。
.TE结束表格(宏)。
.TH结束表格头(宏)。
.TS X开始表格。如果 X变量的值是 H,则该表格具有重复的标题(宏)。
\*[开始上标(字符串)。
\n(.$定义宏的选项编号(按缺省值定义的数字寄存器;不建议更改)。
\n(.i表示当前的缩进(按缺省值定义的数字寄存器;不建议更改)。
\n(.l表示当前的行长(按缺省值定义的数字寄存器;不建议更改)。
\n(.s表示当前的磅值(按缺省值定义的数字寄存器;不建议更改)。
\*(4表示重音符(字符串)。
\*(`表示抑音符(字符串)。
\(4表示重音符(troff命令的内置功能)。
\(`表示抑音符(troff命令的内置功能)。
\*]结束上标(字符串)。
\^表示 1/12 单位长度的窄空格(troff命令的内置功能)。
\*^表示插入记号(字符串)。
.acAuthorNumber形成 ACM 格式的输出。Author 变量指定作者名。Number 变量指定总页数。必须在第一次初始化之前使用(宏)。
.ad设置文本对齐方式(宏)。
.af为寄存器分配格式(宏)。
.am附加到宏(宏)。
.ar设置页号为阿拉伯数字(宏)。
.as附加到字符串(宏)。
.b X用粗体字打印 X 变量指定的值。如果省略了 X 变量,则使用粗体字(宏)。
.ba +Number通过指定的 Number 值增加基准缩进。在普通文本,如段落上设置缩进(宏)。
.bc开始新的一列(宏)。
.bi X仅在非填充方式下,用粗斜体打印 X 参数指定的值。如果没有使用 X 参数,跟随粗斜体文本(宏)。
\n(bi显示块缩进(数字寄存器)。
.bl请求空行,即使在页首(宏)。
\n(bm设置底部标题的页边距(数字寄存器)。
.bp开始页(宏)。
.br设置中断;启动换行(宏)。
\n(bs显示块的前或后间距(数字寄存器)。
\n(bt块保持阈值(数字寄存器)。
.bu开始着重标记段落(宏)。
.bx X只将框中的 X 变量指定的值以非填充方式打印出来(宏)。
\c继续输入(troff 命令的内置功能)。
.ce使行居中对齐(宏)。
\n(ch定义当前章号(数字寄存器)。
.de定义宏(宏)。
\n(df显示字体(数字寄存器)。
.ds定义字符串(宏)。
\n(dw定义当前是星期几(数字寄存器)。
\*(dw定义当前是星期几(字符串)。
\n(dy定义当前的日期(数字寄存器)。
\e表示可打印的 \ (反斜杠) 的版本(troff 命令的内置功能)。
.ef'X'Y'Z'将偶数页的页脚设置为 XYZ 变量指定的值(宏)。
.eh'X'Y'Z'将偶数页的页眉设置为 XYZ 变量指定的值(宏)。
.el指定 if/else 条件的 else 部分(宏)。
.ep结束页(宏)。
\n(es表示等式的前或后间距(数字寄存器)。
\fFont设置直接插入字体,将其更改为 Font 变量指定的值(troff命令的内置功能)。
\f(Fontf设置直接插入字体,将其更改为 Fontf 变量指定的值(troff 命令的内置功能)。
.fc设置字段的字符(宏)。
\n(ff设置脚注字体(数字寄存器)。
.fi填充输出行(宏)。
\n(fi表示脚注的缩进,仅限于第一行(数字寄存器)。
\n(fm设置脚注的页边距(数字寄存器)。
.fo 'X'Y'Z'将脚注设置为 XYZ变量指定的值(宏)。
\n(fp设置脚注的磅值(数字寄存器)。
\n(fs设置脚注的前间距(数字寄存器)。
\n(fu设置脚注距离右边界的缩进(数字寄存器)。
\h'Distance'将本地水平移动值设置为指定的距离(troff 命令的内置功能)。
.hc设置连字符(宏)。
.he 'X'Y'Z'将页眉设置为 XYZ 变量指定的值(宏)。
.hl画水平线(宏)。
\n(hm设置页眉边距(数字寄存器)。
.hx取消下一页的页眉和页脚(宏)。
.hy设置连字符连接方式(宏)。
.i X用斜体打印 X 变量指定的值。如果省略了 X 变量,则跟随斜体文本(宏)。
.ie指定 if/else 条件的 else 部分(宏)。
.if指定条件(宏)。
\n(ii设置缩进段落缩进(数字寄存器)。
.in缩进(瞬时);扩大时使用 .ba 宏(宏)。
.ip X Y打开缩进段落,其悬挂标记由X 变量指定。缩进是由 Y 变量指定的 en 值。缺省值为 5(宏)。
.ix缩进,没有中断(宏)。
\l'Distance'启动指定距离的水平绘线型函数(troff 命令的内置功能)。
.lc设置引导符的重复字符(宏)。
.lh内插本地信头(宏)。
.ll设置行长(宏)。
.lo读取 .*x 格式的本地宏文件。必须在初始化之前使用(宏)。
.lp开始左对齐段落(宏)。
\*(lq指定左引号(字符串)。
.ls设置多行间距(宏)。
.m1设置从页面顶部到页眉之间的间距(宏)。
.m2设置从页眉到文本之间的间距(宏)。
.m3设置从文本到页脚之间的间距(宏)。
.m4设置从页脚到页面底部之间的间距(宏)。
.mc插入边距字符(宏)。
.mk标记垂直位置(宏)。
\n(mo定义月份(数字寄存器)。
\*(mo定义当前的月份(字符串)。
\nX内插由 X 变量值指定的数字寄存器(数字寄存器)。
\n(XX内插由 XX 变量指定的数字寄存器(数字寄存器)。
.n1设置页边空白的行数(宏)。
.n2设置页边空白的行数(宏)。
.na关闭文本对齐(宏)。
.neNumber设置垂直间距的指定行数(宏)。
.nf保留输出行不被填充(宏)。
.nh关闭连字符(宏)。
.np开始已编号的段落(宏)。
.nr设置数字寄存器(宏)。
.ns表示无间距方式(宏)。
\*o表示上标的圆圈(如 Norse A 使用的;字符串)。
.of'X'Y'Z'将奇数页的页脚设置为 XYZ 变量指定的值(宏)。
.oh'X'Y'Z'将奇数页的页眉设置为 XYZ 变量指定的值(宏)。
.pa开始页(宏)。
.pd打印已延迟的文本(宏)。
\n(pf表示段落字体(数字寄存器)。
\n(pi表示段落缩进(数字寄存器)。
.pl设置页面长度(宏)。
.pn设置下一页页号(宏)。
.po设置页面偏移量(宏)。
\n(po模拟页面偏移量(数字寄存器)。
.pp开始段落,首行缩进(宏)。
\n(pp设置段落的磅值(数字寄存器)。
\n(ps设置段落的前间距(数字寄存器)。
.q表示被加引号(宏)。
\*(qa用于全部(字符串)。
\*qe存在(字符串)。
\n(qi设置引号里面文字的缩进;同时缩短行(数字寄存器)。
\n(qp设置引号里面文字的磅值(数字寄存器)。
\n(qs设置引号里面文字的前或后间距(数字寄存器)。
.r将下文设置为罗马体(宏)。
.rb设置为 real 粗体字(宏)。
.re将制表符重新设置为缺省值(宏)。
.rm删除宏或者字符串(宏)。
.rn将宏或字符串重命名(宏)。
.ro将页号设置为罗马体(宏)。
\*(rq表示右引号(字符串)。
.rr删除寄存器(宏)。
.rs恢复寄存器(宏)。
.rt返回到垂直位置(宏)。
\sSize将直接插入大小更改为指定大小(troff命令的内置功能)。
.sc读取特殊字符和区别符的文件。必须在初始化前使用(宏)。
\n(sf设置节标题的字体(数字寄存器)。
.shLevelTitle表示接下来的是节标题;字体自动设为粗体。Level 变量指定节的级别。Title 变量指定节标题(宏)。
\n(si设置每节缩进深度的相对基数(数字寄存器)。
.sk保留下一页为空白页。前面的页只存储一页(宏)。
.smX设置为比 X 变量指定的值小一号的磅值(宏)。
.so表示源输入文件(宏)。
\n(so设置附加的节标题的偏移量(数字寄存器)。
.sp表示垂直间距(宏)。
\n(sp表示节标题的磅值(数字寄存器)。
\n(ss表示节的前间距(数字寄存器)。
.sx改变节的深度(宏)。
.sz +Number增加磅值至指定值(宏)。
.ta设置制表符停止位(宏)。
.tc设置制表符重复字符(宏)。
\*(td设置当前日期(字符串)。
n(tf表示标题字体(数字寄存器)。
.th以论题格式生成论文。必须在初始化前使用(宏)。
.ti表示临时缩进,只应用于下一行(宏)。
.tl表示 3 个部分的标题(宏)。
\n(tm设置主标题的页边距(数字寄存器)。
.tp开始标题页(宏)。
\n(tp设置标题的磅值(数字寄存器)。
.tr转换(宏)。
.u X将 X 变量指定的值加下划线,即使是在 troff 命令中。只采用非填充方式(宏)。
.uh设置节标题继续;字体自动采用粗体。与 .sh 宏相似,但是未编号(宏)。
.ul将下一行加下划线(宏)。
\v'Distance'本地垂直移动指定的距离(troff 命令的内置功能)。
\*v为捷克语的 e 倒置 v(字符串)。
\w'String'返回指定字符串的宽度(troff 命令的内置功能)。
.xl设置本地行长度(宏)。
.xpIndex打印指定的索引(宏)。
\n(xs设置索引项的前间距(数字寄存器)。
\n(xu设置索引的右边界缩进(数字寄存器)。
\n(yr表示年份,只使用后两位数字(数字寄存器)。
\n(zs设置浮动保持的前或后间距(数字寄存器)。
\{开始条件组(troff 命令的内置功能)。
\|1/6 单位长度,小间距(troff 命令的内置功能)。
\}结束条件组(troff 命令的内置功能)。
\*~表示代字号(字符串)。

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

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

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

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

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

正式备忘录的开始宏

.ND Date设置新的日期。
.TL [ChgNumber] [FileNumber]设置标题信息。下一行文本作为文档的标题。
.AF [CompanyName]指定作者的公司名。
.AU Name [Initials] [Loc] [Dept] [Ext] [Room] [Option...]设置作者信息。
.AT AuthorTitle [...]指定标题,跟在签名人的姓名后面(达 9 个选项)。
.TM [Number]设置技术备忘录的编号。
.AS [ 0 | 1 | 2 ] [Indent]仅启动技术备忘录和论文发行版的专用摘要:
0
封面和首页上的摘要
1
只在封面上的摘要
2
只在文件封面的备忘录上的摘要。

.AE结束摘要。
.NS启动符号,允许为紧跟 .AS 2/.AE 宏对的文件封面页打开备忘录(请参阅』 结束宏 『)。
.NE结束符号,允许为紧跟 .AS 2/.AE 宏对的文件封面页打开备忘录(请参阅 』 结束宏 『)。
.OK [Keyword ...]指定其它关键字(最多 9 个选项)。
.MT [type] [title]设置文档类型:
』『
无类型。
0
无类型(内部信件)。
1
文件的备忘录。
2
程序员注释。
3
工程师注释
4
发布的论文。
5
外部信件。
』String
打印指定字符串。

标题使用用户提供的文本作为页码前缀

商业信函宏

.WA开始作者地址。
.WE结束作者地址。
.LO CN [Notation]指定机密符号。
.LO RN [Notation]指定参考符号。
.IA开始内部(收件人)地址。
.IE结束内部(收件人)地址。
.LO AT [Notation]指定注意线。
.LO SA [Notation]指定尊称。
.LO SJ [Notation]指定主题行。
.LT [ { none BL SB FB SP} ]指定商业信函类型:
块的
BL
块的
SB
半块的
FB
全块的
SP
简化的。

结束宏(后缀信息)

.FC [Closing]打印正式的结束语。
.SG [Initials] [1]打印签名行。
.NS [{』 『0 1 2 3 4 5 6 7 8 9 10 11 12 13 String}]启动符号:
』 『
 
 
抄送
0
抄送
1
抄送(含附件)
2
抄送(无附件)
3
附件
4
多个附件
5
信中附件
6
多个信中附件
7
使用独立的封面
8
致信给
9
备忘录
10
抄送(含多个附件)
11
抄送(无附件)
12
专用摘要
13
完整的备忘录
字符串
复制( 字符串)到

.NE结束符号。
.AV Name [1]打印许可签名。
.CS [Pgs] [Other] [Tot] [Figs] [Tbls] [Ref]打印封面页。
.TX为目录标题调用用户出口。
.TY为目录页眉调用用户出口。
.TC [Slev] [Spacing] [Tlev] [Tab] [H1] [H2] [H3] [H4] [H5]打印目录。

段落

.P [ {0 1 2} ]启动段落:
0
左对齐(缺省值)
1
缩进
2
除在  .H.LE 和  .DE 后面以外采用缩进处理。
节标题

.H {1 2 3 4 5 6 7} [HeadingText] [FootnoteMark]指定编号的页眉。
.HU HeadingText指定未编号的页眉。
.HM {1 0001 A a I i}...指定页眉标记的样式:
1
阿拉伯数字
0001
以 0 开头的阿拉伯数字
A
大写字母
a
小写字母
I
大写罗马体
i
小写罗马体。

.HX [Dlev] [Rlev] [HeadingText]在页眉前调用用户自定义的退出宏。
.HY [Dlev] [Rlev] [HeadingText]在页眉中调用用户自定义的退出宏。
.HZ [Dlev] [Rlev] [HeadingText]在页眉后调用用户自定义的退出宏。

列表

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

.AL [ {1 A a I i} ] [TextIndent] [1]自动启动增量列表(1)。
.BL [TextIndent ] [1]启动项目符号列表。
.DL [TextIndent] [1]启动破折号列表。
.ML Mark [TextIndent] [1]启动列表,该列表中的每个列表项都被加上了指定的标记。如果 TextIndent 的值是NULL 或者被省略,则该值就被设为[Mark - width + 1]。如果指定了第三个自变量,则列表中的各项之间就没有空白行分隔。
.RL [TextIndent] [1]启动引用列表。
.VL TextIndent [MarkIndet] [1]启动变量标记列表。
.LI [Mark] [1]启动列表项;1 表示 Mark 变量的值被设为当前标记的前缀。
.LE [1]结束列表项;1 表示在列表后面输出一个空白行。缺省值为没有空白行。
.LB TextIndent MarkIndent PadType [Mark] [{0 1}] [{0 1}]开始列表:

Type 变量的值是:

 
1=. 2=) 3=() 4=[] 5=<> 6={}.

第六选项:

0
在每个列表项前没有空白行。

第七选项:

0
在列表前没有空白行。
.LC [Level]清除列表状态,直至 Level 变量值。
显示、表格、等式和脚注

.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右侧

页眉和页脚

.PH 』''居中''『指定页眉。
.OH 』''居中''『指定奇数页的页眉。
.EH 』''居中''『指定偶数页的页眉。
.PF 』''居中''『指定页脚。
.OF 』''居中''『指定奇数页的页脚。
.EF 』''居中''『指定偶数页的页脚。
.BS启动下对齐块。
.BE结束下对齐块。
.PX为页眉标题调用用户出口。
.TP调用页面顶部的宏。
其它宏

.B [Option] [Prev-Font-option]以粗体打印(最多六个选项)。
.I [Option] [Prev-Font-option]以斜体打印(最多六个选项);使用 nroff 命令来加下划线。
.R返回到罗马字体。
.PM [Option]设置专利标记。如果不向 .PM 宏赋予选项的话,请您关闭专利标记。/usr/lib/macros/string.mm 文件包含一些专利标记。该文件可以编辑以满足用户需要。
.RD [Prompt] [Diversion] [String]停止代码宏。Prompt 变量是用户自定义的、不含空格的字符串。Diversion 变量允许保存输入文本。String 变量包含在提示符后输入的第一行文本。
.RP [{0 1 }] [{0 1 2 3}]生成引用页:

第一选项:

0
复位引用计数器(缺省值)。
1
不复位引用计数器。

第二选项:

0
之后导致  .SK 宏(缺省值)。
1
之后不导致  .SK 宏。
2
之前不导致  .SK 宏。
3
之前或之后都不导致  .SK 宏。
.RS/.RF自动对引用进行编号。
.WC [{N WF -WF FF -FF WD -WD FB -FB}]控制脚注的宽度,在使用两栏的时候显示其宽度:
N
正常方式(  -WF-FF-WD)。
WF
始终保持宽脚注。
-WF
脚注与页面样式相同。
FF
第一个脚注决定本页上其它脚注的宽度。
-FF
脚注遵照  WF 或  -WF 选项的设置。
WD
始终保持宽显示。
-WD
显示页面样式相同。
FB
浮动显示产生页面间隔符(缺省值)。
-FB
浮动显示不产生页面中断。
.SP [Lines]向下跳行。
.SK [Number]跳过指定的页数。(缺省值为 1。)
.OP在奇数页中断。
.2C以两栏打印输出。
.1C以一栏打印输出(按照恢复的正常行宽)。
.SA [Option]设置右边界对齐

选项:

0
将缺省值设置为  Offnroff 命令的缺省值)。
1
将缺省值设置为  ontroff 命令的缺省值)。

如果没有指定任何选项,则宏还原成当前的缺省值。

.SM String1 [String2] [String3]如果省略了 String3 变量值,则将 String1 变量的值减小 1 磅;否则,将 String2 变量的值减小 1 磅。
.HC Character将连字符处理的字符设置为 Character 变量的值。
.S [PointSize] [VerticalSpacing]设置磅值和垂直间距(只在 troff 命令中)。

缺省值:

磅值 = 10p

垂直间距 = 12p

选项 1 和 2:

Number
新值。
+/-Number
增加至当前值。
D
缺省值。
C
当前值。
P
前一值。
.VM [Top] [Buttom]设置变量的垂直页边距。
.nP启动段落的双行缩进。

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

.IB斜体(nroff 的下划线)和粗体互换。
.BI粗体和斜体互换。
.RI罗马体和斜体互换。
.IR斜体(nroff 的下划线)和罗马体互换。
.RB罗马体和粗体互换。
.BR粗体和罗马体互换。
mm 寄存器

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

A *处理预打印的表单。
Au禁止作者信息出现在首页上(1)。
C *副本类型(如原稿和草稿)(0)。
Cl内容级别(2)。
Cp图形、表格、等式和显示的布置(1)。
D *调试标志(0)。如果设置为 1,则 mm 命令持续执行,即使遇到通常是致命性的错误也不停止。
De浮动显示后退纸(0)。
Df如果设置为 1,则要为浮动显示而格式化寄存器(5)。
Ds静态显示的前或后间距(1)。
E *控制主题/日期/发件人字段的字体(0):0 = 粗体;1 = 罗马体。
0
粗体(0)
1
罗马体。
Ec等式计数器。
Ej页眉的退纸标记(0)。
Eq等式标号布局(0)。
Ex显示计数器。
Fg图形计数器。
Fs垂直脚注间距(1)。
H1...H7页眉计数器。
Hb页眉中断级别(在 .H 和 .HU 之后)(2)。
Hc.H 和 .HU 的页眉居中对齐的级别(0)。
Hi页眉的临时缩进(在 .H 和 .HU之后)(1)。
Hs页眉空格的级别(在 .H 和 .HU之后)(2)。
Ht页眉类型:
0
连续数字(0)
1
单个数字(0)。
Hu没有编号的页眉的级别(2)。
Hy连字符处理控制;
0
没有连字符(0)
1
启用连字符。
L *页面长度(66v)。
Le目录后的等式列表(0):
0
不打印
1
打印。
Lf目录后的图列表(0):
0
不打印
1
打印。
Li列表缩进(5,troff 命令);(6,nroff 命令)。
Ls列表级别下降到项间有空白的级别(6)。
Lt目录后的表格列表(0):
0
不打印
1
打印
Lx目录后的显示列表(1):
0
不打印
1
打印。
N *编号样式(0)。
Np已编号的段落:
0
未编号
1
已编号(0)。
O *页面偏移。
Oc目录的页面编号样式:
0
小写罗马体
1
阿拉伯字体(0)。
Of图表标题样式(0)。
P页面编号;由 mm 命令管理(0)。寄存器接受 0 或负整数的值。
Pi段落缩进(5)。
Ps段落间距(1)。
Pt段落类型(0)。
Pv专用页眉
0
不打印专用
1
只在第一页
2在所有的页上(0)。
Rf引用计数器;由 .RS 宏使用。
S *troff 命令的缺省磅值(10)。
Si显示缩进(5)。
T *nroff 命令输出设备的类型(0)。
Tb表格计数器。
U *.H 和 .HU 的下划线样式(nroff 命令)(0)。
W *页面宽度(行和标题的长度)。
mm 字符串

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

\*x用于带单字符名称的字符串(x
\*(xx用于带双字符名称的字符串(xx)。
字符串名称

BU项目符号。
Ci目录中的标题缩进级别
DT当前日期。由语言环境设置指定的用于的 LC_TIME 类别的特定于语言环境的日期格式用作缺省设置。该设置同 strftime 子例程的 %x 格式说明符相对应。使用 .ND 宏来更改当前日期。
EM破折号。
F脚注编号。
HF标题级字体字符串:
1
罗马体
2
斜体
3
粗体(2 2 2 2 2 2 2)。

HP不同级别标题的磅值。
Le等式列表的标题。
Lf图形列表的标题。
Lt表格列表的标题。
Lx显示列表的标题。
REmm 宏的 SCCS SID。
Rf引用编号器。
Rp引用页面的标题。
Tm商标。
`抑音符
'重音符。
^长音符。
~代字符号。
:小写变元音符号。
;大写变元音符号。
,变音符。
保留名称

如果要自定义字符串、宏和寄存器,只能使用单个小写字母或者一个小写字母后跟一个非小写字母字符来命名。名称 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 命令请求可能会产生无法预料的结果。但是,以下列表中的头四个请求可以在初始化之后使用,最后两个请求可以在初始化之前使用。

.bp开始新一页。
.br中断输出行。
.ce [Number ]居中对齐下一个指定行号。
.ls [Number ]设置行间距。将 Number 变量的值设为 1 以表示单空格文本;设置为 2 来表示双空格文本。
.na关闭右页边距对齐。
.sp [Number]插入指定数量的空白行。

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

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

.nr LL 6.5i

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

ms 请求

以下是外部 ms 宏请求:

.AB [X]

开始摘要。如果 X 为 no,不标记摘要。

初始值:-

中断:yes

.AE结束摘要。

中断:yes初始值:-

中断:yes

.AIName作者的机构。

初始值:-

中断:yes

.AM设置重音标记定义。

初始值:-

中断:no

.AUName设置作者名。

初始值: -

中断:yes

.B [X]将 X 设置为黑体。如果没有 X,切换到黑体。

初始值:-

中断:no

.B1打开框中所附的文本。

初始值: -

中断: yes

.B2结束框中文本并打印。

初始值: -

中断:yes

.BT在页脚打印底部标题。

初始值: date

中断:no

.BX X打印框中的字 X

初始值: -

中断:no

.CM页间剪切标记。

初始值: if t

中断:no

.CT指示章标题;页编号移动到 CF(TM)。

初始值: -

中断:yes

复位:yes

.DA [X]页面底部的强制日期 X。如果没有 X,日期为当天。

初始值:if n

中断:no

.DE结束任意类型的显示(未填充文本)。

初始值: -

中断:yes

.DS X Y使用保留语句开始显示。X=I, L, C, B; Y=indent.

初始值: I

中断:yes

.ID Y显示无保留缩进。Y=indent.

初始值: 8n、.5i

中断:yes

.LD设置无保留语句的左显示。

初始值: -

中断:yes

.CD无保留居中显示。

初始值: -

中断: yes

.BD块显示;整块居中。

初始值: -

中断: yes

.EF X设置偶数页页脚 X(3 作为 troff 命令、.tl 请求的一部分)。

初始值: -

中断:no

.EH X设置偶数页页眉 X(3 作为troff 命令、.tl 请求的一部分)。

初始值: -

中断:no

.EN结束 eqn 命令生成的已显示的等式。

初始值: -

中断:yes

.EQ [X] [Y]中断等式。X=L, I, C; Y 是等式编号。

初始值: -

中断:yes

.FE结束将放置在页面底部的脚注。

初始值: -

中断:: no

.FP数字脚注段落;可以重新定义。

初始值: -

中断:no

FS [X]开始脚注;X 是可选脚注标签。

初始值: -

中断:no

.HD在页标题的上边距下设置可选页标题。

初始值: undef

中断:no

.I [X]以斜体显示 X。如果没有 X,以相当于斜体字体的 .ft 2 显示。

初始值: -

中断:no

.IP X Y缩进段落,由悬挂标记 XY 指定缩进空格数。

初始值: -

中断: yes

复位:

.IX X Y索引文字,如 X 和 Y,达 5 个级别。

初始值: -

中断:yes

.KE结束任意类型的保留。

初始值: -

中断:no

.KF开始浮动保持;文本填充剩余部分。

初始值: -

中断:no

.KS开始保留;在单个页上保留多个单元。

初始值: -

中断:yes

.LG设置更大的字号;将磅值提高 2。只对 troff 命令有效。

初始值: -

中断:no

.LP开始左边块段落。

初始值: -

中断:yes

复位:yes

.MC X设置多列。X 是列宽。

初始值: -

中断:yes

复位:yes

.ND [X]表示页脚中没有日期;X 是封面上的日期。

初始值: if t

中断:no

.NH X Y设置编号页眉:X=level; X=0,复位;X=S,设置为 Y

初始值: -

中断:yes

复位:yes

.NL将磅值恢复为缺省值。只对 troff 命令有效。

初始值:10p

中断:no

.OF X设置奇数页页脚 X(3 作为 me 宏、.tl 请求的一部分)。

初始值: -

中断:no

.OH X设置偶数页页眉 X(3 作为 me 宏、.tl 请求的一部分)。

初始值: -

中断:no

.P1打印第一页页眉。

初始值: if TM

中断: no

.PP段落的首行缩进。

初始值: -

中断: yes

复位:yes

.PT打印页头上的页标题。

初始值: %

中断:no

.PX X打印索引(目录);X=不删除标题。

初始值: -

中断:yes

.QP给段落加引号(缩进并缩短)。

初始值: -

中断: yes

复位:yes

.R [X]返回到罗马体。以罗马体打印。如果 X 丢失,则等于字体 .ft1

初始值: on

中断: no

.RE退回(结束相对缩进的级别)。使用 .RS 请求。

初始值: 5n

中断:yes

复位:yes

.RP [X]以发行版论文格式打印标题页; X=no,停止第一页上的标题。

初始值: -

中断:no

.RS在一个缩进级别中右移(启动相对缩进级别)。使用 .IP 请求。

初始值: 5n

中断:yes

复位:yes

.SG设置签名行。
.SH设置未编号的节标题(黑体)。

初始值: -

中断:yes

复位:yes

.SM设置更小的字号;将磅值减少 2。只对 troff 命令有效。

初始值: -

中断:no

.TA将标签设置为 8n、16n ...(nroff);5n、10n ... (troff)。

初始值: 8n5n

中断:no

.TC X在末尾打印目录;X=不删除标题。

初始值: -

中断:yes

.TE结束 tbl 命令处理的表格。

初始值: -

中断:yes

.TH结束表格的多页页眉。必须同 .TS H 请求一起使用。

初始值: -

中断:yes

.TL设置标题行(黑体,大两号)。

初始值: -

中断:yes

.TM设置 UC Berkeley 论文方式。

初始值: off

中断:no

.TS X开始表格。如果 X 为 H,表格将打印所有页上的页眉。

初始值: -

中断:yes

复位:yes

.UL X下划线 X,即使对于 troff 命令也生效。

初始值: -

中断:no

.UX X设置 UNIX; 第一次商标消息;X 被添加。

初始值: -

中断:no

.XA X Y设置另一个索引项;X=页;X=no,无。

初始值:-

中断:yes

.XE结束索引条目或者 .IX 请求条目系列。

初始值: -

中断:yes

.XP段落的第一行突出;其它缩进。

初始值: -

中断:yes

复位:yes

.XS X Y开始索引条目;X=页X=no,无;Y=缩进。

初始值: -

中断: yes

.1C开始一列格式,在一个新页面上。

初始值: on

中断: yes

复位:yes

.2C开始两列格式。

初始值:-

中断: yes

复位: yes

.]-设置 refer 命令引用的开始。

初始值: -

中断: no

.[0设置不可分类的引用类型的结尾。

初始值: -

中断: no

.[N对于杂志类文章,N=1 (一)。对于书,N=2。对于书籍类文章,N=3。

初始值: -

中断:no

ms 寄存器

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

PS设置磅值。对段落生效。缺省值为 10。
VS设置垂直间距。对段落生效。缺省值为 12。
LL设置行长度。对段落生效。缺省值为 6i。
LT设置标题长度。对下一页生效。缺省值为 LL 寄存器的值。
FL设置脚注长度。对下一个 .FS 请求生效。缺省值为 5.5i。
PD设置段落距离。对段落生效。缺省值为 1v (在 nroff 中),.3v(在 troff中)。
DD设置显示距离。对显示生效。缺省值为 1v(在 nroff 中),.5v(在 troff 中)。
PI设置段缩进。对段落生效。缺省值为 5n。
QI设置引用缩进。对下一个 .QP 请求生效。缺省值为 5n。
FI设置脚注缩进。对下一个 .FS 请求生效。缺省值为 2n。
PO设置页偏移量。对下一页生效。缺省值为 0(零)(在 nroff)、1i(在 troff 中)。
HM设置页眉边距。对下一页生效。缺省值为 1i。
FM设置页脚边距。对下一页生效。缺省值为 1i。
FF设置脚注格式。对下一个 .FS 请求生效。缺省值为 0(零)(1、2、3 可用)。

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

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

\*Q打开引号(在 nroff 中;` ` 在 troff 中)
\*U关闭引号( 在 nroff 中;' ' 在 troff 中)
\*-破折号(-- 在 nroff 中;- 在 troff 中)
\*(MO月份
\*(DY日(当前日期)
\**自动编号的脚注
\*'重音符(字母前)
\*`抑音符(字母前)
\*^抑扬音符(字母前)
\*,变音符(字母前)
\*:变元音(字母前)
\*~代字号(字母前)。

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

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

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

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

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

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

Foil-start 宏

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

.VS [FoilNumber] [FoilID] [Date]开始一个方形视图。幻灯片大小为常宽各 7 英寸。foil-start 宏将所有变量(如缩进和磅值等)都重新设置为初始缺省值,不包括从上一个 foil-start 宏继承的 FoilID 和 Date 变量值。.VS 宏还会调用 .A 宏。
.Vw .Vh.VW .VH.Sw .Sh .SW.SH同 .VS 宏相同,除了这些宏启动的视图(V)或者幻灯片(S)是小宽度(w)、小高度(h)、大宽度(W)、或者大高度(H)的。

建议使用以下宏:

  • .VS 用于方视图或者幻灯片。
  • .Sw(以及如果需要时的 .Sh)用于 35mm 幻灯片。
.Vw [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,5英寸高之外。
.Vh [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 5 英寸宽,7英寸高之外。
.VW [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,5.4英寸高之外。
.VH [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,9英寸高之外。
.Sw [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,5英寸高之外。
.Sh [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 5 英寸宽,7英寸高之外。
.SW [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,5.4英寸高之外。
.SH [FoilNumber] [FoilID] [Date]与 .VS 宏相同,除了幻灯片为 7 英寸宽,9英寸高之外。
注:
.VW 和  .SW 幻灯片意味着是 9 英寸宽,7 英寸高。但是,因为排版机的页面通常只有 8 英寸宽, .VW 和  .SW 片只能被打印为 7 英寸宽,5.4 英寸高,在作为视图使用之前必须按照 9/7 的比例扩大。
级别宏

.A [X]将后面的文本置于第一个缩进级别(左边距)。X 变量的存在可以删除前面的文本的半行空格。
.B [Mark [Size]]将后面的文本置于第二个缩进级别。文本之前有一个指定的标记(缺省为一个大项目符号)。Size 变量表示该标记的磅值的增加或者减小,增大或者减小都是相对于 prevailing 磅值(缺省为 0)的。将 Size 变量的值设为 100,会使标记的磅值等于 Mark 变量的缺省值。
.C [Mark [Size]]与 .B 宏相同,不过是用于第三个缩进级别。Mark 变量的缺省值为一个破折号。
.D [Mark [Size]]与 .B 宏相同,不过是用于第四个缩进级别。Mark 变量的缺省值为一个小项目符号。
文本控制宏

.I [+/-] [Indentation] [A[X]]改变当前的文本缩进(不影响标题)。指定的缩进值都是以英寸为单位的,除非指定尺寸。缺省值为 0。如果 Indentation 变量标记了正负号,缩进会相应增加或者减少。A 变量的存在可以调用 .A 宏并将 X 变量(如果有)传递给它。
.S [Size] [Length]设置磅值和行长度。在 Size 变量中指定的值为磅值(缺省为前一值)。如果 Size 变量的值为 100,当前的 foil-start 宏的磅值将还原为 initial 缺省值。如果 Size 变量标有正负号,表示变量值的增加或者减少(.VS.VH 和 .SH 宏的缺省值为 18,其它 foil-start 宏的缺省值为 14)。Length 变量指定行的长度(除非指定尺寸,否则都是以英寸为单位;.Vh 宏的缺省值为 4.2 英寸,.Sh 宏的缺省值为 3.8 英寸,.SH 宏的缺省值为 5 英寸,其它 foil-start 宏的缺省值为 6 英寸)。
.T String将 String 变量值打印为居中的、放大的标题。
.U String1[String2]给 String1 变量值添加下划线,并将其同 String2 变量 值(如果有的话)相连接。不推荐使用该操作。
缺省设置宏

.DF [Number Name ]...设置字体位置。不能在幻灯片输入文本内显示;必须跟在幻灯片的输入文本后,但是还必须在下一个 foil-start 宏前。指定的数字是 Name 变量指定的字体的位置。.DF 宏可以接受多达四对 Number Name 变量,如 1 H。第一个 Name 变量指定主要字体。例如:.DF 1 H 2 I 3 B 4 S.
.DV [A] [B] [C] [D]更改缩进级别之间的垂直空格。由 ABC 或 D 变量指定的值分别是 .A.B.C 或 .D 宏的空格。所有的非空参数都必须指定尺寸。空参数不影响相应的空格。缺省设置为:.DV .5v .5v .5v 0v

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

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

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

Tm 字符串产生商标符号。

环境变量

LANG确定用于是或否查询的 y 的语言环境的等价值。允许的肯定响应在语言环境变量 YESSTR 中进行定义。如果没有设置 LANG,或者将其设置为空字符串,将使用缺省的 C 语言环境中的 YESSTR

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

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

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

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

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

数字参数输入

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

刻度基本单位数
指示符含义troffnroff
i英寸与机器有关240
c厘米 240x50/127
P12 点距 = 1/6 英寸 240/6
mEm = S 点 C
nEn = Em/2 C(与 Em 相同)
p点 = 1/72 英寸 240/72
u基本单位 1
v垂直行间距 V
k1宽度单宽度假名 C
K2宽度双宽度日语汉字 两个 C
缺省  
注:
  1. 如果选择了非日语汉字的输出设备,就要使用 en 宽度。
  2. 如果选择了非日语汉字的输出设备,就要使用 em 宽度。

在 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 可以指定为十进制分数的形式,但是最终存储的参数会被四舍五入为基本单位的整数。

字体和字符大小控制

.bd Font Number在使用 nroff 时,通过将指定字体的字符重叠打印指定次数来人为加粗字体,或者在使用 troff 时通过按 Number -1 基本单位分两次打印每个字符来人为地使指定字体的字符加粗。如果没有指定 Number 变量,粗体方式将被关闭。Font 值必须是一个 ASCII 字体名称或者字体位置。在 nroff 命令中,.bd 请求的缺省设置为 3 3,表示该字体的字符位于位置 3(通常为粗体),将被叠印 3 次(也就是在一个位置打印 4 次)。

字体名称本身可以替换字体位置;例如 .bd I 3Number 变量在功能上同 nroff 命令的 -u 标志相同。(当字符被物理打印时,粗体方式必须有效。)该请求可以影响 .b 一般数字寄存器的内容。

粗体方式仍必须有效,或者在物理输出时重新启动。您不能关闭 nroff 命令中的粗体方式,如果它由打印设备进行本地控制的话,例如 DASI 300。

初始值:Off

如果没有指定值: -

.bd S Font Number无论何时指定的字体是当前字体,确保字符为特定的字体粗体。当字符被物理打印的时候,该方式必须有效。Font 值必须是一个 ASCII 字体名称或者字体位置。该方式仍必须有效,或者在物理输出时重新启动。

初始值:Off

如果没有指定值:-

.cs Font Number将恒定的字符空间(宽)方式设置为 Font 变量值(如果已安装)。每个字符的宽度按照 Number 变量中指定的值除以 36 em 设置。如果没有指定 M 变量,em 的宽度为字符的磅值。如果M 变量已经给出,宽度由 M 变量减磅值指定。所有受影响的字符都集中在该空格中,包括那些实际宽度大于该空格的字符。当指定字体为当前字体时,出现的特殊字体字符也一样处理。Font 值必须是一个 ASCII 字体名称或者字体位置。如果Number 变量不存在,该方式关闭。当字符被物理打印的时候,该方式必须有效。该请求会被 nroff 命令忽略。相关的值是当前环境的一部分。该方式仍必须有效,或者在物理输出时重新启动。

初始值:Off

如果没有指定值: -

.fpFont NumberFile ]指定字体位置。这是一个语句,表示指定的字体被安装在 Number 变量指定的位置上。Font 变量必须是一个单字符或者双字符的 ASCII 字体名称。
注意: 如果没有指定  Font 字体变量,则是一个不可恢复错误。

.fp 请求接受第三个可选变量,File 变量,它是包含指定字体的文件的实际路径名。File 变量值可以是任何合法的文件名,并且可以包含扩展字符。

日语支持:File 值可以是任何合法的文件名。值由排版机或者打印机决定。

初始值:-

如果没有指定值:忽略

.ft Font将字体样式更改为指定的字体,或者如果 Font 值是数值型的,将字体样式更改为该位置上安装的字体。或者,嵌入 \fFont 命令。字体名 P被保留,用来指示以前的字体。Font 变量值必须是一个 ASCII 字体名或者字体位置。

如果使用由两个字符构成的字体名,可以使用 .ft 的另外一个形式,\f。相关的值是当前环境的一部分。值由排版机或打印机决定。

初始值:罗马体

如果没有指定值:前一值

.ps [+/-][Number]将磅值设置为 +/-Number 变量指定的值。虽然可以请求任何正的大小值,但是当出现无效的字号时,系统将使用与之最接近的有效字号。字号 0 指上一个字号。或者,\sNumber 或 \s+/-Number;如果 Number 值是两位数,则使用 \s(Number 或者 \s+/-(Number。要兼容老版本的 troff命令,两位数值 10111214161820222428、和 36 的格式是有效的。

该请求被 nroff 命令忽略。相关的值是当前环境的一部分。

初始值:10 磅

如果不指定值:前一值

.ss Number将空白字符的大小设置为指定数字除以 36 em。该大小是调节后的文本中的最小字空格。该请求被 nroff 命令忽略。相关的值是当前环境的一部分。

初始值:12/36 em

如果没有指定值:忽略

页面控制

.bp [+/-][Number]指定中断页。弹出当前页,开始新一页。如果指定了 +/-Number 变量,它的值将成为新页面的编号。也可参考 .ns 请求。

该请求类似于 .br 请求,通常会引起行中断。带控制字符 』 ' 『(而不是 』.『)调用该请求会禁止该中断功能。

初始值:Number= 1

如果没有指定值:-

.mk Register在内部寄存器(与当前的转换级别相关联)或者在指定的寄存器(如果给出了的话)标记当前垂直位置(或者当前转换中的位置)。Register 变量是一个数字寄存器的 ASCII 名称。方式或者相关的值同当前的转换级别相关联。有关更多信息,请参阅 .rt 请求。

初始值:无

如果没有指定值:内部

.ne Number D表示对指定的垂直空间的需求。如果所需的页面空间(Number)比下一个陷阱(D)的距离大,出现一个 D 大小的前向垂直空间,由它激发陷阱。如果页面上没有保留下的陷阱,由 D 变量指定的大小就是到页底的距离。如果到下一个陷阱的距离(D)小于一个垂直行间距(v),在陷阱激发之前,仍然可以输出另一行。在转换中,由 D 指定的大小为到转换陷阱的距离(如果有的话),或者非常大。

D 的值通常也包含在 .t Number 寄存器中。方式或者相关的值同当前的转换级别相关联。

初始值:Number=1V

如果没有指定值:-

.pl [+/-][Number]将页面长度设置为 +/-Number 变量的值。nroff 命令中的内部限制约为 136 英寸,但是会随着 troff 命令中的设备类型而变化。troff 命令的最大良好工作值为 75 英寸。当前的页面长度在 .p 寄存器中可用。

初始值:11 英寸

如果没有指定值:11 英寸

.pn [+/-][Number]指定下一页(当出现时)的页编号由 +/-Number 变量指定。.pn 请求必须出现在文本被第一次打印之前或者中断对第一页的页号造成影响之前。当前的页号在 % 寄存器中。

初始值: Number=1

如果没有指定值:忽略

.po [+/-][Number]指定页偏移量。当前的左页边距设置为 +/-Number 变量值。初始 troff 命令值提供了 1 英寸的左边距。有关更多信息,请参阅 』行长度和缩进『。当前的页偏移量在 .o 寄存器中可用。

初始值:0 用于 nroff 命令;1 用于 troff 命令。

如果没有指定值:前一值

.rt [+/-][Number]仅向上返回到当前转换中的已标记的垂直位置。如果已给出 +/-Number 变量值(相对于当前位置),此位置就是由 +/-Number 变量指定的从页面或转换顶部算起的值。如果 Number 变量没有被指定,此位置将被上一个 .mk 请求标记。方式或者相关的值与当前的转换级别相关联。

.sp 请求而不是 .rt 请求可以在所有情况下使用,通过留空到存储在一个明确的寄存器中的一个绝对位置,例如,当使用顺序 .mkRegister . . . .sp|\nRu 时。

初始值:无

如果没有指定值:内部

文本填充、调整和居中

.ad Indicator开始行调整。如果填充方式没有打开,调整将被延迟,直到填充方式被重新开启。如果 Indicator 变量存在,调整类型将像以下列表所显示的那样更改:
指示符
调整类型
l
只调整左边距。
r
只调整右边距。
c
居中。
b 或  n
调整双面边距。
空白
不改变。

调整指示符可以是一个从 .j 寄存器中获取的数字。

日语支持:

指示符调整类型
k开启 kinsoku shori 处理(使用 .ad n.ad b 或 .ad l 关闭)。

通常,日语文本行会填充到页边空白上,而不必考虑行首和行尾的字符。当 kinsoku shori 处理开启以后,开括号字符就不能位于行尾,关括号字符或者标点符号也不能位于行首。如果一行以开括号结尾,该行将被左缩短,括号将开始下一行。如果一行以关括号或者标点符号开头,前面的一行将被扩展,关括号或者标点符号结束前一行。在不支持日语汉字字符的输出设备上请求日语 kinsoku shori 处理是无效的。

相关的值是当前环境的一部分。

初始值:调整,两者

如果没有指定值:调整

.br指定中断。停止对正在被收集的行进行填充,行没有经过调整就输出。以空格字符开头的行和空文本行(空白行)也会引起中断。

初始值:-

如果没有指定值:-

.ce [Number ]在当前的行长度减去缩进的范围内,居中对齐下一个指定的输入文本行号。如果 Number 变量等于 0,所有的余数都会被清空。中断将会出现在每个 Number 变量输入行后面。如果输入行太长,将会对其进行左调整。相关的值是当前环境的一部分。该请求通常会造成同 .br 请求相类似的行中断。带控制字符 』 『 调用该请求(而不是 』.『)禁止该中断功能。

初始值:Off

如果没有指定值: 编号=1

.fi填充后继输出行。.u 寄存器的值在填充方式中为 1(一),在非填充方式中为 0(零)。相关的值是当前环境的一部分。该请求类似于.br 请求,通常会引起行中断。带控制字符 』 『(而不是』.『)调用该请求禁止该中断功能。

初始值:填充

如果没有指定值: -

.na指定非调整方式。关闭调整;右边距被消除。.ad 请求的调整类型未改变。如果填充方式开,还可以进行输出行填充。相关的值是当前环境的一部分。

初始值:无

如果没有指定值: -

.nf指定非填充方式。随后的输出行既不能填充也不能调整。输入文本行被直接复制到输出行,而不考虑当前的行长度。相关的值是当前环境的一部分。该请求通常会造成同 .br 请求相类似的行中断。带控制字符 』 ' 『(而不是 』.『) 调用该请求禁止该中断功能。

初始值:填充

如果没有指定值: -

垂直间距

空白文本行引起中断并输出一空白行,同 .sp 1 请求完全一样。
.ls Number将行间距设置为由 +/-Number 变量指定的值。Number -1 Vs(空白行)变量的值附加到每个输出文本行。如果文本或者前一个附属空白行到达陷阱位置,则省略附加空白行。相关的值是当前环境的一部分。

初始值:1

如果没有指定值:前一值

.ns开启无间距方式。一旦开启,无间距方式将禁止没有下一个页编号的 .sp 和 .bp 请求。无间距方式在输出一行时被关闭,或者用 .rs 请求关闭。该请求通常会造成一个中断。

初始值:空格

如果没有指定值: -

.os输出保存垂直间距。无间距方式无效。用于输出由前一个 .sv 所请求的一个垂直间距块。

初始值:-

如果没有指定值: -

.rs恢复间距。无间距方式关闭。该请求通常会造成一个中断。

初始值:无

如果没有指定值: -

.sp Number在每个方向上设置垂直间距。如果 Number 变量值为负,移动将是向后(向上)的,并且被限制在到页面顶部的距离内。向前(向下)的移动被截断为到最近的陷阱的距离。如果无间距方式打开,不会出现任何间距。请参阅 .ns 和 .rs 请求。该请求类似于 .br 请求,通常会导致行中断。带控制字符 』'『(而不是 』.『)调用该请求禁止该中断功能。

初始值:-

如果没有指定值:1V

.sv Number保存指定大小的一个连续垂直块。如果到下一个陷阱距离大于 Number 变量的值,指定的垂直间距将被输出。无间距方式无效。如果此距离小于指定的垂直间距,不会立即输出垂直间距, 但是会被记忆用于接下来的输出(请参阅 .os 请求)。随后的 .sv 请求会覆盖所有被记忆的Number 变量值。

初始值:-

如果没有指定值:Number=1V

.vs Number将垂直基线间距的大小 V 设置为 Number 变量的值。瞬时的额外垂直间距可以由 \x N 来指定。相关的值是当前环境的一部分。

初始值: Number 变量对于 nroff 命令等于 1/16 英寸,对于 troff 命令等于 12 磅。

如果没有指定值:前一值

行长度和缩进

.in [+/-]Number将缩进设置为 +/-Number 变量的值。缩进在每一个输出行之前。相关的值是当前环境的一部分。该请求类似于 .br 请求,通常会生成行中断。带控制符 』 ' 『(而不是 』.『)调用该请求禁止该中断功能。

初始值:Number=0

如果没有指定值:前一值

.ll [+/-]Number将行长度设置为 +/-Number 变量的值。在 troff 命令中,最大行长度加页面偏移量是由设备决定的。相关的值是当前环境的一部分。

初始值:6.5 英寸

如果没有指定值:前一值

.ti [+/-]Number指定临时缩进。下一个输出文本行按照 +/-Number 变量指定的相对于当前缩进的值缩进。Number 变量的值如果为负的话,可能会导致当前缩进向后退,从而使总缩进值为 0(零)(等于当前的页偏移量),但是不能小于当前的页偏移量。临时缩进仅应用于跟在请求后面的一个输出行; 存储在 .i 寄存器中的当前缩进值不会发生变化。

相关的值是当前环境的一部分.该请求通常会造成同 .br 请求相类似的行中断。带控制符 』 ' 『(而不是』.『)调用该请求禁止该中断功能。

初始值:-

如果没有指定值:忽略

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

.am Macro1 [Macro2]附加 Macro 1;;附加 .de 请求的版本。Macro1 和 Macro2 变量都必须是一个或者两个 ASCII 字符。Macro2 是用来结束转换的终止序列。

初始值: -

如果没有指定值:.Macro2=..

.as StringName String将指定的字符串附加给由 StringName 变量指定的值;附加 .ds 请求的版本。StringName 变量的值必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值:忽略

.ch Macro [Number]将指定的宏的陷阱位置更改为 Number 变量指定的值。如果不存在 Number 变量,陷阱(如果有的话)将被移除。Macro 变量必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值: -

.da [Macro]转换,附加指定的宏和附加 .di 请求的版本。Macro 变量必须是一个或者两个 ASCII 字符。方式或者相关的值同当前的转换级别相关联。

初始值: -

如果没有指定值:结束当前的转换

.de Macro1 [Macro2]定义或者重新定义由 Macro1 变量指定的值。宏的内容在下一个输入行上开始。输入行在复制方式中被复制,直到定义被一个以.Macro2 开始的行停止。如果 Macro2 变量不存在,定义由 』..『 开始的行停止。一个宏可以包含 .de 请求,只要停止宏不同或者包含的定义结束符被隐藏。』..『 可以被隐藏为 』\\ .『,它以 』\...『 的形式复制,并被重读为 』..『. Macro1 和 Macro2 变量都必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值:.Macro2=..

.di [Macro]转换输出到指定的宏。在转换过程中会发生普通文本处理,除非没有执行页面偏移。当 .di 或者 .da 请求没有变量时,转换结束。当使用嵌套转换被时,不会显示该类型的额外请求。Macro 变量必须是一个或者两个 ASCII 字符。方式或者相关的值同当前的转换级别相关联。

初始值:-

如果没有指定值:结束

.ds StringName String将由 StringName 变量指定的字符串定义为包含由 String 字符串指定的值。String 中的所有初始双引号都会被取消,以允许初始空白。StringName 变量必须是一个或者两个 ASCII 字符。
.ds StringName ^A <SetNumber>  <MessageNumber>  [^A』<DefaultMessage> 『] [^A<Argument> ^B<Argument> ^B <Argument>...]提供一个替换 .ds 语法,该语法可以将消息编目用于独立于语言的字符串定义。

在特定语言环境编目内的消息 SetNumber 和 MessageNumber 的基础上,消息编目在复制方式中被读取,相应的消息被置于 StringName变量中。要向下兼容,可以省略指定消息集和消息编号的初始序列。ASCII 码控制符 A(^A)为消息标识、缺省消息和可选自变量列表定界。ASCII 码控制符 B(^B)为单独的可选自变量列表定界。

在以下示例中,

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

2 是消息集的编号。

41 是消息编号。

引号内的文本(』. . .『) 是默认的消息。

\n(.F 是当前输入文件的名称。

\n(.c 是从输入文件中读取的行号。

如果您假设 troff 命令以如下条件运行:

  • 在消息集 2 中的 41 号消息同缺省消息相匹配。
  • 当前的输入文件为 paper.doc
  • .ds 伪指令在输入文件的行 124 上。

然后字符串 {c 被定义为:

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

其它示例为:

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

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

如果集编号和消息编号都被设置为零,则以当前本地格式返回当前的日期。可以在缺省消息字段中定义用户定义日期格式字符串。用户定义格式字符串必须符合 AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions 中的 strftime 函数所规定的转换规格。

在以下示例中:

.ds DT^A0 0

如果当前的日期是美国英语语言环境中的 1991 年 7 月 10 日,DT 将被定义为 7/10/91

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

如果当前日期是美国英语环境中的 1991 年 7 月 10 日,DT 将被定义为今天是 1991 年 7 月 10 日

第二个语法方法使用不广泛。它在随系统一同提供的 nroff 和 troff宏文件中使用,主要便于内部生成的消息的国际化。

初始值:-

如果没有指定值:忽略

.dt Number Macro当前的转换中,在 Number 变量指定的位置上安装转换陷阱,以开始指定的宏。另一个 .dt 请求重新定义转换陷阱。如果没有给出任何变量,转换陷阱将被除去。Macro 变量必须是一个或者两个 ASCII 字符。方式或者相关的值同当前的转换级别相关联。

初始值:-

如果没有指定值:关闭

.em Macro当所有的输出都结束时,调用特定的宏。作用同指定的宏的内容处于最后被处理的文件的末尾相同。指定的宏必须是一个或者两个 ASCII 字符。

初始值:无

如果没有指定值:无

.it Number macro设置一个输入行计数陷阱来在由 Number 变量指定的文本输入行编号被读取(不计控制和请求行)之后调用指定的宏。文本可以是内联文本,也可以是显式调用(通过内联调用)或者隐含调用(通过陷阱)的宏提供的文本。Macro 变量必须是一个或者两个 ASCII 字符。相关的值是当前环境的一部分。

初始值:-

如果没有指定值:关闭

.rm Name除去指定的请求、宏和字符串。从名称列表中除去 Name 变量值,所有与之有关的存储空间都被释放。随后的引用无效。Name 变量必须是一个或者两个 ASCII 字符。

初始值:-

如果没有指定值:忽略

.rn Name1 Name2将由 Name1 变量指定的请求、宏或者字符串值重命名为 Name2 变量指定的值。Name1 和 Name2 变量的值都必须是一个或者两个 ASCII 字符。

初始值:忽略

如果没有指定值: -

.wh Number Macro安装一个陷阱来在页面上的由 Number 变量指定的位置上调用指定的宏。负的 Number 变量值可被解释为与页面底部有关。任何以前安装在页面上由 Number 变量指定的位置上的宏都会被 Macro 变量的值所替换。Number 变量值为 0 表示页面顶部。如果不存在 Macro变量,在由 Number 变量指定的页面位置上发现的第一个陷阱将被除去(如果有的话)。Macro 变量必须是一个或者两个 ASCII 字符。

初始值:-

如果没有指定值: -

数字寄存器

.af Register Indicator为指定的寄存器指定分配 Indicator 变量所指定的格式。Register 变量必须是一个或者两个 ASCII 字符。可用的格式Indicator 变量的值如下:
指示符
编号序列
1
0,1,2,3,4,5, . . .
001
000,001,002,003,004,005, . . .
i
0,i,ii,iii,iv,v, . . .
I
0,I,II,III,IV,V, . . .
a
0,a,b,c, . . . ,z,aa,ab, . . . ,zz,aaa, . . .
A
0,A,B,C, . . . ,Z,AA,AB, . . . ,ZZ,AAA, . . .

一个有 N 位的阿拉伯格式指示符(例如 000000001)表示一个N 位数的字段宽度。只读寄存器和宽度功能总是使用阿拉伯数字格式表示的。

日语支持以下值指定了用于格式化日语汉字的数字输出的字符宽度:

k
数字按照日语汉字字符串进行格式化。如果在指定非日语汉字代码集时要求使用此格式,将打印警告信息并使用  1 格式。

初始值:阿拉伯字体

如果没有指定值: -

.nr Register +/-Number1 Number2参照上一个值(如果有的话),为指定的寄存器分配由 +/-Number 变量指定的值。自动增长的增量设定为 Number2 变量值。Register 变量必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值: -

.rr Register除去指定的寄存器。如果许多寄存器都是动态创建的,则可能需要移除一些不需要的寄存器来为新的寄存器恢复内存空间。Register 变量必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值: -

制表符、引导符和字段

.fc Delimiter Indicator将字段定界符设置为指定的定界符;填充指示符设置为空格字符或者指定的指示符。如果缺少变量,字段机制将被关闭。Delimiter变量的值和 Indicator 变量的值必须是 ASCII 字符。

初始值:关闭

如果没有指定值:关闭

.lc Character将引导符重复字符设置为指定字符,或者取消指定动作。Character 变量的值必须是一个 ASCII 字符。相关的值是当前环境的一部分。

初始值:.

如果没有指定值:无

.taStop [Type]...设置制表符停止位。缺省的制表符停止位对于 nroff 命令每 8 个字符设置一个,对于 troff 命令为每半英寸设置一个。多个StopType 对可以通过使用空格隔开的方法来指定;前面有 +(加号)的值会被当作相对于前一个停止值的增量来处理。

指定的类型决定如何在制表符停止位上调整文本。Type 的值如下:

类型
调整
R
右对齐
C
中间对齐
空白
左对齐

相关的值是当前环境的一部分。

初始值:对于 nroff 命令为 8 ens,对于 troff 命令为 0.5 英寸。

如果没有指定值:无

.tcCharacter将制表符重复字符设置为指定字符,或者除去指定动作。Character 变量的值必须是一个 ASCII 字符。相关的值是当前环境的一部分。

初始值:无

如果没有指定值:无

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

.ccCharacter将基本的控制字符设置为指定的字符,或者重新设置为“.”。Character 变量的值必须是一个 ASCII 字符。相关的值是当前环境的一部分。

初始值:.

如果没有指定值:.

.cu [Number].ul 请求的一个变量会导致每个字符都会被加上下划线,也会导致在受影响的输出行中没有行中断发生。即 .cu 请求后的每个输出空格都与不可填充的空格相似。.cu 请求同在 troff 命令中的 .ul 请求完全相同。相关的值是当前环境的一部分。

初始值:Off

如果没有指定值: 编号=1

.c2 Character将无中断控制字符设置为指定的字符或者复位为 『 』。Character 变量的值必须是一个 ASCII 字符。相关的值是当前环境的一部分。

初始值:'

如果没有指定值:'

.ec Character将转义字符设置为 \ (反斜线符号) 或者 由 Character 变量指定的值(如果给出了的话)。Character 变量的值必须是一个 ASCII 字符。

初始值: \

如果没有指定值: \

.eo关闭转义机制。

初始值:开启

如果没有指定值: -

.lg [Number]如果 Number 变量的值不存在或者非零的话,打开连字方式;如果 Number 变量的值为 0 的话,关闭连字方式。如果 Number 变量的值为 2,只有双字符连字会被自动调用。请求、宏、字符串、寄存器或文件名以及复制方式中禁止使用连字方式。在 nroff 命令中,该请求不起作用。

初始值:开启,对于troff 命令

如果没有指定值:开启

.tr Character1 Character2 Character3 Character4将由 Character1 变量指定的字符的值翻译为 Character2 的变量值,将由 Character3 变量指定的字符值翻译为 Character4 的变量值。如果给出了奇数个字符,最后一个将被映射到空格字符中。要保持一致,从输入到输出的时间内必须保持特殊的转化在起作用。所有指定的字符都必须是 ASCII 字符。要重新设置 .tr请求,在请求后接上一个复制给出的变量。

例如,以下 .tr 请求:

.tr aAbBc<C,> 

可以通过输入以下命令来重新设置:

.tr aabbcc

在逻辑输出之前,它必须在起作用。

初始值:无

如果没有指定值: -

.ul [Number]对于 Number 变量指定的输入文本行数字在 nroff 命令中加下划线(或在 troff 命令中初始化)。实际上是切换成下划线字体,要保存当前的字体以备以后恢复用。.ul 请求范围内的其它字体更改生效,但是恢复只能撤销最后一次的更改。.tl 请求生成的输出会受到字体更改的影响,但是不会减小 Number 变量的值。有关更多信息,请参阅 』三部分标题 『一节。如果指定值大于 1,调用陷阱的宏非常有可能在该范围内提供文本行;环境切换可以避免发生这样的情况。

相关的值是当前环境的一部分。

初始值:关闭

如果没有指定值: 编号=1

.uf Font将字体集加下划线至 Font 变量指定的值。在 nroff 命令中,Font 变量不可以在位置 1 上(Times Roman 为初始值)。Font 变量的值必须是一个 ASCII 字体名。

初始值:斜体

如果没有指定值:斜体

连字符连接

.hcCharacter将将连字指示符设置为 Character 变量指定的值或缺省值。该指示符不在输出中显示。Character 变量的值必须是一个 ASCII 字符。相关的值是当前环境的一部分。

初始值: \%

如果没有指定值: \%

.hw Word1...指定由减号充当的连字符在单词中的磅值。以单词 s 结尾的版本是默示的;也就是说,dig-it 暗示 dig-its。去除后缀之前、之后检查该列表。可用的间距是 1024 个字符,即 50 到 100 个单词。

初始值:

如果没有指定值:忽略

.hyNumber如果指定的数字等于或大于 1,则自动打开连字符连接;如果指定的数字等于 0(等于 .nh 请求),则关闭连字符连接。如果指定的数字是 2,最后几行(导致陷阱的那些行)不被连字符连接。如果指定的数字是 4 或 8,则单词的开头两个字符或结尾两个字符都不能被分开写。这些值是可以相加的;比如:14 调用 3 种限制(2,4 和 8 相加等于 14)。

相关的值是当前环境的一部分。

初始值:没有连字符连接

如果没有指定值:使用连字符连接

.nh关闭自动的连字符连接。相关的值是当前环境的一部分。

初始值:没有连字符连接

如果没有指定值: -

三部分标题

.lt [+/-][Number]设置由 +/-Number 变量指定的标题长度值。行长度和标题长度是彼此独立的。在标题上不使用缩进,经管可以使用页面偏移。相关的值是当前环境的一部分。

初始值:6.5 英寸

如果没有指定值:上一个

.pcCharacter将页号字符设置为指定的字符或者将其除去。页号寄存器仍为 %。Character 变量的值必须是一个 ASCII 字符。

初始值: %

如果没有指定值:关闭

.tl'Left'Center'Right'LeftCenter 和 Right 变量代表的字符串分别为在当前的标题长度内的左对齐、居中对齐和右对齐。所有的字符串都可以为空,字符串的重叠也是允许的。如果在任何字段中有页号字符(初始为 %),则用当前页号替换它, 该页号的格式可以是指定给 % 寄存器的格式。未在字符串中显示的所有的 ASCII 字符都可以作为字符串的定界符。

初始值:-

如果没有指定值:-

输出行编号

.nm [+/-] [Number] [M] [S] [I]打开行号方式。如果指定了 M 变量,则只打印行号为 M 变量的值的整数倍的行。如果 M 变量不存在(缺省值为 M=1),则打印所有行。当使用行号方式时,一个三位的阿拉伯数字加上一个空格被预先挂起到输出文本行。此时文本行偏移四位空格,其它情况下行长保持不变。如果给定 S 变量,该变量将指定行号和文本之间的空格位数(缺省值为 S=1)。如果给定 I 变量,该变量将指定行号前缩进的空格位数(缺省值为I=0)。

相关的值是当前环境的一部分。

初始值: -

如果没有指定值:关闭

.nnNumber暂挂行编号。指定编号行未被编号。相关的值是当前环境的一部分。

初始值: -

如果没有指定值: Number=1

有条件的输入接收

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

o如果当前页是奇数页。
e如果当前页是偶数页。
t如果格式化程序是 troff 命令。
n如果格式化程序是 nroff 命令。
.if Condition Anything如果 Condition 变量指定的值是真,则接受 Anything 变量指定的值为输入;多行的情况,使用 \{Anything\}
.if !Condition Anything如果 Condition 变量指定的值是假,则接受 Anything 变量指定的值为输入。
.if Number Anything如果表达式表明 Number 变量的值大于 0,则接受 Anything 变量指定的值为输入。
.if !Number Anything如果表达式表明 Number 变量的值小于或等于 0,则接受 Anything 变量指定的值为输入。
.if 'String1'String2' Anything如果 String1 变量的值等于 String2 变量的值,则接受 Anything 变量指定的值为输入。在 String1 和 String2 变量中没有出现的所有的非空 ASCII 字符都可以被用作定界符。
.if !'String1'String2' Anything如果 String1 变量的值不等于 String2 变量的值,则接受 Anything 变量指定的值为输入。在 String1 和 String2 变量中没有出现的所有的非空 ASCII 字符都可以被用作定界符。
.el Anything指定 if/else 条件的 else 部分。
.ie Condition Anything指定 if/else 条件的 if 部分,指定的依据是 Condition 变量的值。能够与前面提到的所有的 .if 请求的格式一起使用。
环境切换

.ev Environment切换到指定的环境。由 Environment 变量指定的值必须是 0、1 或 2。切换是以下推的形式进行的,所以恢复到前一个环境只能依靠 .ev 请求来执行,而不是使用某个特定的引用。

初始值:Environment=0

如果没有指定值:前一值

标准输入的插入内容

.ex从 nroff 命令或 troff 命令中退出。文本处理停止,就象所有的输入已经结束时的情形。

初始值: -

如果没有指定值: -

.rd Prompt读取标准输入中的插入内容,直至在一行内查找到两个换行符。如果标准输入是用户的键盘,则指定的提示符(或 ASCII BEL 字符)被写到用户终端。 .rd 请求的行为与宏相似,附加的变量被放在 Prompt 变量的后面。

初始值:-

如果没有指定值: Prompt=the ASCII BEL 字符

输入、输出文件切换

.cfFile连续复制指定文件的内容到 troff 命令在此处的输出文件。如果文件中的移动不恢复到当前的水平和垂直位置的话,会出现问题。

初始值: -

如果没有指定值: -

.lf Number File校正 troff 命令对当前的行号(由 Number 变量指定)和在出现错误消息时使用的当前文件(由 File 变量指定)的解释。

初始值: -

如果没有指定值: -

.nx File使用指定的文件作为输入文件。当前的文件被认定已结束,立刻将输入转换到指定的文件。

初始值: -

如果没有指定值:结束文件

.pi Program将输出传输至指定的程序。该请求必须在所有打印开始前提出。没有变量被传输到指定的程序。

初始值: -

如果没有指定值:-

.so File转换源文件。指定的文件被转换成顶端输入(文件读取)级别。该文件结束后,仍然从源文件获取输入。 .so 请求可以嵌入其它程序。

当出现 .so 请求时,立刻对指定的文件进行处理。此时,中止对初始文件(如,仍然处于激活状态的宏)的处理。

如果有必要的话,一个文件可以在被 .so 请求调用之前被预处理。eqntblpic 和 grap 命令不通过 .so 请求来处理对象代码。

初始值: -

如果没有指定值:-

其它项

.ab Text将由 Text 变量指定的值打印到诊断输出(通常是终端),然后结束,不再进行进一步的处理。如果文本丢失,则打印 User Abort 消息,并刷新输出缓冲区。该请求在交互式调试时使用以进行强制输出。
.ab ^A<SetNumber> <MessageNumber>  [^A』<Default> 『]  [^A<Argument> ^B<Argument> ^B<Argument>...]提供备用语法,允许对独立语言的异常终止消息使用消息编目。打印由诊断输出(通常是终端)的参数指定的合适消息,然后结束,不再进行进一步的处理。如果没有参数,则消息编目如下:

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

为输出。输出缓冲区被刷新。该请求在交互式调试时使用以进行强制输出。

根据特定语言环境的编目中的消息 SetNumber 和 MessageNumber 变量,用户以复制方式读取消息编目,与其相关的消息被写入用户终端。要向下兼容,可以省略指定消息集和消息编号的初始序列。ASCII 代码 控件符 A(^A)为消息识别符、缺省的消息和可选的自变量列表定界。ASCII 代码控制符 B(^B)为单独的可选自变量列表定界。

在以下示例中:

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

2 是消息集的编号。

42 是消息编号。

引号中的文本 』...『 是缺省的消息。

\n(c. 是从输入文件中读取的行号。

如果假设 troff 命令在以下条件下运行:

  • 处于消息集 2 和编号 42 的消息与缺省的消息相匹配。
  • .ab 伪指令处于输入文件的 124 行。

然后以下内容将在用户终端上显示:

处理 已经 被 终止 在 行 123.

初始值: -

如果没有指定值:用户取消

.Dt Parameter定义 nroff 或 troff 请求的日期返回格式。根据缺省设置,如果没有可选 Parameter,则使用由为 LC_TIME 分类设置的当前语言环境指定特定语言环境的日期格式。这与 strftime 的 』%x『 格式说明符相符合。Parameter 是格式字符串, 同与 AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions 中的 strftime 函数共用的格式字符串一样。参考该函数,以了解格式说明符的完整列表。

例如,

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

为使用英语的地区提供了以下输出:

星期四, 1 月 31 日,1991(10:40:00)

%A 格式被具体地区的星期名称替代。%B 格式被具体地区的月份名称替代。%d 格式被使用两位格式的日期替代。%Y 格式被十进制数的世纪年份替代。%T 格式被十进制数的时(24小时制)、分、秒时间代替。该格式提供闰秒和双闰秒。

.fl刷新输出缓冲区。该请求类似于 .br 请求,通常会生成行中断。带控制符 』 ' 『(而不是』.『)调用该请求禁止该中断功能。

初始值: -

如果没有指定值: -

.ig Macro忽略输入行。.ig 请求和 .de 请求的操作完全相同,除了前者的输入被废弃。获取更多相关信息,请参阅 』宏、字符串、转换和位置陷阱『。输入以复制方式被读取,所有的自动递增寄存器都会受到影响。Macro 变量必须是一个或者两个 ASCII 字符。

初始值: -

如果没有指定值: .Macro=..

.mc [Character] [N]使用指定字符作为边界字符来显示到每个非空文本行( .tl 请求生成的文本行除外)的右边界的指定的距离(N)。如果输出行过长(非填充方式下经常出现的情况),则将字符附加到行。如果没有给定 N 变量,则使用前一个 N 变量。第一个 N 变量在 nroff 命令中是 0.2 英尺,在 troff 命令中是 1 em。

相关的值是当前环境的一部分。

初始值:在 nroff中是 2;在 troff中是 1 em。

如果没有指定值:关闭

.pm [Character]打印宏。在用户终端中打印所有已定义的宏和字符串的名称和大小。如果将一个 ASCII 字母数字字符作为变量,则只打印总大小。在 128 字符块中给出来大小。

初始值: -

如果没有指定值:全部

.sy Command [标志]指定的命令被运行但是它的输出在此没有被捕获。指定命令的标准输入被关闭。必须将输出在输出文件中明确的保存,以备以后进行处理。通常,.sy 伪指令后面会跟随 .so 伪指令,用来包含前一个命令的结果。

例如:

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

初始值: -

如果没有指定值: -

.tm String指定的字符串被写入用户终端。
.tm ^A<SetNumber> <MessageNumber>  [^A』<DefaultMessage> 『]  [^A<Argument> ^B <Argument> ^B<Argument> ...]根据特定语言环境目录中的消息集的编号和消息编号,消息目录被以复制方式进行读取,相关消息被写入用户终端。为了向下兼容,可以省略指定消息集和消息编号的初始序列。ASCII 码 Ctrl-A ^A 将消息识别符、缺省的消息和可选的自变量列表定界。ASCII 码 Ctrl-B ^B 为单独的可选自变量列表定界。

在以下示例中:

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

2 是消息集的编号。

23 是消息编号。

引号中的文本 』...『 是缺省的消息。

\*(.T 是 troff 中 -T 值的第一个自变量。

\n(c. 是从输入文件中读的行号。

如果假设 troff 命令在以下条件下运行:

  • 处于消息集 2 和编号 23 的消息与缺省的消息相匹配。
  • 命令行含有 troff,它正在使用 -T 选项和 PSC 设备。
  • .tm 伪指令处于输入文件的 539 行。

然后以下内容将在用户终端上显示:

The typesetter is psc. On line 538.

在 /usr/lib/nls/msg/$LANG/macros.cat 中可以找到特定语言环境的消息编目。

初始值: -

如果没有指定值:新行

注释

以下的注释在 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 值。

环境变量

LC_ALL指定供所有语言环境目录使用的语言环境。它将覆盖所有其它的语言环境变量的设置。
LC_MESSAGES指定 LC_MESSAGES 目录的语言环境值。在 LC_ALL 环境变量没有设置的情况下使用该变量。
LC_TIME指定 LC_TIME 目录的语言环境值。在 LC_ALL 环境变量未设置的情况下使用。
LANG指定供所有语言环境目录使用的语言环境。在上面提到的所有的环境变量未设置的情况下使用它。这是在指定语言环境时最常用的环境变量。

文件

/usr/share/lib/tmac/tmac.*包含标准宏文件的指针。
/usr/share/lib/macros/*指示标准宏文件。
/usr/share/lib/tmac/tmac.an包含 man 宏软件包的指针。
/usr/share/lib/macros/an包含 man 宏软件包。
/usr/share/lib/tmac/tmac.e 文件包含 me 宏的定义文件。
/usr/share/lib/me 目录包含宏定义文件。
/usr/share/lib/tmac/tmac.m包含 mm 宏软件包的指针。
/usr/share/lib/macros/mmn包含 mm 宏软件包。
/usr/share/lib/macros/mmt包含 mm 宏软件包。
/usr/share/lib/tmac/tmac.ptx指向宏软件包。
/usr/share/lib/macros/ptx包含宏软件包。
/usr/share/lib/tmac/tmac.x包含宏的定义文件。
/usr/share/lib/ms包含 ms 宏的定义。
/usr/share/lib/tmac/tmac.v包含宏的定义。
/usr/share/lib/macros/vmca包含宏的定义。
/usr/lib/nls/msg/$LANG/macros.cat包含 mmmems 和 mv 宏软件包的特定语言环境的消息编目。
/usr/lib/font/dev*/*包含字体宽度表。
/var/tmp/trtmp*指示临时文件。

出处:http://study.chyangwa.com/IT/AIX/aixcmds5/troff.htm

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值