Erstellen Sie eine Manpage mit mehreren ausführbaren Dateien


9

Ich packe eine Anwendung mit einer Reihe von ausführbaren Dateien, die ungefähr dieselben Argumente akzeptieren. Ich möchte nur eine Manpage mit allgemeinen Erklärungen und der Liste der Argumente schreiben (und bereitstellen).

Kurz gesagt, das würde mir gefallen

man execFoo
man execBar

Zeigen Sie auf dieselbe Seite.

Ich weiß , wie zwei identisch zu erzeugen , execFoo.1und execBar.1doch scheinen sie suboptimal. Da ich vorhabe, dieses Paket für Debian zu veröffentlichen, dh_installmakewären auch Lösungen in Ordnung , die auf der Debian-Verpackungskette (wie z. B. ) basieren.

Antworten:


15

Warum nicht einfach eine Manpage erstellen und die anderen Links erstellen? So machen es die meisten, wenn nicht alle solcher Programme. Zum Beispiel:

$ 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

Wie Sie oben sehen können egrepund fgrepLinks zur grepHauptmanpage sind, wird deshalb man egrepaufgerufen man grep.


3
Das ist in der Tat die empfohlene Methode. Die Alternative, die in einigen Handbüchern als "veraltet" bezeichnet wird, besteht darin, eine .soAnfrage zu verwenden, um die referenzierte Manpage aufzunehmen
Simon Richter
Durch die Nutzung unserer Website bestätigen Sie, dass Sie unsere Cookie-Richtlinie und Datenschutzrichtlinie gelesen und verstanden haben.
Licensed under cc by-sa 3.0 with attribution required.