Apéndice A. Dónde obtener documentación

Tabla de contenidos
A.1. La documentación incluida en Linux-Mandrake
A.1.1. Las páginas de manual
A.1.2. Páginas Info
A.1.3. Los COMOs
A.1.4. El directorio /usr/share/doc
A.2. Internet
A.2.1. Sitios web dedicados a Linux
A.2.2. Las listas de distribución de correo
A.2.3. Foros de discusión
A.3. Guía general para resolver un problema bajo Linux-Mandrake
A.3.1. RTFM
A.3.2. Busque en la Internet
A.3.3. Listas de distribución de correo y archivos históricos de los foros de discusión
A.3.4. Preguntando en las listas y en los foros
A.3.5. Contactando directamente a la persona a cargo

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.

A.1. La documentación incluida en Linux-Mandrake

A.1.1. Las páginas de manual

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.

El contenido del manual está organizado en secciones diferentes. Las referencias a estas secciones se hacen de la manera siguiente: por ejemplo, open(2), fstab(5) se referirán respectivamente a la página open en la sección 2 y a la página de fstab en la sección 5.

Para mostrar que una página de manual teclee man. La sintaxis será la siguiente:
man [opciones] [sección] <página de manual>
Incluso hay un comando disponible para man mismo: man man. Las páginas de manual se formatean y se muestran usando un pager (paginador), que predeterminadamente es less. Entonces ya sabe como recorrer una página de manual y como salir de la misma :-)

Al comienzo de cada página de manual verá el nombre de la misma junto con las secciones relevantes de la misma. Al final de la página se dan referencias a otras páginas con temas relacionados (en general en la sección VÉASE TAMBIÉN, o SEE ALSO para las páginas de manual en inglés).

Puede empezar consultando las páginas que tratan con los distintos comandos que se cubrieron en este manual: ls(1), chmod(1), etc.

Si no encuentra la página de manual adecuada (por ejemplo, quiere usar la función mknod en uno de sus programas pero termina en la página del comando mknod), asegúrese de mencionar la sección explícitamente. En nuestro ejemplo: mknod(2). Si no puede recordar la sección exacta, man -a mknod leerá todas las secciones buscando las páginas denominadas mknod.

A.1.2. Páginas Info

Las páginas info completan la documentación incluida en las páginas de manual. El comando para acceder a las páginas info es info.

Las páginas info están organizadas en forma de árbol, cuyo tope se denomina dir. Desde allí, se puede acceder a todas las páginas info existentes.

Puede invocar a info de dos maneras: ya sea omitiendo todo argumento, en cuyo caso se ubicará en la raíz de la estructura de árbol, o agregando el nombre de un comando o de un paquete, en cuyo caso se abrirá, si existe, la página relevante. Por ejemplo:

info emacs

En las páginas info los textos como este:
* Buffers::
indicarán 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.

Puede usar los atajos de teclado siguientes:

  • u: por Up (Arriba) lo lleva un nivel más arriba;

  • n: por Next (Siguiente) lo lleva a la página info siguiente en el mismo nivel de la estructura de árbol;

  • p: por Prev (Previo) lo lleva a la página info previa.

Se puede listar una cantidad grande de comandos presionando la tecla ?.

A.1.3. Los COMOs

Los COMOs, publicados por el LDP (Linux Documentation Project, Proyecto de documentación de Linux), y disponibles en muchos idiomas, lo asistirán con la configuración de muchos de los aspectos de su sistema. Siempre y cuando estén instalados los paquetes adecuados (estos son los paquetes howto-html-en y howto-html-spanish para las ediciones inglesa y española respectivamente), los COMOs le proporcionarán una respuesta a una pregunta específica o una solución a un problema. La documentación está en el directorio /usr/share/doc/HOWTO/HTML/en/ (o en /usr/doc/HOWTO/translations/es). Su formato primario es de archivos de texto, aunque también están disponibles en HTML para ser leídos con un navegador web, y PostScript para su impresión.

La lista es muy extensa. Para tener una idea de su longitud consulte el índice desde el menú principal: Documentación->Howtos Spanish Cuando encuentre un problema complejo que no puede resolver, la mejor manera de comenzar es buscar y leer el COMO correspondiente(si existe, ¡por supuesto!). No sólo se le dará una solución a su problema, sino que también aprenderá mucho en el proceso. Entre otros, el rango de temas que se cubre va desde las redes (NET-3-HOWTO), la configuración de placas de sonido (Sound-HOWTO), la grabación de CD (CD-Writing-HOWTO), hasta la configuración de NIS y NFS y muchas cosas más.

Una cosa importante a tener en cuenta es verificar las fechas de modificación de los documentos COMO, es decir, la fecha de publicación situada al comienzo del documento, para asegurarse que están actualizados. De no ser así es posible que su contenido no sea tan preciso o no esté tan actualizado en ciertos detalles. Tenga cuidado sobre todo con los COMO antiguos que se refieren a la configuración de hardware, ya que Linux evoluciona muy rápido en este área en particular. 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 tecnología informática en general: ¡a veces se considera antiguo al software libre cuando tiene más de quince días.

Nota

Los COMO están disponibles en línea en LDP y es más probable que allí estén más actualizados. Eche un vistazo también a lo siguiente: (clasificado por categorías); y FAQs.

A.1.4. El directorio /usr/share/doc

Algunos paquetes incluyen su documentación propia en un sub-directorio de /usr/share/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/