Página siguiente Página anterior Índice general

9. Información. Documentación y Ayuda

Hay con alguna frecuencia preguntas sobre estos temas en el area. Se ha intentado resumir las respuestas en los siguientes capítulos. Por supuesto, no se hará más mención a FAQs ni HOWTOs, cuya utilidad ya ha quedado expuesta.

9.1 Libros

Los libros sobre UNIX System V Release 4, más fáciles de encontrar que los específicos de Linux, suponen una acercamiento importante al conocimiento de éste último. Sobrarán capítulos, se echarán de menos otros, pero para iniciarse como usuario (cómo borrar un fichero, permisos, ordenes básicas, pipes, etc) son interesantes.

Sobre UNIX en general y otros UN*X:

Libros específicos de Linux:

9.2 Linux Documentation Project

Se han publicado una serie de libros (bajo licencia GNU, es decir, de uno u otro modo, gratuítos) que cubren, siempre en inglés, determinados aspectos de Linux. Todos se renuevan con una u otra frecuencia. Todos ellos están disponibles en metalab.unc.edu y son auténticos libros que pueden ser impresos en cualquier impresora, sea postscript o no, con el programa ghostscript, que existe también para MS-Windows. Para los que no estén en internet, también se pueden encontrar en las distribuciones Infomagic y en algunos BBSs (Lineas Aereas 2:341/43, Elektra 95-4164934) con diversos nombres:

Se incluye un apartado sobre documentación en Castellano más abajo.

9.3 Ayuda On-line

Se incluye esta sección al no existir ninguna FAQ, ni siquiera en inglés, sobre el particular. En parte porque no es un tema específico Linux; pero sin duda es de gran interés entre los que leemos el area. Quizá en un futuro sea mejor escindir o eliminar esta sección por completo. Una vez más, se admiten sugerencias.

Existen varios sistemas de ayuda en línea en Linux (UNIX?). La calidad y tipo y profundidad de la información que contienen es muy variable, con lo cual es interesante conocerlos todos. El orden en el que se exponen es de mayor a menor interés para el que suscribe.

MAN PAGES. El primero de ellos, y más conocido, es el manual en línea o "man-pages". Se trata de una larga serie de documentos (a grandes rasgos, uno por cada ejecutable instalado), que permiten una referencia rápida a la utilización de dicha orden o ejecutable. Es habitual encontrar en ellas, entre otras informaciones, los parámetros permisibles, la versión del programa que describen, la ubicación y contenido de ficheros de configuración, etc. En las distribuciones se acompañan una serie de paquetes denominados 'man*' que incorporan distintas colecciones de páginas. Las páginas se dividen en bloques, dependiendo del tema tratado, del 1 al 9. Para no insistir innecesariamente, lo mejor es probar:

$ man man

entrega toda la información sobre el comando man. De ahí en adelante... cada uno, solo. :-)

Para imprimirlas hay que utilizar distintos comandos dependiendo del formato en que estén almacenadas, que puede deducirse fácilmente de la trayectoria bajo la que estén almacenadas.

Preformateadas

Para las páginas bajo /usr/man/preformat:

$ zcat /usr/man/preformat/cat2/bind.2.gz | groff -Tlatin1 | lpr

Fuente no comprimidas

Páginas bajo /usr/man/man?

$ groff -mandoc -Tascii /usr/man/man1/ircII.1 | lpr

Texto ASCII, comprimidas

Páginas bajo /usr/man/cat?

$ zcat /usr/man/cat1/groff.1.gz | lpr

Atención: Se agradecería conocer comentarios sobre posibles problemas surgidos con el párrafo anterior.

INFO. Se trata de un programa que permite leer documentación en línea con un formato determinado. En la Serie I de la distribución Slackware se incluye una gran cantidad de documentos para Info, muy recomendables. De nuevo, el camino rápido para empezar a usarlo:

$ info

Esto nos mostrará en el terminal toda la documentación disponible. Info es en principio engorroso (al menos para mí) de usar, pero muchas veces la calidad de la información encontrada merece el esfuerzo.

LOCATE. Es muy habitual necesitar localizar un archivo determinado por el sistema de archivos. La orden find hace el cometido perfectamente, pero a costa de tiempo y una sintaxis un poco puntillosa. Sugiero montar el CDROM y los floppies favoritos y ejecutar:

# updatedb

Tarda un poco. Al terminar podemos pedir:

$ locate XF86Con (yo nunca recuerdo donde está :-))

y obtendremos, inmediatamente, una lista de los archivos y directorios cuyo nombre coincide con nuestra petición.

APROPOS. Otro nuevo sistema. apropos permite consultar, de modo rápido, todas las cabeceras de páginas man antes descritas de cara a encontrar palabras clave que nos permitan una búsqueda más concreta. Por ejemplo. Deseamos copiar un archivo, pero no recordamos la orden UNIX que lo hace.

$ apropos copy

(en inglés, claro) nos entrega una lista de páginas man que incluyen la cadena copy en su cabecera. Y seguro que la lista incluye el comando cp que probablemente sea lo que necesitábamos. Para que esto funcione, previamente hay que construir la base de datos, con:

# makewhatis -c

La construcción de esta base de datos es lenta, quizá unos 40 minutos en un 486/66-8Mb. Aviso. Y algunas páginas man no están escritas en el formato estándar, como las de Tcl/tk, y manchan la base de datos resultante, que queda, normalmente, en /usr/man/whatis, y que puede ser editada a posteriori de cara a recuperar los formatos dañados. (1 minuto, sin experiencia).

NOTA: apropos hace exactamente lo mismo que man -k.


Página siguiente Página anterior Índice general