7. Búsqueda y consulta de documentación

Indicadores de logros

7.1. Lectura: Búsqueda y consulta de documentación

Al emplear su sistema Linux notará que debe leer la documentación de cada programa y del sistema. Es importante que lo haga por varias razones:

  • Linux es un sistema que evoluciona muy rápido con la ayuda de muchas personas en el mundo (nosotros también podemos ayudar!), por eso algunas particularidades pueden cambiar de una versión a otra --aunque los conceptos fundamentales de Unix permanecen como sustento.

  • Sólo consultando la documentación de cada programa podrá aprovecharlo al máximo.

  • Al buscar y consultar documentación por su cuenta, está aprendiendo por si mismo.

Estas guías vistas con
		    Gnome Help Browser

Una dificultad que puede encontrar al consultar documentación para Linux es el idioma, pues la documentación más actualizada está disponible sólo en Inglés. Aún así, generalmente, son documentos técnicos sencillos que podrá entender con unos conocimientos mínimos de inglés (además de que podrá poner en práctica ese idioma!).

Para buscar documentación, no necesita estar conectado a Internet, su sistema Linux incluye gran cantidad de información que le permitirá aprender, solucionar sus problemas y construir sus herramientas. En particular puede consultar los siguientes tipos de documentación:

  • Estas guías. Si las tiene instaladas en su computador puede consultarlas de una de las siguientes formas:

    • con un navegador puede localizarlas como páginas HTML en el directorio /usr/local/share/doc/AA_Linux_colegio

    • en el mismo directorio encuentra una versión PostScript que puede ver e imprimir con el comando gv /usr/local/share/doc/AA_Linux_colegio/AA_Linux_colegio/AA_Linux_colegio.ps.

  • Páginas del manual de Unix. Los desarrolladores de Unix, simultáneamente con el sistema operativo, concebieron un sistema documentación para editar, imprimir y ver en pantalla documentos. El manual del usuario de Unix está escrito con tal sistema. Cada página de este manual tiene un nombre con el que se identifica, y que puede emplearse con el comando man (desde una línea de comandos teclee man seguido del nombre de la página). Hay páginas para cada programa disponible, para los comandos que acepta el intérprete de comandos, páginas con convenciones de los archivos, y páginas para programadores que deseen emplear el sistema operativo. Cada página tiene además del nombre un resumen, una descripción, opciones de uso, archivos relacionados, referencias a documentación relacionada, errores y los nombres de los autores. El programa man permite, entre otras, ver la página solicitada, moverse sobre la misma y realizar búsquedas ---para buscar presione / y después teclee la palabra que busca.

  • Manuales info. Son libros o manuales que documentan algunos programas. Para consultarlos en pantalla puede emplear el programa info seguido del nombre del manual que desea consultar. Si emplea el comando info sólo, entrará a un índice de los manuales disponibles.

  • Gnome cuenta con un sistema de ayuda, que le permite navegar por las páginas del manual, por documentos info y por documentación en HTML de Gnome. Puede entrar a este sistema buscando "Sistema de ayuda" entre los menús de Gnome. Desde el intérprete de comandos lo puede hacer con gnome-help-browser (Solamente funciona en el entorno gráfico).

  • Varios programas pueden mostrar una corta ayuda cuando se invocan desde un intérprete de comandos seguidos de un espacio y la opción --help.

  • En los directorios /usr/doc y /usr/share/doc, podrá encontrar ayuda para varios programas, en diversos formatos. Los formatos de cada documento varían y usualmente están comprimidos, si lo están el nombre terminará en .gz y en ese caso, antes de consultar el documento comprimido debe copiarlo a su directorio y descomprimirlo con el programa gzip seguido de -d y a continuación el nombre del documento. Si el documento es un archivo de texto (el nombre suele termina en .txt) puede emplear un editor de texto para consultarlo, o desde un intérprete de comandos el programa more o el programa less (también puede usar zless para consultar un archivo tipo texto comprimido). Si el archivo es tipo .dvi puede emplear el programa xdvi para consultarlo. Si el archivo es Postscript (.ps o .eps) emplee el programa gv para verlo o imprimirlo. Si es un documento HTML (.html) consúltelo con un navegador, con el sistema de ayuda de Gnome o desde un intérprete de comandos con el programa lynx o con w3m. Si el documento está en formato PDF (.pdf) puede emplear bien gv o bien xpdf.

  • Entre los documentos del directorio /usr/doc hay unos documentos tipo texto que describen de manera informal cómo administrar o configurar diversos componentes de un computadores con Linux, tales guías se llaman HOWTOs, y son un buen punto de referencia para quienes desean administrar un sistema Linux.

Si tiene acceso a Internet, encontrará un mar de información sobre Linux ---tanta que podrá perderse o confundirse. Una vez encuentre información, le sugerimos revisar que la versión del programa al que se refiere la documentación concuerde con la versión del programa que usted emplea (para ver la versión de algunos programas puede dar el nombre del programa seguido de la opción --version). A continuación presentamos algunos URLs de sitios donde puede consultar información sobre Linux:

7.2. Lecturas recomendadas: Búsqueda y consulta de documentación

  • El sistema de documentación de Unix se basa en el formateador troff, así como pre y postprocesadores para el mismo. Con ayuda de algunos paquetes de macros pueden editarse ecuaciones eqn, tablas tbl y figuras pic y con postprocesadores el resultado puede presentarse o imprimirse en diversos dispositivos. El tema es tratado en detalle en "Document Formatting and Typesetting on the Unix System" de Narain Gehani, Silicon Press. En línea puede consultar el manual de Groff --la versión de troff de Linux-- en http://www.cs.pdx.edu/~trent/gnu/groff/groff_toc.html.

  • Los manuales info están escrito con el sistema de documentación Texinfo. Texinfo es una extensión a un sistema llamado TeX que permite escribir documentos de matemáticas. Puede consultar más sobre Texinfo en http://texinfo.org/

  • Pueden resultar de interés para algunas personas estos enlaces a la primera edición del manual de Unix (1971): http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html

7.3. Ejercicios: Búsqueda y consulta de documentación

7.3.1.

Desde una interfaz de comando teclee man man y consulte la explicación sobre el programa man y el manual del sistema. En particular averigüe en esa página para que es el comando whatis.

7.3.2.

Consulte la documentación de GNOME, en particular "Guía de Usuario GNOME", "Lo básico sobre Applet: ¿Qué son Applets?" [12]. Con la información que lea agregue el applet de su preferencia en el panel.

7.3.3.

Abra bash y teclee info. Déle un vistazo a la tabla de contenido de la documentación que tiene disponible. Algunos de estos documentos son libros completos. Entre a la documentación de emacs (un editor de texto) y revísela por encima. Opcional: presione la tecla h para aprender a usar mejor el programa info o la tecla ? para ver un resumen de las teclas que puede usar.

7.3.4.

Estando en un intérprete de comandos teclee mv --help. ¿Para qué sirve el comando mv?

7.3.5.

Revise el directorio /usr/doc, liste algunos de los directorios y el tipo de información que allí encuentre.

7.3.6.

Revise el directorio /usr/doc/HOWTO. Revise alguno de los documentos de ese directorio. ¿Qué documento revisó? ¿Qué información encontró?

7.3.7.

Opcional. Si tiene conexión a Internet consulte http://www.linuxdoc.org ¿En qué consiste el Linux Documentation Project?



[12] Posiblemente la encontrará en file:/usr/share/gnome/help/users-guide/C/gnome-applets.html