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 ...
              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.

2.9.1                                              2020-02-25                                         MANPATH(5)