Como classificar automaticamente os flags de opção em um manual?

2

Estou prestes a criar um script para editar o manual para ter uma ordem alfabética do sinalizador de opção na seção OPTIONS . Existe uma maneira mais direta e elegante de fazer isso?

    
por user123456 12.10.2016 / 11:29

1 resposta

1

Sem ver a página de manual, é difícil dizer. Mas supondo que o seu manual esteja formatado de forma consistente, por exemplo,

.TP 5
.B \-a
description of \fB\-a\fP option
.TP 5
.B \-b
description of \fB\-b\fP option

e assim por diante, você poderia escrever um script Perl para escolher as opções com os parágrafos a seguir e escrever uma página de manual com as opções classificadas. (bash e awk aparecem com pouca potência para essa tarefa, pelo menos não são úteis para xterm , por exemplo).

Se a marcação de página manual for inconsistente, por exemplo, o uso de marcação para opções que podem ser facilmente confundidas com outro assunto descritivo, complicaria o script. Mas, realisticamente, uma vez que é classificado, você não revisitaria essa tarefa com frequência e (se você tiver páginas de manual suficientes para justificar o tempo gasto em um script), o script seria reutilizável.

Como alternativa, você pode armazenar todas as opções em arquivos e classificar essa lista (por nome de opção). Isso é certamente menos elegante e não ajuda muito na reutilização.

Alguém já pode ter um script reutilizável; Obter entrada consistente ajuda muito embora.

    
por 13.10.2016 / 01:09

Tags