Estoy empaquetando un programa para ubuntu, y recibo una advertencia lintian que dice que mi binario necesita una página de manual.
¿Cómo se puede crear una página de manual para un programa?
Con la ayuda de Gmanedit , puede crear páginas de manual con una GUI gráfica.
Gtk + Manpages Editor es un editor para páginas man que se ejecuta en X con GTK +.
Gmanedit es una aplicación que le permite editar páginas de manual (man) en sistemas Linux / Unix.
Es como los editores HTML más comunes pero más fácil. Necesita saber el formato de las páginas de manual.
Según el programa de usuario de Debian FHS, las páginas de manual se almacenan en usr/share/man/man1
o usr/local/share/man/man1
.
Después de cambiar las páginas de manual, puede ser conveniente actualizar la base de datos de la página de manual ejecutándose mandb
en un terminal.
Los detalles sobre la sintaxis de la página de manual se resumen en la página de manual de man .
Puede escribir páginas de manual en docbook / refentry, un formato de documentación XML,
y luego convertir los resultados al formato man usando
html con
y así. Esta no es la forma más fácil de escribir una página de manual, pero si ya has escrito XML antes de eso, ya conoces la sintaxis, solo es cuestión de aprender a usar las etiquetas.
fuente
Dale un giro a esto. Lo acabo de subir. Escribo varias aplicaciones y he tenido problemas con un editor de páginas de manual decente.
http://gtk-apps.org/content/show.php/Man+Page+Editor+?content=160219
Esta es una aplicación gtk2 con una pestaña separada para cada sección, la importación de páginas de manual, la vista previa y la exportación son compatibles, no hay comandos de formato esotérico, esto todavía está en desarrollo, pero ciertamente es lo suficientemente estable como para usar.
fuente
Puedes hacerlo con autotools. GNU ha publicado un ejemplo en el que un proyecto en C instala una página de manual con autotools.
fuente