Búsqueda y consulta de documentación
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.
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:
Programa que permite ver las páginas del manual de Unix.
Programa que permite ver los manuales info.
Opción que varios programas emplean para presentar una breve ayuda de como usarlos.
Directorio en el que pueden encontrarse manuales y documentación de varios programas en diversos formatos.
Programa para ver o imprimir documentación en formato Postscript.
Programa para comprimir o descomprimir archivos con extensión .gz.
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 "" 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:
Estas guías pueden consultarse y obtenerse en http://structio.sourceforge.net/guias/AA_Linux_colegio.
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
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
Ejercicios: Búsqueda y consulta de documentación
- 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.
- 2. Consulte la documentación de GNOME, en particular "Guía de Usuario GNOME", "Lo básico sobre Applet: ¿Qué son Applets?" [1]. Con la información que lea agregue el applet de su preferencia en el panel.
- 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.
- 4. Estando en un intérprete de comandos teclee mv help. ¿Para qué sirve el comando mv?
- 5. Revise el directorio /usr/doc, liste algunos de los directorios y el tipo de información que allí encuentre.
- 6. Revise el directorio /usr/doc/HOWTO. Revise alguno de los documentos de ese directorio. ¿Qué documento revisó? ¿Qué información encontró?
- 7. Opcional. Si tiene conexión a Internet consulte http://www.linuxdoc.org ¿En qué consiste el Linux Documentation Project?
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.
whatis presenta una breve descripción del comando que recibe, extractada de la correspondiente página del manual de Unix.
2. Consulte la documentación de GNOME, en particular "Guía de Usuario GNOME", "Lo básico sobre Applet: ¿Qué son Applets?" [1]. Con la información que lea agregue el applet de su preferencia en el panel.
Un applet es un programa que se mantiene activo durante una sesión Gnome, presentando información en un pequeño espacio del panel.
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.
Espacio para avanzar una pantalla o de un nodo a otro; q para salir; h para ver un tutorial; n para avanzar al siguiente nodo; p para ir al nodo anterior; u para ir al nodo superior; TAB pasa de un enlace a otro; Enter va a un enlace; l retorna al nodo antes visitado.
Para mover un archivo de un directorio a otro o para renombrarlo. Por ejemplo para mover tmp/p.txt a casa/p.txt se usa:
mv tmp/p.txt casa/p.txt
5. Revise el directorio /usr/doc, liste algunos de los directorios y el tipo de información que allí encuentre.
Por cada programa hay un directorio que contiene al menos la licencia. Puede haber otros archivos que documentan el programa o el paquete Debian y pueden haber manuales de usuario.
6. Revise el directorio /usr/doc/HOWTO. Revise alguno de los documentos de ese directorio. ¿Qué documento revisó? ¿Qué información encontró?
Entre los HOWTO para principiantes uno muy apropiado es Unix-and-Internet-Fundamentals-HOWTO.
7. Opcional. Si tiene conexión a Internet consulte http://www.linuxdoc.org ¿En qué consiste el Linux Documentation Project?
Colecciona y organiza documentos relacionados con Linux.