macref Command

Purpose

Produces a cross-reference listing of macro files.

Syntax

macref [ -n ] [ -s ] [ -t ] [ ] [ File ... ]

Description

The macref command reads the named English-language files (which are assumed to be nroff or troff command input) and produces a cross-referenced listing of the symbols in the input.

The default output is a list of the symbols found in the input, each accompanied by a list of all references to that symbol. The macref command lists the symbols alphabetically in the left column, with references following to the right. Each reference is given in the following form:

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

Generated names are listed under the artificial symbol name ~sym.

Input Parameters

Item Description
File Specifies the nroff or troff file from which the macref command produces output containing a list cross-referencing macros.

Output Parameters

Item Description
NMName The name of the macro within which MName is defined.
MName The name of the macro within which the reference occurs. This field is not present if the reference occurs outside a macro.
Type The type associated, by context, with this occurrence of the symbol. The types can be the following:
r
Request
m
Macro
d
Diversion
s
String
n
Number register
p
Parameter. For instance, \$x is a parameter reference to x.
Note: Parameters are never modified, and the only valid parameter symbol names are 1, 2, . . . 9.
LNumber The line number on which the reference occurred.
# This reference modifies the value of the symbol.

Flags

Item Description
-n Causes one line to be printed for each reference to a symbol.
-s Causes symbol-use statistics to be printed.
-t Causes a macro table of contents to be printed.

The flags can be grouped behind one - (minus sign). Use a — (dash) to delimit the end of flags.

Note: The macref command does not accept - as standard input.

Files

Item Description
/tmp/macref.tXXXXXX Contains a temporary file.
/tmp/macref.sXXXXXX Contains a temporary file.
/tmp/macref.cXXXXXX Contains a temporary file.