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.