Manuales y páginas de ayuda en Linux

Sin duda ya sabrás que hay unas cuantas herramientas en GNU/Linux, que nos pueden servir para obtener información, en formato de manuales o páginas de ayuda. La más popular es man, pero existen otras como ahora veremos.

Quizás te puede interesar el programa de podcast que he grabado sobre este asunto:

Manuales y páginas de ayuda en Linux

Los sistemas like-UNIX, como es el caso de GNU/Linux, son famosos por la gran cantidad de comandos disponibles, cada uno de ellos  a su vez tienen una gran cantidad de posibilidades, a través del uso de parámetros y opciones. Por suerte la consola de comandos nos lo pone un poco más fácil, ya que tras escribir los primeros dígitos de un comando, apretando la teclado del tabulador, nos completará el nombre de este, además se puede utilizar el mismo método para completar rutas de directorios.

Prácticamente, todos los comandos y archivos de configuración en GNU/Linux ,van acompañados de una página en el manual. Dicho manual esta accesible a través del comando man, que muestra con detalle todas las funciones de un ítem. Para utilizar el manual, en su modo básico, solo hemos de escribir el comando man, más el nombre del comando del que queremos obtener información.

Aunque man es el más popular, también podemos utilizar el comando info. Utilizando este comando podemos obtener información igualmente de los comandos, pero en formato más breve. Por normal general su información se obtiene desde /usr/share/info

Las páginas del manual se suelen dividir en su organización en nombre, sinopsis, descrición, opciones, archivos y otra información adicional. También podemos realizar búsquedas por nombre, utilizando el comando apropos. Este comando devuelve una breve descripción a cada resultado encontrado y el nombre del respectivo comando o fichero.

En cambio, con el comando whatis, se nos muestra información que hace referencia a la sección del manual, donde se encuentra el comando indicado. Para cada recurso del manual localizado, este muestra una breve descripción.

Las secciones del manual

El manual esta dividido en secciones, que son las siguientes:

  • Sección 1: Programas disponibles para el usuario.
  • Sección 2: Rutinas del sistema Unix y C
  • Sección 3: Rutinas de bibliotecas del lenguaje C
  • Sección 4: Archivos especiales (dispositivos /dev)
  • Sección 5: Convenciones y formatos de archivos.
  • Sección 6: Juegos
  • Sección 7: Diversos (macros textuales,  entre otras)
  • Sección 8: Procedimientos administrativos (daemons, etc)

Para acceder a una sección específica, el número de la sección precede al nombre del objeto. Por ejemplo para acceder al manual de tar en la sección 5, ya que tar esta presente en dos secciones, en la 1 y en la 5:

[davidochobitst@turbolinux ~]# whatis tar
tar (1)              - manual page for tar 1.26
tar (5)              - format of tape archive files

Y buscamos en la sección del manual que nos interesa:

man 5 tar

Por defecto, los archivos de los manuales se almacenan en /usr/man y en /usr/share/man. Aunque esto puede varias y se puede cambiar, modificando las variables de entorno.

Otros documentos de ayuda

El conjunto de proyectos de GNU suelen incluir todo tipo de documentación, como FAQ (preguntas y respuestas), Readme, ChangeLog y manuales de usuario y administrador. Pueden estar en diversos formatos, como por ejemplo, ASCII, HTML, LateX o postscript. Generalmente se encuentra en /usr/share/doc

Imprimir los manuales

Es bastante fácil imprimir las páginas del manual, simplemente se ha de redirigir la salida del comando man a un archivo o comando de impresión.

Para no perder el formato, podemos utilizando la herramienta groff, de la siguiente manera:

zcat /usr/share/man/man1/cat.1.gz | groff -man -Tps > cat.ps

O si directamente queremos imprimir:

zcat /usr/share/man/man1/cat.1.gz | groff -man -Tps |lpr

Recordad que hace un tiempo os explique como utilizar el servidor de impresión cups.

También se pueden consultar las páginas de man vía web,  que es lo que yo he hecho para realizar esta entrada:

Man page of man

Man page of info

Deja un comentario

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.

Uso de cookies

Este sitio web utiliza cookies para que usted tenga la mejor experiencia de usuario. Si continúa navegando está dando su consentimiento para la aceptación de las mencionadas cookies y la aceptación de nuestra política de cookies, pinche el enlace para mayor información.plugin cookies

ACEPTAR
Aviso de cookies