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.

       Finally, if the --systems option is used or the $SYSTEM environment variable is  set,  then  that  should
       consist  of a sequence of operating system names separated by commas or colons.  This acts as a template,
       expanding the search path once more to allow access to other operating systems' manual  pages:  for  each
       system  name,  man-db looks for that name as a subdirectory of each entry in the search path, and adds it
       to the final search path if it exists.  A system name of man  inserts  the  normal  search  path  without
       subdirectories.  For example, if the search path would otherwise have been /usr/share/man:/usr/local/man,
       and  $SYSTEM is set to newOS:man, then the final search path will be /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 3type 5 4 9 6 7

              Si hay múltiples directivas SECTION, sus listas de secciones serán concatenadas.

              If a particular extension is not in this list (say, 1mh) it will be displayed with the rest of the
              section  it belongs to.  The effect of this is that you only need to explicitly list extensions if
              you want to force a particular order.  Sections with extensions  should  usually  be  adjacent  to
              their main section (e.g. "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
              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 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/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.13.1                                             2025-05-02                                         MANPATH(5)