手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

troff(1)

名称

troff - 对文档进行排版或版式设计

用法概要

troff [-a] [-f] [-Fdir] [-i] [-mname] [-nN] [-o
list] [-raN] 
     [-sN] [-uN] [-z] [filename]...

描述

troff 可对 filename 中的文本进行版式设计,以便排版或激光打印。troff 的输入应该由穿插着版式设计请求和宏的文本构成。如果 filename 参数不存在,troff 将读取标准输入。减号 (−) 作为 filename 表示应该在输入文件列表中的相应位置读取标准输入。

选项

支持以下选项。它们可以按任意顺序出现,但是必须全部都在第一个 filename 前面出现。

–a

将经过版式设计的输出的 ASCII 近似版本发送到标准输出。(注意:也可以使用一个很少使用的旧命令 /usr/bin/ta 在普通终端上输出 ASCII 粗略版本。)

–f

不要在输出的最后一页后打印尾部,否则会导致后处理程序放弃对设备的控制。

–Fdir

从目录 dir 而非系统缺省目录中搜索字体宽度或终端表。

–i

在读取完所有输入文件后读取标准输入。

–mname

在输入 filename 前面添加宏文件 /usr/share/lib/tmac/name。注意:对宏软件包的大多数引用都在名称中包含前导 m,例如 /usr/share/lib/tmac/an 中的 man(5) 宏。通过将 TROFFMACS 环境变量设置为特定路径可以更改宏目录。请确保在路径结尾添加尾随的 " / "(斜杠)。

–nN

将最先生成的页面编号为 N

–olist

只打印页号和页号范围逗号分隔 list 中出现的页号对应的页面。页号范围 NM 表示第 N 页到第 M 页;首页页号N 表示开头一页到第 N 页;N末页页号表示第 N 页到最后一页。

–q

nroff 中的静默模式,在 troff 中忽略。

–raN

将寄存器 a(仅包含一个字符的名称)设置为 N

–sN

N 页停止一次照相排字机。在某些设备上,troff 会生成尾部以便您更改暗盒;按排字机的开始按钮可以恢复。

–uN

将位置 3 处安装的字体的粗体系数设置为 N。如果缺少 N,则将粗体系数设置为 0。

–z

不输出经过版式设计的文本。仅输出使用 .tm 请求的诊断消息和消息输出。

操作数

支持下列操作数:

filename

包含要由 troff 处理的文本的文件。

文件

/tmp/trtmp

临时文件

/usr/share/lib/tmac/*

标准宏文件

/usr/lib/font/*

安装的 troff 备用字体的字体宽度表

/usr/share/lib/nterm/*

nroff 的终端驱动表

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
text/doctools

另请参见

checknr(1)col(1)eqn(1)man(1)nroff(1)tbl(1)attributes(5)man(5)me(5)ms(5)

附注

troff 不采用全部 8 位编码格式,因为它根据 7 位 ASCII 设计而成。

以前的文档将数字寄存器 yr 错误地描述为 Last two digits of current yearyr 实际上是指自 1900 年以来的年号。要正确获取当前年份直到 2099 年年号中的后两位数,可以在文档中注明下方所示的字符串寄存器 yy 的定义,以后用于显示两位数的年份。请注意,其他任何包含一个或两个字符的寄存器名称均可替代 yy

.\" definition of new string register yy--last two digits of year
.\" use yr (# of years since 1900) if it is < 100
.ie \n(yr<100 .ds yy \n(yr
.el \{             .\" else, subtract 100 from yr, store in ny
.nr ny \n(yr-100
.ie \n(ny>9 \{     .\" use ny if it is two digits
.ds yy \n(ny
.\" remove temporary number register ny
.rr ny \}
.el \{.ds yy 0
.\" if ny is one digit, append it to 0
.as yy \n(ny
.rr ny \} \}