comando do macref

Editar online

Propósito

Produz uma listagem de referência cruzada de arquivos macro.

Sintaxe

macref [ -n ] [ -s ] [ -t ] [ — ] [ Arquivo ... ]

Descrição

O comando macref lê os arquivos denominados de língua inglesa (que são assumidos como nroff ou troff input input) e produz uma listagem cruzada dos símbolos na entrada.

A saída padrão é uma lista dos símbolos encontrados na entrada, cada um acompanhado por uma lista de todas as referências a esse símbolo. O comando macref lista os símbolos alfabeticamente na coluna da esquerda, com referências seguindo para a direita. Cada referência é dada na seguinte forma:

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

Os nomes gerados são listados sob o nome de símbolo artificial~sym.

Parâmetros de entrada

Item Descrição
Arquivo Especifica o arquivo nroff ou troff a partir do qual o comando macref produz saída contendo uma lista de macros de referenciamento transversal.

Parâmetros de saída

Item Descrição
NMName O nome da macro dentro do qual MName está definido.
MName O nome da macro dentro da qual ocorre a referência. Este campo não está presente se a referência ocorrer fora de uma macro.
Tipo O tipo associado, por contexto, com esta ocorrência do símbolo. Os tipos podem ser os seguintes:
t
Solicitação
M
Macro
D
Diversão
s
Sequência
n
Registo de número
P
parâmetro. Por exemplo,\$xé uma referência de parâmetro para x.

Nota: Parâmetros nunca são modificados e os únicos nomes de símbolo de parâmetro válidos são 1, 2,... 9.
LNúmero O número da linha em que ocorreu a referência.
# Esta referência modifica o valor do símbolo.

Sinalizações

Item Descrição
-n Faz com que uma linha seja impressa para cada referência a um símbolo.
-S Faz com que as estatísticas de uso do símbolo sejam impressas.
-t Faz com que uma tabela macro de conteúdos seja impressa.

As bandeiras podem ser agrupadas atrás de um-(sinal de menos). Use um-(traço) para delimitar o fim das bandeiras.

Nota: O comando macref não aceita-como entrada padrão.

Arquivos

Item Descrição
/tmp/macref.t XXXXXX Contém um arquivo temporário.
/tmp/macref.s XXXXXX Contém um arquivo temporário.
/tmp/macref.c XXXXXX Contém um arquivo temporário.