Estoy escribiendo una página de manual para un programa que estoy empaquetando. ¿Cómo puedo mostrar el archivo de la página de manual que creé para comprobar si está bien? ¿Hay alguna manera de pasar mi archivo directamente al mancomando en lugar de que busque en las páginas de manual instaladas por nombre?
Intenté hacer cosas como man myprog.1y man < myprog.1pero en ambos casos recibí un error que decía que no se pudo encontrar la página de manual.
Respuesta1
mantiene una opción para leer un archivo local:-l
-l, --local-file
Activa el modo 'local'. Formatee y muestre archivos de manuales locales en lugar de buscar en la colección de manuales del sistema. Cada argumento de la página del manual se interpretará como un archivo fuente nroff en el formato correcto. No se produce ningún archivo cat.
Si '-' aparece como uno de los argumentos, la entrada se tomará de la entrada estándar. Cuando no se utiliza esta opción y el hombre no encuentra la página requerida, antes de mostrar el mensaje de error, intenta actuar como si se hubiera proporcionado esta opción, usando el nombre como nombre de archivo y buscando una coincidencia exacta.
Para que pueda obtener una vista previa de su trabajo en progreso con:
man -l /path/to/manfile.1
Respuesta2
La forma de la 'vieja escuela', para sistemas anteriores a la -lopción, es
nroff -man filename | more -s
Respuesta3
he usado simplemente
man ./path/to/man.1
Debe incluir una barra diagonal en la ruta; de lo contrario, busca en los directorios del sistema. Funciona en los sistemas Linux y OS X que tengo (este último no tiene -l).
$ cd /tmp
$ cp /usr/share/man/man1/ls.1 .
$ man ls.1
No manual entry for ls.1
$ man ./ls.1 # works
Respuesta4
En Solaris, el -Mcambio mananulará la ruta de búsqueda de las páginas de manual:
man -M path/to/man myprog
Su archivo de página de manual debe residir en un subdirectorio apropiado correspondiente a la sección y al lenguaje de marcado, por ejemplo: path/to/man/man1/myprog.1para una página de manual nroff en la sección 1.