Créer une page de manuel adressant plusieurs exécutables

9

J'empaquette une application avec un tas d'exécutables acceptant à peu près les mêmes arguments. Je voudrais écrire (et fournir) une seule page de manuel avec des explications communes et la liste des arguments.

Bref, j'aimerais ça

man execFoo
man execBar

pointez sur la même page.

Je sais comment générer deux identiques execFoo.1et execBar.1mais ils semblent sous-optimaux. Comme je prévois de publier ce paquet pour Debian, les solutions reposant sur la chaîne de conditionnement Debian (comme dh_installmake) conviendraient également.

FabienAndre
la source

Réponses:

15

Pourquoi ne pas simplement créer une page de manuel et créer les autres liens? C'est ainsi que la plupart, sinon la totalité, de tels programmes le font. Par exemple:

$ 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

Comme vous pouvez le voir ci-dessus, egrepet fgrepsont des liens vers la greppage de manuel principale , c'est pourquoi man egrepapparaît man grep.

terdon
la source
3
C'est en fait la méthode recommandée. L'alternative, qui est mentionnée comme «obsolète» dans certains manuels, consiste à utiliser une .sodemande pour inclure la page de manuel référencée
Simon Richter