Introducción a Linux/Búsqueda y consulta de documentación

Búsqueda y consulta de documentación

Indicadores de logros

• Busque y emplee la documentación de su sistema Linux.

• Conozca algunas direcciones donde pueda buscar documentación completamentaria en Internet.

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 sí mismo.

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:

• Esta guía

• Páginas del manual de Unix. Los desarrolladores de Unix, simultáneamente con el sistema operativo, concebieron un sistema de 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 mandato man (desde una línea de mandatos 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 una consola 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 en la consola). A continuación presentamos algunos URLs de sitios donde puede consultar información sobre Linux:

• El proyecto LuCAS se dedica a recolectar información sobre Linux en español

http://lucas.hispalinux.es/

• Puede consultar algunas páginas man en

http://www.delorie.com/gnu/docs/ o en :http://www.openbsd.org/cgi-bin/man.cgi

• Varios de los manuales de usuario tipo info están disponibles en

http://www.gnu.org/manual/manual.html

• La guía del usuario GNOME en español está disponible en

http://www.croftj.net/~barreiro/spanish/gnome-es/users-guide/

• El Debian Documentation Project produce documentación para la distribución Debian Linux. Los libros y documentos de este proyecto están disponibles en

http://www.debian.org/doc/ddp

• Hay una vasta colección de información para diversas distribuciones de Linux, así como guías HOWTO en el sitio web de The Linux Documentation Project

http://www.tldp.org

• Hay una distribucion particular de Linux, llamada ArchLinux, que cuenta con pagina en castellano, con wiki, foros, informacion, etc..

http://www.archlinux.org

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/ En wikilibros también tenemos un manual de LaTeX.

• 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

Ejercicios: Búsqueda y consulta de documentación

• 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 qué sirve el comando whatis.

• 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.

• Abra el intérprete bash (normalmente viene por defecto) 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.

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

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

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

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

Notas

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