checknr(1)

名称

checknr - 检查 nroff 和 troff 输入文件；报告可能的错误

用法概要

checknr [-fs] [-a . x1 . y1 . x2 . y2 ... .xn .yn] 
     [-c . x1 . x2 . x3 ... .xn] [filename]...

描述

checknr 可检查一系列 nroff(1) 或 troff(1) 输入文件，从中查找某些类型涉及打开和封闭分隔符不匹配以及未知命令的错误。如果未指定文件，则 checknr 将检查标准输入。分隔符的检查包括以下几个方面：

• 字体更改，使用 \fx . . . \fP。

• 大小更改，使用 \sx . . . \s0。

• 以 . . . 这种打开和封闭格式出现的宏，例如 .TS 和 .TE 宏，它们必须始终成对出现。

checknr 可识别 ms(5) 和 me(5) 宏软件包。

checknr 应该用于编制时考虑了 checknr 的文档。它要求采用符合 \f 和 \s 命令的某种文档编写样式，每个 \fx 必须以 \fP 结尾，每个 \sx 必须以 \s0 结尾。尽管可以直接继续下一个字体或显式指定原始字体大小或点尺寸，而且许多现有文档也确实这样做，但是这种做法会导致 checknr 报告错误。由于可能无论如何最好还是采用 \fP 和 \s0 格式，因此应该认为这样做对文档编制样式有好处。

选项

–f

忽略 \f 字体更改。

–s

忽略 \s 大小更改。

–a .x1 .y1. . .

向列表中添加成对的宏。成对的宏认为是应该检查其是否平衡的宏（例如 .DS 和 .DE）。–a 选项必须后跟每组六个字符的字符组，每个组定义一对宏。这六个字符分别是句点、第一个宏名称、再一个句点和第二个宏名称。例如，要定义一对 .BS 和 .ES，应使用 `–a.BS.ES'

–c .x1 . . .

定义 checknr 会报告为未定义的命令。

属性

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

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

另请参见

eqn(1)、nroff(1)、troff(1)、attributes(5)、me(5)、ms(5)

已知问题

无法使用 –a 选项定义包含一个字符的宏名称。