Capítulo 15. Dónde obtener documentación

Tabla de contenidos
15.1. La documentación incluida con Linux-Mandrake
15.1.1. Las páginas man
15.1.2. Las páginas info
15.1.3. Los COMO
15.1.4. El directorio /usr/doc
15.2. La red Internet
15.2.1. Los sitios web dedicados a GNU/Linux
15.2.2. Los foros de discusión

Además de los manuales incluidos con Linux-Mandrake, están disponibles muchas otras fuentes de información. En las páginas siguientes ofreceremos algunas sugerencias que puede encontrar útiles.

15.1. La documentación incluida con Linux-Mandrake

15.1.1. Las páginas man

Esta es la fuente de información primaria para la consulta diaria. Prácticamente todos los comandos tienen su página man, aunque también hay páginas man sobre el formato de ciertos archivos de configuración, sobre las bibliotecas de funciones para los programadores, y otras.

Las páginas man están organizadas en secciones diferentes, y generalmente verá referencias a cosas como "man 2 open", "man 5 fstab" u otras, que significan la página man de open en la sección 2 y la página man de fstab en la sección 5 respectivamente.

El comando para mostrar que una página man es man, y su sintaxis es la siguiente:

man [opciones] [sección] <página de manual>

Incluso hay una página man para man mismo: man man. Las páginas man se formatean y se muestran usando un pager (paginador), que predeterminadamente es less. Entonces ya sabe como recorrer una página man y como salir de la misma :-)

Al comienzo de cada página man verá el nombre de la misma y la sección de man a la cual pertenece; al final de la página man (generalmente en la sección VÉASE TAMBIÉN, o SEE ALSO para las páginas man en inglés) verá referencias a otras páginas man relacionadas con la que está consultando en ese momento.

Puede empezar consultando las páginas man para los distintos comandos que han sido abordados en este manual: man ls, man chmod, etc.

Si no encuentra la página man adecuada (por ejemplo, quiere usar la función mknod en uno de sus programas pero termina en la página man del comando mknod), necesita mencionar la sección explícitamente: en este caso es man 2 mknod, o si ya no puede recordar la sección exacta, man -a mknod buscará las páginas man denominadas mknod en todas las secciones.

15.1.2. Las páginas info

Las páginas info son otra fuente de documentación más completa que las páginas man. El comando para acceder a las páginas info es info.

Las páginas info están organizadas en forma de árbol con el tope denominado dir. Desde el tope, se puede acceder a todas las páginas info existentes.

Puede invocar a info de dos maneras: sin argumento alguno, en cuyo caso se ubicará a la raíz de la estructura de árbol, o seguido del nombre de un comando o de un paquete, en cuyo caso se abrirá, si existe, la página correspondiente. Por ejemplo:

info emacs

En las páginas info, los textos como este:

* Buffers::

indican un vínculo. Si mueve el cursor sobre este vínculo (usando las teclas de las flechas) y presiona Intro, será llevado a la página info correspondiente.

Existen los atajos de teclado siguientes:

  • u: por Up (Arriba), va al nivel superior;

  • n: por Next (Siguiente), va a la página siguiente en este nivel de la estructura de árbol;

  • p: por Previous (Previo), va a la página info previa.

Los comandos son numerosos, puede presionar la tecla ? para obtener una lista.

15.1.3. Los COMO

Los COMOs son documentos publicados por el LDP (Linux Documentation Project, Proyecto de documentación de GNU/Linux), dedicados a la configuración de muchos aspectos de su sistema. Los COMOs existen en muchos idiomas y es probable que encuentre en su disco rígido un documento que responda a su pregunta específica o problema, si ha instalado los paquetes correspondientes (estos son los paquetes howto y howto-spanish para las ediciones inglesa y española respectivamente). Se encuentran en el directorio /usr/doc/HOWTO (o en /usr/doc/HOWTO/translations/es). Su formato primario es de archivos de texto, pero también están disponibles en HTML para ser leídas con un navegador web, y PostScript para su impresión.

La lista es muy extensa, para tener una idea consulte el índice del menú principal: Documentación->Howtos Spanish Si encuentra un problema que no puede resolver, la mejor manera de comenzar es buscar y leer el COMO correspondiente, si existe, y es muy probable no sólo que encuentre la solución, sino que también aprenderá mucho en el proceso. Entre otros temas se cubren las redes (NET-3-HOWTO), la configuración de placas de sonido (Sound-HOWTO), la grabación de CD (CD-Writing-HOWTO), la configuración de NIS y NFS y un montón de cosas más.

Sin embargo, necesitará prestar atención a las fechas de modificación de los documentos COMO. Algunos no se actualizaron recientemente y es posible que su contenido ya no sea tan preciso o no esté tan actualizado en ciertos detalles. Es por esto que se debe verificar la fecha de publicación, que siempre se encuentra al comienzo del documento, y tener cuidado sobre todo con los COMO antiguos que se refieren a la configuración de hardware: este es un área donde GNU/Linux evoluciona muy rápido. También tenga presente que el término "antiguo" en el mundo del software libre es aun más significativo que en el de la informática en general: a veces se considera antiguo al software libre cuando tiene más de quince días.

15.1.4. El directorio /usr/doc

Algunos paquetes también vienen con su documentación propia, que se ubica en un sub-directorio de /usr/doc que tiene el mismo nombre que el paquete. Cabe destacar que, mayormente, esta documentación está en inglés y todavía no está traducida.


Tux sobre Estrella por MandrakeSoft Linux es una marca registrada de Linus Torvalds. Todas las otras marcas registradas y copyrights son la propiedad de sus respectivos dueños.
A menos que se diga lo contrario, todo el contenido de estas páginas y todas las imágenes tienen Copyright de MandrakeSoft S.A. y de MandrakeSoft Inc. 2000.
http://www.linux-mandrake.com/