Guía Man de Gentoo

http://www.gentoo.org/doc/es/man-guide.xml

1.  Introducción

El programa man

Todo el mundo lo ha utilizado en algún momento de su experiencia con Linux. “Él” es el comando man. No obstante, aunque el programa por sí mismo parece ser bastante simplista en su estructura, dispone de algunas capacidades extra además de poder pasar las páginas. Este documento espera arrojar algo de luz en torno a estas capacidades.

Esquema de Man

Las páginas man se almacenan principalmente en el directorio /usr/share/man. De todos modos, con tal de que una página man sea localizada en la variable de entorno MANPATH, man podrá encontrarla. Por regla general, Gentoo almacenará las variables MANPATH en /etc/env.d. En estos directorios se encuentran otros con la estructura manX, donde la X representa el número de sección. Por ejemplo, un esquema de man estándar se parece a lo siguiente:

Listado de Código 1.1: Estructura estándar de man

$ ls /usr/share/man | grep man man0p man1 man1p man2 man3 man3p man4 man5 man6 man7 man8 man9 mann

Este tipo de numeración parece bastante estándar. Sin embargo, dese cuenta en que hay un directorio mann y algunos man#p. La siguiente tabla enumera los directorios antedichos y lo que contienen:

Diretorio Man	Descripción
man0p	La p es de POSIX, como en el resto de directorios con una p en sus nombres. Las páginas man de este directorio describen la funcionalidad de algunos de los ficheros de cabecera de POSIX.
man1	Esta sección es para los comandos estándar. La mayoría de los programas pondrán aquí sus páginas man, por lo que ésta es la sección que tiende a ser la más grande.
man1p	Esta sección describe las versiones POSIX de los comandos descritos en 1p. Puesto que ésta solo describe comandos básicos, es mucho más pequeña que man1.
man2	Esta versión describe las llamadas al sistema del kernel Linux.
man3	Esta sección describe librerías estándar de funciones C.
man4	Esta sección describe dispositivos especiales. Éstos, generalmente, están orientados al kernel, aunque Xorg-X11 también tiene entradas aquí.
man5	Esta sección describe tanto la constitución de ciertos ficheros como aquellos ficheros que un determinado programa utilice. Quienes lean este documento puede que estén familiarizados con las referencias a man 5 portage para una descripción de la estructura del fichero de portage y a man 5 make.conf sobre el aspecto de make.conf.
man6	Esta sección presenta juegos y otros juguetes peculiares.
man7	Esta sección describe estándares y otros elementos de diversa índole. Estos estándares incluyen aspectos como conjuntos de caracteres, cláusulas SQL, estándares ISO y expresiones regulares.
man8	Esta sección describe comandos de administración (aquellos que normalmente ejecuta el usuario root).
man9	Esta sección es algo escasa, aunque está ideada para contener documentación para algunas partes del kernel.
mann	Esta sección es principalmente utilizada por Tcl/Tk. La n es de nuevo.