3.6. Para más información

3.6.1. Páginas de manual

La documentación más exhaustiva de FreeBSD se encuentra en la forma de páginas de manual. Casi todos los programas del sistema vienen con un sucinto manual de referencia explicando el funcionamiento básico y los diferentes argumentos. Estos manuales pueden ser revisados con el programa man. El uso del programa man es sencillo:

% man command

command es el nombre del programa del que se quiere saber algo. Por ejemplo, para saber algo acerca del programa ls tecléese:

% man ls

El manual en línea está dividido en secciones numeradas:

1. Órdenes/programas de usuario.

2. LLamadas de sistema y códigos numéricos de error.

3. Funciones de las librerías de C.

4. Manejadores de Dispositivos.

5. Formatos de Archivos.

6. Juegos y otros divertimentos.

7. Información miscelánea.

8. Programas relativos al mantenimiento y operación del sistema.

9. Desarrolladores del Kernel.

En algunos casos, el mismo epígrafe puede aparecer en más de una sección del manual en línea. Hay, por ejemplo, un programa de usuario llamado chmod y una llamada de sistema chmod(). En este caso se le puede especificar a man cuál se desea especificando la sección:

% man 1 chmod

Esto nos mostrará la página del manual en línea del programa de usuario chmod. Las referencias a una sección concreta del manual en línea se sitúan tradicionalmente entre paréntesis en la documentación impresa, de tal manera que chmod(1) se refiere al programa de usuario chmod y chmod(2) se refiere a la llamada de sistema.

Esto está muy bien si se conoce el nombre del programa y simplemente se quiere saber cómo usarlo. Pero, ¿qué si se recuerda el nombre del programa? Se puede usar man para que realice una búsqueda mediante palabras clave en las descripciones de programas usando el argumento -k:

% man -k mail

Con esta orden se nos mostrará una lista de programas que contienen la palabra clave “mail” en sus descripciones. Ésto equivale a usar el programa apropos.

Si se está mirando todos esos curiosos programas que residen en /usr/bin y no se tiene ni puñetera idea de que narices hacen realmente, hágase un sencillo:

% cd /usr/bin
% man -f *

o

% cd /usr/bin
% whatis *

que hace exactamente lo mismo.

3.6.2. Archivos de información GNU

FreeBSD incluye muchas aplicaciones y utilidades producidas por la Free Software Foundation (FSF). De manera adicional a las páginas de manual estos programas vienen con documentos de hipertexto más detallados, llamados archivos info, que pueden ser revisados con el programa info o, si se ha instalado emacs, el modo "info" de emacs.

Para usar el programa info(1) simplemente tecléese:

% info

Para una descripción breve, tecléese h. Para una referencia rápida de un programa, tecléese ?.