Tipos de documentación

Puede encontrar documentación, dentro de un sistema Debian, al menos en los siguientes emplazamientos:

• Páginas man o páginas de manual; léalas con la orden man
• Páginas info; léalas con la orden info.
• El directorio /usr/doc/paquete, donde paquete es el nombre del paquete Debian.

  Pista: Para leer los ficheros que hay en /usr/doc resulta útil zless; para más detalles, véase la sección 14.1 en la página .

• /usr/doc/HOWTO/contiene los documentos de formato «Cómo» del proyecto de Documentación de Linux (LDP, Linux Documentation Project), en caso de que haya instalado los paquetes Debian que contienen estos documentos.
• Muchas órdenes disponen de una opción -h o -help. Para comprobarlo, escriba la orden seguida de una de estas dos opciones.
• El Proyecto de documentación de Debian tiene escritos algunos manuales.
• La Página de soporte de Debian tiene unas Preguntas de Uso Frecuente (PUF, en inglés Frequently Asked Questions, FAQ y otros recursos. También puede probar la sede web de Linux, Linux web site.

Hay varias razones por las que existe tan confusa variedad de fuentes para la documentación. Por ejemplo, se supone que info sustituye a man, pero man aún no ha desaparecido. Sin embargo, es agradable saber que existe tanta documentación.

Así que ¿a dónde acudir en busca de ayuda? Aquí tiene algunas sugerencias:

• Utilice las páginas de manual y las opciones -help o -h para obtener un rápido resumen de la sintaxis de la orden y sus opciones. Utilice man en el caso de que el programa todavía no disponga de página info.
• Utilice info si el programa tiene documentación info.
• Si ninguno de los dos medios resulta, busque en /usr/doc/nombre- paquete.
• /usr/doc/nombrepaquete contiene a menudo información específica de Debian, incluso si existe una página de manual o una página info.
• Utilice los Cómos (HOWTOs) para buscar instrucciones sobre la forma de configurar un aspecto particular, o para información sobre su hardware en particular. Por ejemplo, el Ethernet-Cómo (Ethernet-HOWTO) contiene gran cantidad de información sobre tarjetas Ethernet, y el PPP-Cómo (PPP-HOWTO) explica con detalle cómo configurar el PPP.
• Utilice los manuales del proyecto de documentación de Debian para explicaciones conceptuales e información específica de Debian.
• Si todo lo demás no funciona, entonces pregunte a alguien. Véase la sección B.1.3 en la página .

El uso de las páginas man se trata más arriba en la sección 11.1, página . Es muy sencillo: pulse la barra espaciadora para desplazarse una pantalla hacia abajo, y pulse q para abandonar la lectura. El uso de info, la visualización de ficheros de /usr/doc, y la petición de ayuda de una persona son todos conceptos que se discuten en el resto del capítulo.