Utwórz stronę podręczną adresującą kilka plików wykonywalnych

9

Pakuję aplikację z pakietem plików wykonywalnych, przyjmując w przybliżeniu te same argumenty. Chciałbym napisać (i podać) tylko jedną stronę podręczną z typowymi wyjaśnieniami i listą argumentów.

Krótko mówiąc, chciałbym tego

man execFoo
man execBar

wskaż tę samą stronę.

Wiem, jak generować dwa identyczne execFoo.1a execBar.1jednak wydają suboptimal. Ponieważ planuję wydać ten pakiet dla Debiana, rozwiązania oparte na łańcuchu pakietów Debiana (np. dh_installmake) Byłyby również w porządku.

FabienAndre
źródło

Odpowiedzi:

15

Dlaczego nie po prostu stworzyć jednej strony i połączyć pozostałe? Tak właśnie robi większość, jeśli nie wszystkie, takie programy. Na przykład:

$ 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

Jak widać powyżej, egrepi fgrepsą to linki do głównej grepstrony podręcznika użytkownika, dlatego man egreppojawia się man grep.

terdon
źródło
3
Jest to w rzeczywistości zalecana metoda. Alternatywą, która w niektórych instrukcjach jest wymieniana jako „przestarzała”, jest skorzystanie z .soprośby o dołączenie odnośnej strony podręcznika
Simon Richter