Muchos de los que llegan nuevos al mundo GNU/Linux se ven llenos de dudas e incapaces de encontrar respuesta rápida a sus inquietudes, en ocasiones ni siquiera disponen de una conexión a través de la cual poder acceder a algún foro de soporte y terminan finalmente con la idea de que Linux es muy difícil para ellos. La mayoría de los que se ven en esta situación ignoran de que nuestro propio sistema contiene buena parte de las respuestas a nuestras inquietudes iniciales. Existe esencialmente tres fuentes de documentación en un sistema linux: páginas de manual (man pages), páginas de información (info pages ) y manuales de aplicaciones empaquetadas en /usr/share/doc. En este artículo detallaremos cada una de estas fuentes.
Páginas de manual
Las páginas del manual o ”man pages” son las clásicas formas de documentación de referencia en Linux y Unix. Idealmente, puede buscar ayuda en las páginas del manual para cualquier comando, archivo de configuración o rutinas de librería. En la práctica, Linux es un software libre, y algunas páginas a no han sido escritas o muestran sus años. No obstante, las páginas del manual son el primer lugar a buscar cuando usted necesita ayuda. Para acceder a las páginas de manual, solo escriba man seguido del tema a indagar. Un paginado será iniciado , por lo que presionará q cuando termine de leer. Por ejemplo, para buscar información acerca del comando ls, escribiría:
$ man ls
Conociendo las partes de las páginas del manual puede ser útil saltar rápido a a la información que necesita, encontrará las siguientes secciones en la página del manual (Cuadro 1):
| NAME | Nombre y descripción del comando |
| SYNOPSIS | Como usar el comando |
| DESCRIPTION | Explicación en profundidad del funcionamiento del comando |
| EXAMPLES | Sugerencias de como usar el comando |
| SEE ALSO | Temas relacionados (Usualmente en las páginas del manual) |
Cuadro 1: Páginas del Manual
Secciones de las páginas del manual
Los archivos que comprenden las páginas del manual están almacenadas en /usr/share/man (o en /usr/man en algunos sitemas viejos ). Dentro de ese directorio, encontrará que las páginas del manual están organizadas dentro de las siguientes secciones (Cuadro 2).
| man1 | Programas de usuario |
| man2 | Llamadas a sistema |
| man3 | Funciones de librerías |
| man4 | Archivos especiales |
| man5 | Formato de archivos |
| man6 | Juegos |
| man7 | Miscelánea |
Cuadro 2: Secciones de las páginas del manual
Páginas del manual múltiples
Algunos temas existen en más de una sección. Para demostrar esto, vamos a usar el comando whatis, el cual muestra todas las páginas del manual disponibles para este tema:
$ whatis printf
printf (1) - format and print data
printf (3) - formatted output conversion
En este caso, man printf estaría en la página de la sección 1 (Programas de usuario). Si escribiéramos un programa en C, estaríamos más interesados en la página de la sección 3 (Library functions). Usted puede llamar una cierta sección de páginas del manual especificándola en la línea de comandos, por lo que para preguntar por printf, podremos escribir:
$ man 3 printf
Encontrando la página del manual correcta
Algunas veces es difícil encontrar algunas páginas de manual sobre un tema dado. En ese caso, podría usar man -k para buscar la sección NAME de las páginas del manual. Sepa que ́esta es una búsqueda de subcadena, por lo que algo como man -k ls le daría muchas salidas, aquí hay un ejemplo usando una palabra más específica:
$ man -k whatis whatis (1) - imprime descripciones de páginas de manual
Todo sobre apropos
El ejemplo anterior nos trajo unos puntos más. Primero, el comando apropos es exactamente equivalente a man -k, (De hecho, les daré un secreto. Cuando corren man -k en realidad corre apropos detrás de escena).
La línea de código MANPATH
Pasamos ahora al segundo tipo de documentación que encontraremos en nuestro sistema GNU/Linux. Por defecto, el programa man busca las páginas del manual en /usr/share/man, /usr/local/man, /usr/X11R6/man y posiblemente /opt/man. algunas veces puede encontrar lo que necesita agregando un camino adicional al camino de búsqueda. Siendo así, solamente edite /etc/man.conf en un editor de texto y agregue una línea como la siguiente:
MANPATH /opt/man
De aquí en adelante, cualquier página del manual en el directorio /opt/man será encontrado. Recuerde que necesita correr nuevamente makewhatis para agregar estas nuevas páginas del manual en la base de datos de whatis.
GNU info
Uno de los defectos de las páginas del manual, es que no soportan hipertexto por lo que no se puede saltar fácilmente de una página a otra. Los amigos del GNU reconocen este defecto, así que ellos inventaron otro formato de documentación: las páginas ”info”. Muchos de los programas GNU vienen con extensa documentación en el formato de páginas info. Puede comenzar a leer páginas info con el comando info:
De esta manera traeremos un índice de todas las páginas info disponibles en el sistema. Puede moverse en ellos con las teclas de flechas, seguir ”links” (indicados con una estrella) usando la tecla Enter y para salir presionando q. Las teclas están basadas en Emacs, por lo que debería serle fácil navegar si esta familiarizado con ese editor.
Para más información con el uso de info, lea su página info. Debe ser capaz de navegarlas usando las teclas mencionadas anteriormente:
$ info info
/usr/share/doc
Hay una última fuente que puede ayudarlo dentro del sistema Linux. Muchos programas vienen equipados con documentación adicional en otros formatos: texto, PDF, PostScript, HTML, por nombrar algunos. Eche un vistazo en /usr/share/doc (/usr/doc en sistemas viejos). Encontrará una larga lista de directorios, cada uno de los cuales viene con las aplicaciones en su sistema. Buscando a través de esta documentación puede a menudo revelar algo interesante, tales como tutoriales o documentación técnica adicional. Un chequeo rápido revela un montón de material disponible para leer:
$ cd /usr/share/doc
$ find . -type f | wc -l
En otros artículos nos referiremos a fuentes externas de documentación como El Proyecto de Documentación Linux (LDP), las listas de correos y los grupos de nocitcias.
Fuente: http://blog.desdelinux.net
¿Te resultó interesante? Compártelo ...
Generalmente, por pereza o descaro, nunca nos leemos las páginas man o documentación de los programas o paquetes que instalamos en nuestro sistema. De ahí se deriva la archiconocida respuesta en foros y listas de correo: RTFM!!. Lo genial de la documentación, es que define, específicamente para cada distro, las opciones de nuestro programa. +5 al artículo.
¿Pero los manuales estan en castellano….? porque generalmente estan en ingles, y si no sabes el idioma estamos en la misma que no tener el manual…..
existe elpaquete manpage-es con los manuales en español
ademas de manpages-extra
@oskar
Pienso que, además de no consultar las páginas man ni la documentación acompañante, tampoco estudian bien los artículos publicados en la red nacional. Si tienen acceso a Internet, prefieren buscar artículos de dudosa exactitud.
@Federico, ante todo saludos, en estos dias voy a sacar un primer numero de una revista de Software Libre, y leyendo sus articulos en humanOS (imagino usted es el mismo de humanOS) estoy interesado en su participacion, si esta interesado escribame a llamaret @@ gmail.com
@Ozkar, tengo que ir a Holguin a arrebatarte algun articulo de Python o alguna otra cosa de programacion???????
Hablando de eso… Como te lo hago llegar??
@Ozkar, tirame a gmail, saludos
Saludos Maikel!. Gracias por la invitación en principio aceptada de mi parte. Ya escribiré a tu correo para los detalles.
Pues, sí. Estos archivos son requete-importantes. En más de una ocasión me sacaron de apuros, sobre todo cuando no teníamos sitios como este ni su maravilloso Foro.
Un saludo afectuoso.