MANPATH(5)

NOMBRE
manpath - formato del fichero /etc/man_db.conf

DESCRIPCIÓN
El fichero de configuración de manpath lo emplean las utilidades de páginas de manual para evaluar las manpath de los usuarios en tiempo de ejecución, para indicar qué jerarquías de páginas de manual (manpaths) van a tratarse como jerarquías del sistema y para asignarles directorios que se utilizarán para almacenar ficheros cat. Si la variable de entorno $MANPATH ya está establecida, la información contenida en /etc/man_db.conf no la anulará.

FORMATO
Los siguientes tipos de campos son actualmente reconocidos:

# comentario
    Las líneas en blanco o las que comienzan con un # serán tratadas como comentarios e ignoradas.

MANDATORY_MANPATH manpath_element
    Las líneas de esta forma indican manpaths que todo $MANPATH generado automáticamente debería contener. Típicamente incluye /usr/man.

MANPATH_MAP path_element manpath_element
    Las líneas de esta forma establecen asociaciones entre $PATH y $MANPATH. Por cada path_element encontrado en la $PATH del usuario, manpath_element se añadirá al $MANPATH.

MANDB_MAP manpath_element [ catpath_element ]
    Las líneas de esta forma indican qué manpaths van a tratarse como manpaths del sistema y opcionalmente dónde deberían almacenarse sus ficheros cat. Este tipo de campo es particularmente importante si man es un porgrama setuid, pues (cuando en el fichero de configuración del sistema /etc/man_db.conf en vez del fichero de configuración por cada usuario .manpath) indica qué jerarquías de páginas de manual acceder como usuario setuid y cuáles como el usuario que invoca. Las jerarquías de página de manual de sistema normalmente son aquellas que están almacenadas bajo /usr, tales como /usr/man, /usr/local/man y /usr/X11R6/man. Si las páginas cat de un element_manpath concreto no van a almacenarse o van a almacenarse en la ubicación tradicional, catpath_element puede omitirse. La ubicación tradicional de cat sería imposible para jerarquías de páginas de manual montadas para solo lectura, por lo que es posible especificar cualquier jerarquía de directorios para su almacenamento. Para observar Linux FSSTND puede utilizarse la palabra clave FSSTND en lugar de un directorio real. Desafortunadamente, es necesario especificar todas las rutas de árboles de man del sistema, incluso las rutas de sistemas operativos alternativos como /usr/man/sun y cualesquier rutas de localización NLS como /usr/man/es_ES.88591. Como la información se analiza línea a línea en el orden de escritura, es necesario para cualquier manpath que sea una sub-jerarquía de otra jerarquía estar listado antes; de otro modo, se detectará una coincidencia incorrecta. Un ejemplo es que /usr/man/de_DE.88591 debe venir antes que /usr/man.

DEFINE clave valor
    Las líneas de esta forma definen variables de configuración diversas; véase el fichero de configuración predeterminado para aquellas variables utilizadas para las utilidades del paginador del manual, que incluyen rutas predefinidas a varios programas (tales como grep y tbl), y conjuntos predefinidos de argumentos para dichos programas.

SECTION sección ...
    Las líneas de esta forma definen el orden de búsqueda de las secciones del manual. Si no hay ninguna directiva SECTION en el fichero de configuración, la predeterminada es:

        SECTION 1 n l 8 3 0 2 5 4 9 6 7

    Si hay múltiples directivas SECTION, sus listas de secciones serán concatenadas.

    Si una extensión determinada no está en esta lista (digamos, 1mh) se mostrará con el resto de la sección a la que pertenece. El efecto de esto es que solo hace falta listar extensiones explícitamente si se desea forzar un orden determinado. Las secciones con extensiones normalmente deberían ser adyacentes a su sección principal (p.e. «1 1mh 8 ...»).

    SECTIONS se acepta como nombre alternativo para esta directiva.

MINCATWIDTH anchura
    Si la anchura del terminal es menor que anchura, las páginas cat no se crean (si faltan) ni se muestran. La predeterminada es 80.

MAXCATWIDTH anchura
    Si la anchura del terminal es mayor que anchura, las páginas cat no se crean (si falta) ni se muestran. La predeterminada es 80.

CATWIDTH anchura
    Si anchura es distinta de cero, las páginas cat siempre se formatean para un terminal de la anchura indicada, independientemente de la anchura del terminal utilizada en realidad. Normalmente debería estar dentro del rango establecido por MINCATWIDTH y MAXCATWIDTH.

NOCACHE
    Esta opción evita que man(1) cree páginas cat automáticamente.

DEFECTOS
A menos que las reglas anteriores se respeten escrupulosamente, las utilidades del paginador del manual no funcionarán como es debido. Las reglas son tremendamente complicadas.