macref(1M)                                                       macref(1M)

NAME
     macref - Liste mit aufeinander verweisenden Makrodateien erstellen

SYNTAX
     macref [-t] [-s] [-n] [--] file ...

BESCHREIBUNG
     macref liest die angegebenen Dateien (es wird angenommen, daß es sich
     dabei um nroff(1M)- oder troff(1M)-Eingaben handelt) und erstellt eine
     Liste mit Querverweisen für die Symbole in der Eingabe.

     Durch die Angabe von -t in der Aufrufzeile wird das Ausdrucken des
     Makroinhaltsverzeichnisses initiiert. Mit der Option -s wird angege-
     ben, daß eine Statistik der verwendeten Symbole gedruckt wird. Wird -n
     angegeben, wird für jeden Verweis auf ein Symbol eine Zeile gedruckt.
     Die Optionen können nach dem Zeichen - gruppiert werden. Das Ende der
     Optionen kann durch "--" begrenzt werden. macref akzeptiert - nicht
     als Standardeingabe.

     Die Standardausgabe ist eine Liste der in der Eingabe gefundenen Sym-
     bole, wobei zu jedem Symbol eine Liste mit Verweisen auf dieses ange-
     geben ist. macref listet die Symbole alphabetisch in der linken Spalte
     auf, die Verweise sind rechts angeordnet. Die Verweise haben folgendes
     Format:

          [[(NMname)] Mname-] type lnum [#]

     Dabei haben die Felder folgende Bedeutungen:

     Mname    Name des Makros, in dem der Verweis auftritt. Dieses Feld
              fehlt, wenn der Verweis außerhalb eines Makros erfolgt. Bei
              den unter NMname aufgeführten Namen handelt es sich um
              Makros, in denen Mname definiert ist.

     type     Typ, der durch den Kontext dem Auftreten des Symbols zugeord-
              net ist. Folgende Typen sind möglich:

              r  request (nroff- bzw. troff-Request)
              m  macro (Makro)
              d  diversion (Umleitung)
              s  string (Zeichenkette)
              n  number register (numerisches Register)
              p  parameter (Parameter) (z. B., \$x ist ein Parameterverweis
                 auf x. Beachten Sie, daß Parameter nie geändert werden und
                 nur die Ziffern 1, 2, ... 9 als Namen für Parametersymbole
                 gültig sind.)

     lnum     Nummer der Zeile, in der der Verweis auftrat.

     #        Dieser Verweis ändert den Wert des Symbols.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

macref(1M)                                                       macref(1M)

     Die erstellten Namen werden unter dem künstlichen Symbolnamen "~sym"
     aufgelistet.

SIEHE AUCH
     nroff(1M), troff(1M), man(5), mm(5), mv(5).

















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98