Inicio / Soporte / Artículos / Leyendo el MAN fácilmente

Leyendo el MAN fácilmente

Hugo Sandoval
22/05/2007 04:49
Siendo principiante en Linux, podría resultarle un poco difícil entender la documentación man, sobre todo si está acostumbrado a los esquemas aplicados en otros sistemas operatívos.

No se preocupe, no es tan difícil interpretar la documentación "man" como aparenta. Sólo hay que entender un poco de la estructura de la misma. Recuerde que "man" viene de Manual no de la palabra anglosajona Hombre ;-).

La estructura general del man.

En términos sencillos, man se divide en varias secciones descritas a continuación:
Título o nombre del manual.
Sintaxis y descripción del programa o comando.
Las opciones y comandos válidas para el programa o comando.
Descripción y ejemplos de las distintas opciones y comandos (de ahora en adelante lo resaltaré para no confundir con el comando de consola).
Otros datos como: bugs, ver además (see also), autor, etc.
El título o nombre del manual se refiere a el nombre en sí del programa o comando por el cual usted está consultando el manual.
En la sección de sintaxis se presenta la forma como debe ser llamado el comando o programa con sus respectivas opciones.
Las opciones y comandos describen por separado las opciones con las cuales se llama al programa o comando al inicio. Estas opciones son las que definen el comportamiento inicial. Los comandos se refieren a las posibles combinaciones de teclas y órdenes durante la ejecución.
Esta es la diferencia fundamental -> opción al iniciar el programa o comando de consola y comandos mientras está corriendo.
Las secciones antes mencionadas, no se encuentran en todos los manuales, sobre todo la sección de comandos. Entonces es posible que logremos dar con los comandos, si leemos la sección FILES (ARCHIVOS, no mencionada en la lista inicial), que nos dá una lista de los archivos relacionados con el comando o programa.
Tomemos un ejemplo con vi:
Se invoca el man de vi desde una consola con man vi.
Inmediatamente después de presionar la tecla ENTER nos aparece el manual en modo texto (note que sale el manual del vi mejorado, es el mismo). Fíjese en las secciones descritas en la lista. Puede navegar por este manual con las teclas de flecha abajo, flecha arriba, Página Arriba, Página Abajo (Page Up y Page Down respectivamente) y con las teclas de Inicio y Fin (Home y End) y otras mas, que puede consultar presionando h (hache) y luego salir presionando q (cu).
En la sección FILES, encontrará una serie de archivos relacionados con documentación adicional del programa vi, las cuales puede consultar directamente.
Si está preguntándose, qué tiene todo eso de fácil, entonces lo invito a utilizar el Konqueror (si tiene el KDE instalado), para lo cual con sólo colocar en el campo de dirección #vi (numeral vi) se le presentará el mismo manual que verá en la consola, pero mas fácilmente manejable, imprimible y leíble; pruebe a presionar la combinación de teclas SHIFT flecha abajo y el Konqueror hará desplazamiento automático del contenido hacia abajo. Puede disminuir la velocidad de desplazamiento presionando SHIFT flecha arriba, hasta conseguir una velocidad de desplazamiento que haga la lectura agradable. Esto es válido para todo contenido mostrado a través del Konqueror no sólo el man; ¡haga la prueba con esta misma página!.
Seguro habrá visto en alguna parte consultando man, unos números atravesados. Estos números representan los contenidos del man referente a ese comando.
1 - Corresponde al manual en sí. Es equivalente a llamar el man directamente del comando o programa.
2 - Se refiere a las llamadas al sistema que pueda hacer dicho programa o comando.
3 - Aquí verá las llamadas a funciones varias y rutinas de librerías externas o internas.
4 - Dispositivos de bloques o archivos
5 - Sintaxis y formato de los archivos de configuración que afectan el funcionamiento del comando o programa.
6 - Sección de juegos.
7 - Macros
Por ejemplo: man xinetd nos muestra el manual de xinetd (lógico), pero si tecleamos: man 5 xinetd, entonces nos muestra el manual de xinetd.conf.
Éxitos en su aprendizaje de Linux ;-)

RTFM 

RTFM (Read The Fucking Manual - Lea el maldi... manual)... ¿No lo sabía? Pues sí, eso significan esas siglas que más de una vez le habrán dejado colarse en algún correo electrónico respondiendo alguna duda que haya tenido sobre algún tema, programa o comando.
Espero que con estas pocas líneas, logre entender mejor los manuales de linux y evite en lo posible estos insultos escondidos de los que se auto llaman: Genios y Dioses.

  • Actualmente 0 de 5 Estrellas.
  • 1
  • 2
  • 3
  • 4
  • 5
Valorado: 0/5 (0 valoraciones)

Gracias por tu valoración!

Ya has valorado esta página, sólo la puedes valorar una vez!

Tu valoración ha cambiado, gracias por contribuir!

Conecta o crea una cuenta de usuario para valorar esta página.

Comentarios

Conectar o crear una cuenta de usuario para comentar.