Buat halaman manual yang membahas beberapa executable

9

Saya mengemas aplikasi dengan sekelompok executable yang menerima kira-kira argumen yang sama. Saya ingin menulis (dan memberikan) hanya satu halaman manual dengan penjelasan umum dan daftar argumen.

Singkatnya, saya suka itu

man execFoo
man execBar

arahkan ke halaman yang sama.

Saya tahu cara menghasilkan dua yang identik execFoo.1dan execBar.1tetapi mereka tampak suboptimal. Karena saya berencana untuk merilis paket ini untuk Debian, solusi yang mengandalkan rantai pengemasan Debian (seperti dh_installmake) juga akan baik-baik saja.

FabienAndre
sumber

Jawaban:

15

Mengapa tidak membuat satu manual saja dan membuat tautan lainnya? Begitulah cara kebanyakan, jika tidak semua, program seperti itu melakukannya. Sebagai contoh:

$ 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

Seperti yang Anda lihat di atas, egrepdan fgreptautan ke grephalaman manual utama itulah sebabnya mengapa man egrepmuncul man grep.

terdon
sumber
3
Itu sebenarnya metode yang direkomendasikan. Alternatifnya, yang disebut "usang" dalam beberapa manual, adalah dengan menggunakan .sopermintaan untuk memasukkan halaman referensi yang direferensikan
Simon Richter