macref コマンド
目的
マクロ・ファイルの相互参照リストを作成します。
構文
説明
macref コマンドは、指定された英語のファイルを読み取り (nroff または troff コマンドの入力と想定されています)、入力内の記号の相互参照リストを作成します。
デフォルトの出力は入力内の記号のリストで、各記号にはその記号に対するすべての参照のリストが付いています。 macref コマンドは、記号をアルファベット順に左の列にリストし、その参照を右の列にリストします。 各参照は、次の形で出力されます。
生成された名前は、人工シンボル名の下にリストされます。~sym.
入力パラメーター
| 項目 | 説明 |
|---|---|
| File | macref コマンドが相互参照マクロのリストを含む出力を作成する nroff または troff ファイルを指定します。 |
出力パラメーター
| 項目 | 説明 |
|---|---|
| NM名 | MName が定義されたマクロ名。 |
| mname | 参照が発生するマクロ名。 参照がマクロの外で発生する場合、このフィールドは存在しません。 |
| Type | コンテキストによって、このシンボルのオカレンスと対応するタイプ。 以下のタイプがあります。
注: パラメーターは変更されません。また、有効なパラメーターのシンボル名は、1、2 . . . 9 のみです。 |
| LNumber (L数値) | 参照が発生した行番号。 |
| # | この記号がシンボルの値を変更しています。 |
フラグ
| 項目 | 説明 |
|---|---|
| -n | 記号への参照ごとに 1 行ずつ出力させます。 |
| -s | 記号の使用状況の統計情報値を出力させます。 |
| -t | マクロの目次を出力させます。 |
複数のフラグを 1 つの - (負符号) の後にまとめて指定できます。 フラグの終わりを区切るには、— (ダッシュ) を使用します。
注: macref コマンドは-を標準入力として受け入れません。
ファイル
| 項目 | 説明 |
|---|---|
| /tmp/macref.t XXXXXX | 一時ファイルが入っています。 |
| /tmp/macref.s XXXXXX | 一時ファイルが入っています。 |
| /tmp/macref.c XXXXXX | 一時ファイルが入っています。 |