table of contents
- bullseye 2.9.4-2
- bullseye-backports 2.10.1-1~bpo11+1
- testing 2.11.2-1
- unstable 2.11.2-2
MANPATH(5) | /etc/manpath.config | MANPATH(5) |
NOMBRE¶
manpath - formato del fichero /etc/manpath.config
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/manpath.config 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/manpath.config 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 ...
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.
2021-02-08 | 2.9.4 |