Creare una manpage indirizzata a diversi eseguibili


9

Sto impacchettando un'applicazione con un gruppo di eseguibili che accettano più o meno gli stessi argomenti. Vorrei scrivere (e fornire) solo una manpage con spiegazioni comuni e l'elenco degli argomenti.

In breve, mi piacerebbe

man execFoo
man execBar

punta alla stessa pagina.

So come generare due identici execFoo.1e execBar.1ma sembrano non ottimali. Dal momento che ho intenzione di rilasciare questo pacchetto per Debian, anche le soluzioni basate sulla catena di packaging Debian (come dh_installmake) andrebbero bene.

Risposte:


15

Perché non creare semplicemente una manpage e creare gli altri collegamenti? Ecco come la maggior parte, se non tutti, di questi programmi lo fanno. Per esempio:

$ ls -l /usr/share/man/man1/[ef]*grep.1.gz 
lrwxrwxrwx 1 root root 9 Nov 27  2013 /usr/share/man/man1/egrep.1.gz -> grep.1.gz
lrwxrwxrwx 1 root root 9 Nov 27  2013 /usr/share/man/man1/fgrep.1.gz -> grep.1.gz

Come puoi vedere sopra, egrepe fgrepsono collegamenti alla greppagina man principale che è il motivo per cui viene man egrepvisualizzato man grep.


3
Questo è in effetti il ​​metodo raccomandato. L'alternativa, che è menzionata come "deprecata" in alcuni manuali, è quella di utilizzare una .sorichiesta per includere la manpage di riferimento
Simon Richter,
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.