01.01.2013 Views

AT&T UNIX™PC Unix System V Users Manual - tenox

AT&T UNIX™PC Unix System V Users Manual - tenox

AT&T UNIX™PC Unix System V Users Manual - tenox

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

MACREF(l) MACREF( l)<br />

NAME<br />

macref - produces cross-reference listing of macro files<br />

SYNOPSIS<br />

macref [-t] [-s] [-n] [ --] files<br />

DESCRIPTION<br />

macref reads the named files (which are assumed to be nroff( l) or troff<br />

input) and produces a cross-reference listing of the symbols in the input<br />

A-t on the command line causes a macro table of contents to be printed.<br />

The option -s causes symbol-use statistics to be printed. The option -n<br />

causes one line to be printed for each reference to a symbol. The options<br />

may be grouped behind one -. You may use "- -" to delimit the end of<br />

options. macref does not accept - as standard input<br />

The default output is a list of the symbols found in the input, each<br />

accompanied by a list of all references to that symbol. macref lists the<br />

symbols alphabetically in the leftmost column, with the references following<br />

to the right Each reference is given in the form:<br />

[ [(NMname)] Mname-] type Inurn [#]<br />

where the fields have the following meanings:<br />

Mname the name of the macro within which the reference occurs.<br />

This field is missing if the reference occurs outside a macro.<br />

Any names listed in the NMname part are macros within<br />

which Mname is defined.<br />

type the type associated, by context, with this occurrence of the<br />

symbol. The types may be:<br />

r request<br />

m macro<br />

d diversion<br />

s string<br />

n number register<br />

p parameter (e.g., \$x is a parameter reference to x.<br />

Note that parameters are never modified, and that the<br />

only valid parameter symbol names are 1, 2, ... 9).<br />

Inurn the line number on which the reference occurred.<br />

# this reference modifies the value of the symbol.<br />

Generated names are listed under the artificial symbol name '' �sym''.<br />

SEE ALSO<br />

man(l), mm(l), mm(S), man(5), and nroff(l),<br />

- 1 -

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!