格式化易于阅读的程序清单。
vgrind [ -f ] [ -n ] [ -t ] [ -x ] [ -PPrintdev ] [ -TName ] [ - ] [ -dFile ] [ -h Header ] [ -lLanguage ] [ -sSize ] [ File ... ]
vgrind 命令 使用 troff 命令以易于阅读的风格格式化(编排)由 File 参数指定的程序源文件。注释以斜体字显示、关键字以粗体字显示,当前函数的名称在对应的每页的页边空白中列出。
vgrind 命令以过滤器方式或正常方式运行。
在过滤器方式中,vgrind 命令以一种类似于 tbl 命令的方式充当过滤器。标准输入直接被传递到标准输出,除了用以下 troff 样式的宏括起来的行:
.vS | 开始处理。 |
.vE | 结束处理。 |
前面的行按照 vgrind 命令约定被格式化。来自过滤器的输出可以被传递到 troff 命令用作输出。eqn 或 tbl 命令没有特定的顺序。
在正常方式中,vgrind 命令接受输入文件、处理它们并依次 传递到 troff 命令、适当的后处理器,然后传给打印机。
在两种方式中,vgrind 命令传递时不转换以小数点开始的行。
vgrind 命令仅支持 标准 /usr/share/lib/vgrindefs 语言定义文件定义的 ASCII 关键字,或任何由 -d 标志另外指定的文件定义的 ASCII 关键字。
-f | 强制使用过滤器方式。 |
-n | 强制不使用粗体关键字。 |
-t | 使格式化文本写入标准输出。 |
-x | 以一种易于阅读的格式输出索引文件。无论什么时候 用 index 文件在当前目录运行 vgrind命令, 索引文件就会自动产生。通过运行使用 -x 标志 和 File 参数的 vgrind 命令, 可以关闭功能定义索引。 |
-PPrintDev | 将输出发送到使用 qprt 命令的 Printdev 打印机。如果没有指定此标志,则使用 PRINTER 环境变量。如果没有设置 PRINTER 环境变量, 则使用系统缺省值。 |
-TName | 为由 Name 参数指定的 troff 设备创建 输出。输出通过适当的后处理器送出。缺省为 ibm3816 后处理器。 |
- | 强制从标准输入获取输入(如果指定 -f 标志,则为缺省值)。 |
-dFile | 指定备用语言定义文件(缺省为 /usr/share/lib/vgrindefs 文件)。 |
-h Header | 指定特定的页眉以便打印在每个输出页上(缺省为文件名)。
注:在 -h 标志之后,Header 变量之前,要求有一个空格。 |
-lLanguage | 指定要使用的语言。当前已知的语言有:
|
index | 包含在其中创建索引源的文件。 |
/usr/bin/vgrind | 包含 vgrind 命令。 |
/usr/share/lib/tmac/tmac.vgrind | 包含宏数据包。 |
/usr/share/lib/vfontedpr | 包含预处理器。 |
/usr/share/lib/vgrindefs | 包含语言描述。 |
vgrindefs 文件格式。