Provided by: man-db_2.10.2-1_amd64 bug

NOMBRE

       manpath - formato del archivo /etc/manpath.config

DESCRIPCIÓN

       El archivo 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 archivos cat.

       Si la variable de entorno $MANPATH  ya  está  establecida,  la  información  contenida  en
       /etc/manpath.config no la anulará.

RUTA DE BÚSQUEDA

       Por  defecto,  man-db  busca  en  la  variable  $PATH  del  usuario. Por cada path_element
       encontrado, agrega manpath_element a la ruta de búsqueda.

       Si no hay una línea MANPATH_MAP en el archivo de configuración  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 búsqueda.

       Después agrega todas las entradas MANDATORY_MANPATH del archivo de configuración a la ruta
       de búsqueda.

       Por último, si se utiliza la opción --systems, o si la variable de  entorno  $SYSTEM  está
       establecida,  entonces  esta  debería  consistir  en  una secuencia de nombres de sistemas
       operativos separados por comas o  por  el  signo  de  dos  puntos.  Esto  actúa  como  una
       plantilla,  expandiendo  la  ruta  de  búsqueda otra vez para permitir acceso a páginas 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 búsqueda, y lo agrega a la ruta de
       búsqueda, si existe. El nombre de sistema man  agrega  la  ruta  de  búsqueda  normal  sin
       subdirectorios.    Por    ejemplo,    si    la    ruta    de    búsqueda    hubiera   sido
       /usr/share/man:/usr/local/man, y $SYSTEM está establecida a newOS:man, entonces la ruta de
       búsqueda                                     final                                    será
       /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man.

       La variable de entorno $MANPATH anula las rutas de búsqueda por defecto de  la  página  de
       manual  de  man-db.  La  mayoría  de  los  usuarios no deberían necesitar establecerla. Su
       sintaxis es similar a la variable de entorno $PATH: consiste en una secuencia  de  nombres
       de  directorio  separados  por  el  símbolo  de  dos puntos. Anula la ruta de búsqueda por
       defecto descrita arriba.

       Si el valor de $MANPATH comienza  con  el  signo  de  dos  puntos,  la  ruta  de  búsqueda
       predeterminada  se le agrega al principio. Si el valor de $MANPATH termina con el signo de
       dos puntos, la ruta de búsqueda predeterminada se le agrega  al  final.  Si  el  valor  de
       $MANPATH  contiene  el signo de dobles dos puntos (::), la ruta de búsqueda predeterminada
       es agregada enmedio del valor, entre los signos de dos puntos.

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 elemento_rutaman
              Las  líneas  de  esta  forma  indican  rutas  de  manual que todo $MANPATH generado
              automáticamente debería contener.  Típicamente incluye /usr/man.

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

       MANDB_MAP elemento_rutaman [ elemento_rutacat ]
              Las líneas de esta forma indican qué rutas de manual van a tratarse como  rutas  de
              manual  del  sistema  y  opcionalmente dónde deberían almacenarse sus archivos cat.
              Este tipo de campo es particularmente importante si man es un porgrama setuid, pues
              (cuando  en  el archivo de configuración del sistema /etc/manpath.config en vez del
              archivo de configuración por cada usuario .manpath)  indica  a  qué  jerarquías  de
              páginas  de  manual  acceder  como  usuario  setuid  y a 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 elemento_rutaman concreto no van a almacenarse o van a
              almacenarse en la ubicación tradicional, elemento_rutacat 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  respetar  el  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 ruta de manual que sea una sub-jerarquía de  otra  jerarquía,  estar
              listada  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
              archivo 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  archivo  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 enlistar 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.

       https://gitlab.com/cjwatson/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db