mandato macref

Finalidad

Genera un listado de referencias cruzadas de archivos de macro.

Sintaxis

macref [ -n ] [ - ] [ -t ] [ ] [ Archivo ... ]

Descripción

El mandato macref lee los archivos denominados en inglés (que se supone que son nroff o troff de entrada de mandatos) y genera un listado de referencias cruzadas de los símbolos de la entrada.

La salida predeterminada es una lista de los símbolos encontrados en la entrada, cada uno acompañado de una lista de todas las referencias a ese símbolo. El mandato macref lista los símbolos alfabéticamente en la columna izquierda, con referencias a continuación a la derecha. Cada referencia se presenta en la forma siguiente:

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

Los nombres generados se listan bajo el nombre de símbolo artificial~sym.

Parámetros de entrada

Elemento Descripción
Archivo Especifica el archivo nroff o troff a partir del cual el mandato macref genera una salida que contiene una lista de macros de referencia cruzada.

Parámetros de salida

Elemento Descripción
NombreNM El nombre de la macro en la que se define MName.
NombreM El nombre de la macro en la que se produce la referencia. Este campo no está presente si la referencia se produce fuera de una macro.
tipo El tipo asociado, por contexto, a esta aparición del símbolo. Los tipos pueden ser los siguientes:
:NONE.
Solicitud
m
Macro
d
Desviación
s
Serie
n
Registro de número
p
Parámetro. Por ejemplo,\$xes una referencia de parámetro a x.

Nota: Los parámetros no se modifican nunca y los únicos nombres de símbolo de parámetro válidos son 1, 2, .. 9.

NúmeroL El número de línea en el que se ha producido la referencia.
# Esta referencia modifica el valor del símbolo.

Distintivos

Elemento Descripción
-n Hace que se imprima una línea para cada referencia a un símbolo.
-s Hace que se impriman las estadísticas de uso de símbolos.
-T Hace que se imprima una tabla de contenido de macro.

Los distintivos se pueden agrupar detrás de uno-(signo menos). Utilice a-(guión) para delimitar el final de los distintivos.

Nota: el mandato macref no acepta-como entrada estándar.

Archivos

Elemento Descripción
/tmp/macref.t XXXXXX Contiene un archivo temporal.
/tmp/macref.s XXXXXX Contiene un archivo temporal.
/tmp/macref.c XXXXXX Contiene un archivo temporal.