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 LliureX, el usuario dispone de:
Son documentos que describen con detalle el funcionamiento de aplicaciones y la estructura de archivos de configuración importantes del sistema.
Formato de documentación más completo que documenta algunos programas.
Documentación de cada aplicación y que lleva incorporada la propia aplicación. Normalmente se accede a ella a través del menú .
El sistema Linux incorpora páginas de manual para las ordenes, utilidades, aplicaciones, archivos,... 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 2.1. Secciones de la orden man
| Sección | Descripción |
|---|---|
| 1 | Programas ejecutables y ordenes de la shell |
| 2 | Llamadas al sistema |
| 3 | Llamadas a funciones de biblioteca |
| 4 | Archivos especiales |
| 5 | Formatos de archivos y convenciones |
| 6 | Juegos |
| 7 | Paquetes de macros y convenciones |
| 8 | ordenes a ejecutar por root |
| 9 | Funciones 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ía que escribir en la línea de orden: $ man date. Se visualiza una pantalla similar a la siguiente:
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.
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 utilizar las teclas Av. Pág y Re. Pá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, utilizar 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 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 ordenes relacionados con la búsqueda de información son los 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.
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 ejecutar 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 front-end gráficos para la orden info, por ejemplo tkinfo.
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.
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 poner a disposición de los demás usuarios.
Los documentos HOWTO en formato HTML están ubicados en /usr/share/doc/HOWTO/es/HOWTO, y por lo tanto disponibles desde cualquier navegador web como Mozilla Firefox o Epiphany (ver capítulos 12 y 13).