La documentación que se incluye con Mandrake Linux

Documentación propia de MandrakeSoft

Esta sección lista toda la documentación que produce MandrakeSoft para la versión corriente:

  • También puede consultar nuestras versiones actualizadas en línea en: las páginas de documentación.

    Si eligió el grupo documentación durante la instalación, seleccionando Leer la documentación desde el menú principal mostrará toda la documentación para los idiomas que eligió durante el proceso de instalación.

  • Guía de Comienzo.

    Este manual pretende hacer que pueda comenzar a utilizar Mandrake Linux. Incluye temas básicos que interesarán a los usuarios nuevos de GNU/Linux, así como también procedimientos de configuración para los elementos más importantes.

  • Guía de Referencia.

    Disponible en línea y en MandrakeLinux - Edición PowerPack ProSuite™, aborda operaciones avanzadas de GNU/Linux y administración del sistema.

Las páginas Man

Esta debería ser la fuente de información primaria para la consulta diaria. Casi todos los comandos tienen su página Man. Además, ciertos archivos de configuración, bibliotecas de funciones para los programadores, y otros, también poseen sus páginas Man propias.

El contenido de las mismas 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 de open en la sección 2 y a la página de fstab en la sección 5.

Para mostrar una página Man en una terminal (o shell), teclee man. La sintaxis para obtener una página Man es la siguiente:

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

man también tiene documentación, la cual se puede obtener tecleando: man man. Las páginas Man se formatean y se muestran usando el paginador less.

En la parte superior de cada página Man verá el nombre de la misma junto con sus secciones relevantes. En la parte inferior 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 Man en inglés).

Puede empezar consultando las páginas que tratan con los distintos comandos que se cubren en Guía de Referencia: ls(1), chmod(1), 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 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.

Las páginas Info

Las páginas Info completan la documentación incluida en las páginas Man. El comando para acceder a las páginas Info desde una terminal 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 la tecla 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.

  • Q: por Quit (Salir) terminará el visualizador de páginas info.

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

Los COMOs

Los COMOs, publicados por el TLDP (The Linux Documentation Project, El proyecto de documentación de Linux) y disponibles en muchos idiomas, lo ayudarán a configurar muchos de los aspectos de su sistema. Siempre y cuando estén instalados los paquetes apropiados (los paquetes howto-html-en y howto-html-es 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/share/doc/HOWTO/HTML/es/ para las versiones en español). Son archivos HTML que se pueden leer e imprimir con un navegador web.

La lista es bastante extensa. Para tener una idea de su longitud consulte el índice desde el menú principal: Leer la documentación->COMOs en castellano. 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 además 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.

Un paso importante 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 válido. Tenga especial cuidado con los COMOs 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 de la información (IT) en general: ¡a veces se considera antiguo al software libre cuando tiene más de quince días!

Nota

Los COMOs están disponibles en línea en el sitio web de TLDP y es más probable que allí estén un poco más actualizados. También puede mirar lo siguiente: COMOs (clasificados por categorías); y FAQs.

El directorio /usr/share/doc

Algunos paquetes incluyen su documentación propia en un subdirectorio 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 al castellano.