macref 命令

用途

生成一个宏文件的交叉引用列表。

语法

麦克雷夫 [ -n ] [ -s ] [ -t ] [ ] [ 文件 ... ]

描述

macref 命令读取指定的英语文件(假定它们是由 nrofftroff 命令输入的)并生成一个输入中的符号的交叉引用的列表。

缺省输出是在输入中的符号列表,每个符号跟有其所有引用的列表。 macref 命令在左栏按字母顺序列示符号,在右栏跟有其引用。 每个引用以如下格式给出:

[ [(  NMName ) ]
MName- ]
Type LNumber
[  # ]

生成的名称列示在人工符号名称下~sym.

输入参数

描述
文件 指定 macref 命令从其中生成包含交叉引用宏列表的输出的 nrofftroff 文件。

输出参数

描述
NM名称 定义有 MName 的宏名称。
网名 出现引用的宏的名称。 如果引用出现在宏之外,本字段不存在。
TYPE 根据上下文与出现的符号关联的类型。 允许的类型如下:
R
请求
m
转移
String
n
数字寄存器
p
参数。 例如:\$x是参数引用 x.

注: 从不修改参数,唯一有效的参数符号名称为 1 , 2 ,.。 9。

L 编号 引用出现的行号。
# 引用修改符号的值。

标志

描述
-n 对于符号的每个引用打印一行。
-s 打印符号使用的统计信息。
-t 打印宏表的内容。

标志可以成组地跟在 -(减号)后。 使用 —(破折号)来定界标志的结尾。

注: macref 命令不接受-作为标准输入。

文件

描述
/tmp/macref.t XXXXXX 包含临时文件。
/tmp/macref.s XXXXXX 包含临时文件。
/tmp/macref.c XXXXXX 包含临时文件。