Создайте man-страницу, адресованную нескольким исполняемым файлам

9

Я упаковываю приложение с кучей исполняемых файлов, принимающих примерно одинаковые аргументы. Я хотел бы написать (и предоставить) только одну справочную страницу с общими пояснениями и списком аргументов.

Короче хотелось бы

man execFoo
man execBar

указать на ту же страницу.

Я знаю , как генерировать два идентичных execFoo.1и , execBar.1но они кажутся оптимальными. Поскольку я планирую выпустить этот пакет для Debian, решения, основанные на цепочке пакетов Debian (например, dh_installmake), также подойдут.

FabienAndre
источник

Ответы:

15

Почему бы просто не создать одну справочную страницу и сделать другие ссылки? Вот как большинство, если не все, такие программы делают это. Например:

$ 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

Как вы можете видеть выше, egrepи fgrepесть ссылки на главную grepстраницу руководства, поэтому и man egrepвызывает man grep.

Тердон
источник
3
Это на самом деле рекомендуемый метод. Альтернатива, которая упоминается как «устаревшая» в некоторых руководствах, состоит в том, чтобы использовать .soзапрос для включения ссылочной man-страницы
Саймон Рихтер