Documentación
Introducción
Este capítulo proporciona al lector los medios para ir más lejos y encontrar información que no figura en esta obra; saber buscar en la documentación aumenta en gran medida la autonomía de los usuarios.
En teoría es posible encontrar toda la información expuesta aquí en la documentación GNU/Linux proporcionada con el sistema.
Manual
Con la mayor parte de distribuciones GNU/Linux se instala un manual electrónico.
1. Secciones
Este manual trata diferentes puntos, como los comandos y su sintaxis, los archivos de configuración del sistema, las bibliotecas estándar de programación...
Para ello, el manual se divide en nueve secciones principales:
-
Sección 1: comandos de usuario.
-
Sección 2: llamadas al sistema.
-
Sección 3: bibliotecas de programación (libc, Perl, SSL, Tcl).
-
Sección 4: archivos especiales y dispositivos.
-
Sección 5: archivos de configuración, formatos y convenciones.
-
Sección 6: juegos.
-
Sección 7: varios.
-
Sección 8: comandos de administración.
-
Sección 9: rutinas del núcleo.
Las secciones 1 y 8, que describen el conjunto de comandos disponibles en GNU/Linux, son las más importantes.
2. Comando man
El acceso a una página del manual se realiza lanzando el comando man y especificando, como argumento en la línea de comandos, el término buscado. Este término corresponde al nombre del comando, del archivo o bien de la biblioteca de programación para lo que se busca información.
Así, para mostrar la página del manual sobre el comando finger visto anteriormente:
$ man finger
Aparece la página siguiente:
NOMBRE
finger - buscar información sobre un usuario.
SINOPSIS
finger [-lmps] [user...] [user@host...]
DESCRIPCIÓN
finger muestra información sobre los usuarios.
Opciones:
-s finger muestra el nombre de login, el nombre real, el ordenador
y la autorización de escritura (” * ” significa que la escritura
sobre el ordenador está prohibida), el tiempo de inactividad,
la fecha de login, la dirección y el número de teléfono del
trabajo....
Documentación Info
1. Comando info
El comando info es una herramienta que agrupa básicamente la misma información contenida en las páginas del manual. Su principal ventaja, respecto a man, es que presenta los datos de forma jerárquica y con vínculos entre sí.
Para acceder a la documentación "Info", basta con escribir el comando info:
$ info
Aparece la visualización siguiente:
File: dir, Node: Top, This is the top of the INFO tree.
This is the Info main menu (aka directory node).
A few useful Info commands:
'q' quits;
'H' lists all Info commands;
'h' starts the Info tutorial;
'mTexinfo RET' visits the Texinfo manual, etc.
* Menu:
Archiving
* Cpio: (cpio). Copy-in-copy-out archiver to tape or disk.
* Tar: (tar). Making tape (or disk) archives.
Basics
* Common options: (coreutils)Common options.
* Coreutils: (coreutils). Core GNU (file, text, shell) utilities.
* Date input formats: (coreutils)Date input formats.
* File permissions: (coreutils)File permissions.
Access modes.
* Finding files: (find). Operating on files matching certain criteria.
-----Info: (dir)Top, 282 lines --Top-----------------------------------------------
Welcome to Info version 6.4. Type H for help, h for tutorial.File: dir Node:
Nos encontramos aquí en la raíz de la jerarquía (File: dir) y los enlaces (precedidos por el carácter *) apuntan a los diferentes nodos de los archivos de documentación "Info".
Un nodo puede considerarse como un capítulo dentro de un archivo de documentación. Puede existir un árbol de nodos, y por lo tanto capítulos y subcapítulos, en un mismo archivo de documentación.
Para llamar al comando...
Opción --help de los comandos en Linux
Además de las páginas del manual y de la documentación "Info" que ya hemos visto, los comandos GNU que se encuentran en Linux aceptan habitualmente la opción --help.
Los comandos invocados con esta opción devuelven una sucinta ayuda que describe la sintaxis general del comando y las opciones más utilizadas; por ejemplo:
$ wc -help
Usage: wc [OPCION]... [ARCHIVO]...
or: wc [OPCION]... --referencia=ARCHIVO-R ARCHIVO...
Muestra el número de nuevas líneas, palabras y bytes para cada ARCHIVO,
y el número total de líneas si se especifica más de un ARCHIVO.
Sin ARCHIVO, o cuando ARCHIVO es -, lee la entrada estándar.
-c, --bytes muestra el número de bytes
-m, --chars muestra el número de caracteres
-l, --lines muestra el número de líneas
--files0-from=F read input from the files specified by
NUL-terminated...
Documentación HOWTO
A su manera, los documentos HOWTO aportan una mina de información al usuario que quiera dominar el sistema operativo con el que trabaja.
Estos documentos de varias páginas se refieren a temas específicos, como la impresión con Linux, la configuración de red del sistema o bien la administración de dispositivos SCSI.
También existen otros documentos, llamados "mini-HOWTO", más sucintos que los otros HOWTO.
Por citar sólo uno de estos documentos, el HOWTO Index recoge todos los HOWTO existentes y los clasifica por categorías, dando una descripción rápida de cada uno.
Estos archivos están disponibles en diferentes formatos:
.txt |
Archivos en formato de texto. |
.ps |
Archivos PostScript imprimibles directamente en las impresoras que reconocen este formato. |
|
Archivos en formato Adobe PDF que pueden leerse con la herramienta xpdf en la interfaz gráfica. |
.html |
Páginas HTML legibles desde cualquier navegador web. |
.tex y .dvi |
Formatos de archivo asociados a las herramientas de paginación y publicación TeX y LaTeX. |
Cuando están instalados en el equipo, se colocan generalmente en el directorio /usr/share/doc/HOWTO. Pero en este caso, el espacio ocupado es bastante notable.
Si no se encuentran en el equipo, es posible consultarlos en uno de los numerosos sitios espejo presentes en Internet y en especial en la dirección...
/usr/share/doc
Además de toda la documentación vista hasta ahora, los desarrolladores y editores de programas proporcionan generalmente una serie completa de documentos que describen su obra.
Esta documentación se encuentra en subdirectorios de /usr/share/doc/:
[javier]$ ls /usr/share/doc
abattis-cantarell-fonts-0.0.10.1
abrt-2.0.19
acl-2.2.51
aic94xx-firmware-30
akonadi-1.8.1
alsa-firmware-1.0.25
alsa-lib-1.0.26
alsa-plugins-pulseaudio-1.0.26
alsa-tools-1.0.26.1
alsa-utils-1.0.26
anaconda-yum-plugins-1.0
anthy-9100h
apper-0.8.0
apr-1.4.6
apr-util-1.4.1
...
Al igual que los HOWTO, los archivos se encuentran en diferentes formatos, por ejemplo:
[javier]$ pwd
/usr/share/doc
[javier]$ ls pam-1.1.6
Copyright html Linux-PAM_SAG.txt rfc86.0.txt txts
[javier]$ ls iproute-3.6.0
COPYING README.decnet README.iproute2+
README README.distribution README.lnstat
Internet
1. Sitios
Internet es una inmensa fuente de información; veamos una breve selección de sitios relacionados con los sistemas GNU/Linux.
Genéricos
https://www.gnu.org/home.es.html
-
Título: GNU’s Not Unix
-
Idioma: multilingüe
-
Descripción: sitio oficial del proyecto GNU.
-
Título: The Linux Documentation Project
-
Idioma: multilingüe
-
Descripción: sitio oficial que agrupa toda la documentación de Linux actualizada: HOWTO, guías, FAQ, páginas de manual...
Editores
-
Título: Red Hat España
-
Idioma: español
-
Descripción: editor de las distribuciones Red Hat Enterprise.
-
Título: Fedora
-
Idioma: multilingüe
-
Descripción: sitio oficial del proyecto Fedora.
-
Título: Debian
-
Idioma: multilingüe
-
Descripción: editor de la distribución del mismo nombre.
-
Título: SUSE
-
Idioma: multilingüe
-
Descripción: editor de las distribuciones SuSE Linux.
-
Título: openSUSE España
-
Idioma: español
-
Descripción: sitio de la distribución libre openSUSE.
-
Título: Ubuntu
-
Idioma: inglés
-
Descripción: editor de la distribución del mismo nombre.
2. Grupos de discusión
De entre todos los grupos de discusión...
Ejercicios
Ejercicio 1
Consulte la página del manual de los comandos vistos en los capítulos precedentes.
Solución
Ejecute el comando man con el nombre del comando que deseamos ver como argumento.
Ejercicio 2
Diríjase a la dirección web The Linux Documentation Project y consulte los índices para los diferentes tipos de documentación ofrecidos.
Solución
Vaya con su navegador a la dirección Web https://tldp.org: