Documentación y ayuda

GNU/Linux dispone de diferentes mecanismos para la obtención de la información necesaria para el usuario. Además del presente manual de usuario de Molinux, el usuario dispone de:

Páginas de manual (man)

Son documentos que describen con detalle el funcionamiento de aplicaciones y la estructura de archivos de configuración importantes del sistema.

Páginas Info (info)

Formato de documentación más completo que documenta algunos programas.

Archivos de ayuda de las aplicaciones

Documentación de cada aplicación y que lleva incorporada la propia aplicación. Normalmente se accede a ella a través del menú Ayuda.

Páginas Man

El sistema Linux incorpora páginas de manual para las órdenes, utilidades, aplicaciones, archivos, etc. Estas páginas están estructuradas en secciones, cada una de las cuales comprende la información relativa a un tipo de argumento.

Las diferentes secciones de man son las siguientes:

Tabla 4.1. Secciones de la orden man

SecciónDescripción
1Programas ejecutables y órdenes del intérprete de órdenes
2Llamadas al sistema
3Llamadas a funciones de biblioteca
4Archivos especiales
5Formatos de archivos y convenciones
6Juegos
7Paquetes de macros y convenciones
8Órdenes a ejecutar por root
9Funciones del núcleo

El acceso a las páginas man se puede hacer desde una terminal, ejecutando la orden man. Por ejemplo, se quiere disponer de la documentación relativa a la orden date, habrá que escribir en la línea de orden: $ man date. Se visualiza una pantalla similar a la siguiente:

[Importante]Importante

Cuando se escribe una orden hay que tener en cuenta que los símbolos $ o # hacen referencia al prompt del sistema y, por lo tanto, no hay que teclearlos. El símbolo $ se corresponde con el indicador del sistema para el usuario y el símbolo # se corresponde con el indicador del sistema para el administrador del sistema.

Figura 4.5. Página de manual de la orden date

Página de manual de la orden date

Normalmente se utilizarán las secciones 1, 5, 7 y 8. Si se quiere hacer referencia a la sección, la forma de hacerlo es: $ man nº seccion programa. Ejemplo: $ man 1 date.

Para navegar dentro de la página del manual hay que utilizar las teclas AvPág y RePág. También se puede utilizar la Barra espaciadora para mover una página abajo y B para mover una página arriba. Para salir de la página de manual pulsar Q.

Si lo que se quiere es buscar una determinada palabra dentro del texto mostrado por man, se utiliza la tecla / seguida de la palabra a buscar. Las coincidencias quedarán remarcadas y con la tecla n se pueden ir recorriendo de forma secuencial.

Si lo que se quiere es conocer más a fondo el funcionamiento de la orden man se puede escribir en la terminal: $ man man.

Opciones interesantes de man:

$ man -a programa

$ man -k programa

  • -a indica que se muestren todas las secciones del manual que tengan referencias al programa. Por ejemplo, man -a man devuelve todas las entradas de man, no sólo la de la sección 1.

  • -k se utiliza para encontrar qué programa hace algo. Por ejemplo, man -k date devuelve todos los programas relacionados con la palabra date en su descripción, con las correspondientes secciones, y una explicación de para qué sirve cada uno.

Otras órdenes relacionados con la búsqueda de información son las siguientes:

  • whatis nombre_orden: muestra una breve descripción de la orden.

  • apropos palabra_clave: localiza páginas de man relacionadas con la palabra clave. Es equivalente a man -k.

  • locate patrón: localiza nombres de archivos o directorios en nuestro sistema que coincidan con el patrón dado.

Páginas Info

Info es el formato de documentación del proyecto GNU. Es más flexible que las páginas man. Normalmente la documentación en formato info está mejor escrita y más estructurada. Consta de un conjunto de manuales que documentan algunos programas. Para consultarlos en pantalla, ejecutad la orden info seguido del nombre del manual que se quiera consultar.

Si sólo se teclea info, se entra en el índice de los manuales disponibles.

También existen programas con interfaz gráfica (también conocidos como front-end) para la orden info. Un ejemplo es tkinfo, que no viene instalado por defecto en Molinux.

En el directorio /usr/share/doc existe también gran cantidad de información sobre la mayoría de los programas instalados. Esta documentación puede venir dada por un sencillo archivo README y una nota de copyright o más amplia en formato HTML o PostScript (entre otros).

Si sólo es un archivo README, normalmente se podrá encontrar una URL del programa en la que exista más información sobre este programa.

El acceso a la documentación HTML disponible está centralizado mediante la orden dhelp, que permite acceder a ella de forma sencilla.

Documentos HOWTO

Los documentos HOWTO son como tutoriales que contienen información relativa a la descripción, configuración y puesta a punto de servicios del sistema, periféricos, programas, etc. Son creados por usuarios experimentados que han realizado las pruebas necesarias hasta conseguir su funcionamiento y que han decidido ponerlos a disposición de los demás usuarios.

Hay que tener en cuenta que los HOWTO (COMOs en español) no siempre están al día y pueden no corresponderse exactamente con los componentes software de la versión de Molinux que se tenga instalada. Es la razón por la que no los hemos integrado en Molinux (en su lugar Molinux dispone de una ayuda en línea, el Yelp, que incluye recetas perfectamente adaptadas a la utilización de Molinux -ver la sección Yelp a continuación-).

No obstante existen dos repositorios esenciales para la los HOWTO :

Ayuda integrada. Yelp

GNOME integra un sistema de ayudas, Yelp (cuyo icono se encuentra en el panel del escritorio).

Figura 4.6. Menú principal de yelp

Menú principal de yelp

Yelp es un potente navegador de páginas de ayuda que permite buscar entre sus contenidos de forma gráfica gracias a su indexado. Aparte de ello permite navegar entre las diferentes referencias que se realizan dentro de cada documento y volver atrás en el momento en el que se desee.

Figura 4.7. Ayuda de Molinux

Ayuda de Molinux