«Echa un vistazo al manual«, es una de esas frases que todo linuxero habrá escuchado o leído alguna vez. Incluso es posible que de malas maneras como respuesta a una pregunta, cuya solución se podría encontrar de manera sencilla consultando la documentación, en vez de jugar con la paciencia de barbudos y elitistas linuxeros.

Pero Linux no son solo RTFM’s (¡casualidad!, pero parece que un tal Ned Thanhouser tuvo algo que ver con el termino…) también es amor y hacer sencillas las cosas a los que empiezan, entre ellas consultar el jodido manual.

¿Desde la terminal? Es lo habitual… pero incluso a los que somos algo veteranos nos gusta variar de vez en cuando, así que vamos a ver como pasar la salida del manual al navegador o bien a un archivo PDF para facilitar su posterior consulta.

Consultar el manual desde el navegador

Pongamos que tenemos un programa (por ej «mplayer») y queremos consultar su manual. Lo tradicional es hacer algo así:

man mplayer

Si queremos pasar la salida a un navegador web, añadimos el parámetro -H

man -H mplayer

En el ejemplo anterior se nos abre Chromiun con el manual de SMPlayer, pero es posible que no lo tengamos instalado o prefiramos otro navegadores como Mozilla Firefox:

man --html=firefox mplayer

Chrome:

man --html=google-chrome-stable mplayer

o Midori:

man --html=midori mplayer

Pasar el manual a un archivo PDF

En esta ocasión nos vamos a valer de ps2pdf, una venerable herramienta GNU (forma parte de la suite GhostScript, la cual deberéis tener instalada) que nos facilita la conversión a formatos de tipo PDF.

man -t mplayer | ps2pdf - mplayer.pdf

Por supuesto existen muchas más opciones curiosas para sacarle jugo al manual de Linux. Una documentación que como ya hemos visto, se puede consultar de formas diferentes al tradicional:

man man