B.1. 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 333.
- /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 468.
El uso de las páginas man se trata más arriba en la sección 11.1, página 249. 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.