Cree una página de manual que aborde varios ejecutables

9

Estoy empaquetando una aplicación con un montón de ejecutables que aceptan aproximadamente los mismos argumentos. Me gustaría escribir (y proporcionar) solo una página de manual con explicaciones comunes y la lista de argumentos.

En resumen, me gustaría eso

man execFoo
man execBar

apunta a la misma página.

Sé cómo generar dos idénticos execFoo.1y execBar.1pero parece subóptima. Dado que planeo lanzar este paquete para Debian, las soluciones que dependen de la cadena de empaquetado de Debian (como dh_installmake) también estarían bien.

FabienAndre
fuente

Respuestas:

15

¿Por qué no simplemente crear una página de manual y hacer los otros enlaces? Así es como la mayoría, si no todos, tales programas lo hacen. Por ejemplo:

$ 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

Como puede ver arriba, egrepy fgrepson enlaces a la greppágina principal del hombre, es por eso que man egrepaparece man grep.

terdon
fuente
3
De hecho, ese es el método recomendado. La alternativa, que se menciona como "obsoleta" en algunos manuales, es utilizar una .sosolicitud para incluir la página de manual referenciada
Simon Richter