MANPATH(5) /etc/man_db.conf MANPATH(5) NOMBRE manpath - formato del archivo /etc/man_db.conf DESCRIPCION El archivo de configuracion de manpath lo emplean las utilidades de paginas de manual para evaluar las manpath de los usuarios en tiempo de ejecucion, para indicar que jerarquias de paginas de manual (manpaths) van a tratarse como jerarquias del sistema y para asignarles directorios que se utilizaran para almacenar archivos cat. Si la variable de entorno $MANPATH ya esta establecida, la informacion contenida en /etc/man_db.conf no la anulara. RUTA DE BUSQUEDA Por defecto, man-db busca en la variable $PATH del usuario. Por cada path_element encontrado, agrega manpath_element a la ruta de busqueda. Si no hay una linea MANPATH_MAP en el archivo de configuracion para un path_element en particular, entonces agrega todos los path_element/../man, path_element/man, path_element/../share/man y path_element/share/man que existan como directorios a la ruta de busqueda. Despues agrega todas las entradas MANDATORY_MANPATH del archivo de configuracion a la ruta de busqueda. Por ultimo, si se utiliza la opcion --systems, o si la variable de entorno $SYSTEM esta establecida, entonces esta deberia consistir en una secuencia de nombres de sistemas operativos separados por comas o por el signo de dos puntos. Esto actua como una plantilla, expandiendo la ruta de busqueda otra vez para permitir acceso a paginas de manual de otros sistemas operativos: por cada nombre de sistema, man-db busca ese nombre como un subdirectorio de cada entrada en la ruta de busqueda, y lo agrega a la ruta de busqueda, si existe. El nombre de sistema man agrega la ruta de busqueda normal sin subdirectorios. Por ejemplo, si la ruta de busqueda hubiera sido /usr/share/man:/usr/local/man, y $SYSTEM esta establecida a newOS:man, entonces la ruta de busqueda final sera /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man. La variable de entorno $MANPATH anula las rutas de busqueda por defecto de la pagina de manual de man-db. La mayoria de los usuarios no deberian necesitar establecerla. Su sintaxis es similar a la variable de entorno $PATH: consiste en una secuencia de nombres de directorio separados por el simbolo de dos puntos. Anula la ruta de busqueda por defecto descrita arriba. Si el valor de $MANPATH comienza con el signo de dos puntos, la ruta de busqueda predeterminada se le agrega al principio. Si el valor de $MANPATH termina con el signo de dos puntos, la ruta de busqueda predeterminada se le agrega al final. Si el valor de $MANPATH contiene el signo de dobles dos puntos (::), la ruta de busqueda predeterminada es agregada enmedio del valor, entre los signos de dos puntos. FORMATO Los siguientes tipos de campos son actualmente reconocidos: # comentario Las lineas en blanco o las que comienzan con un # seran tratadas como comentarios e ignoradas. MANDATORY_MANPATH elemento_rutaman Las lineas de esta forma indican rutas de manual que todo $MANPATH generado automaticamente deberia contener. Tipicamente incluye /usr/man. MANPATH_MAP elemento_ruta elemento_rutaman Las lineas de esta forma establecen asociaciones entre $PATH y $MANPATH. Por cada elemento_ruta encontrado en la $PATH del usuario, un elemento_rutaman se anadira al $MANPATH. MANDB_MAP elemento_rutaman [ elemento_rutacat ] Las lineas de esta forma indican que rutas de manual van a tratarse como rutas de manual del sistema y opcionalmente donde deberian almacenarse sus archivos cat. Este tipo de campo es particularmente importante si man es un porgrama setuid, pues (cuando en el archivo de configuracion del sistema /etc/man_db.conf en vez del archivo de configuracion por cada usuario .manpath) indica a que jerarquias de paginas de manual acceder como usuario setuid y a cuales como el usuario que invoca. Las jerarquias de pagina de manual de sistema normalmente son aquellas que estan almacenadas bajo /usr, tales como /usr/man, /usr/local/man y /usr/X11R6/man. Si las paginas cat de un elemento_rutaman concreto no van a almacenarse o van a almacenarse en la ubicacion tradicional, elemento_rutacat puede omitirse. La ubicacion tradicional de cat seria imposible para jerarquias de paginas de manual montadas para solo lectura, por lo que es posible especificar cualquier jerarquia de directorios para su almacenamento. Para respetar el Linux FSSTND puede utilizarse la palabra clave FSSTND en lugar de un directorio real. Desafortunadamente, es necesario especificar todas las rutas de arboles de man del sistema, incluso las rutas de sistemas operativos alternativos como /usr/man/sun y cualesquier rutas de localizacion NLS como /usr/man/es_ES.88591. Como la informacion se analiza linea a linea en el orden de escritura, es necesario para cualquier ruta de manual que sea una sub-jerarquia de otra jerarquia, estar listada antes; de otro modo, se detectara una coincidencia incorrecta. Un ejemplo es que /usr/man/de_DE.88591 debe venir antes que /usr/man. DEFINE clave valor Las lineas de esta forma definen variables de configuracion diversas; vease el archivo de configuracion 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 seccion ... Las lineas de esta forma definen el orden de busqueda de las secciones del manual. Si no hay ninguna directiva SECTION en el archivo de configuracion, la predeterminada es: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Si hay multiples directivas SECTION, sus listas de secciones seran concatenadas. Si una extension determinada no esta en esta lista (digamos, 1mh) se mostrara con el resto de la seccion a la que pertenece. El efecto de esto es que solo hace falta enlistar extensiones explicitamente si se desea forzar un orden determinado. Las secciones con extensiones normalmente deberian ser adyacentes a su seccion 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 paginas 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 paginas cat no se crean (si falta) ni se muestran. La predeterminada es 80. CATWIDTH anchura If width is non-zero, cat pages will always be formatted for a terminal of the given width, regardless of the width of the terminal actually being used. This overrides MINCATWIDTH and MAXCATWIDTH. NOCACHE Esta opcion evita que man(1) cree paginas cat automaticamente. DEFECTOS A menos que las reglas anteriores se respeten escrupulosamente, las utilidades del paginador del manual no funcionaran como es debido. Las reglas son tremendamente complicadas. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANPATH(5)