Páginas de manual en el directorio de trabajo

Cuando por ejemplo ejecutamos man ls, podemos ver la página del manual del comando ls que hay instalada en nuestro sistema.

Puede ser que queramos leer una página de manual que no está instalada, por ejemplo de un software nuevo que estamos valorando antes de hacer la instalación o que hemos instalado en un sitio poco habitual (y por lo tanto la página de manual no cae en un sitio accesible para man).

En Linux es muy sencillo:

$ man -l ./bogom.8

Con el ./ le indicamos que el fichero está en el directorio actual, y man muestra el documento sin problemas gracias a que hay una opción -l que nos permite trabajar con ficheros locales.

Teniendo en cuenta lo pobre que es el estándar POSIX, esto puede o no estar en otros UNIX-like.

En OpenBSD, por ejemplo, no existe la opción -l. En su lugar hay que emplear un comando más elaborado:

$ nroff -man bogom.8 | less

Que en realidad es lo que hace man (la llamada a nroff) empleando less como paginador (OpenBSD usa more).

También puede ser útil tener una copia de la página de manual en papel. Pues nada, para eso está groff que nos da la salida en PostScript listo para imprimir:

$ groff -man ./bogom.8 > bogom.ps