NOMBRE

       catman - crea o actualiza las páginas de manual preformateadas

SINOPSIS

       catman [-d?V] [-M ruta] [-C fichero] [sección] ...

DESCRIPCIÓN

       catman  se  utiliza para crear un conjunto actualizado de páginas preformateadas de manual
       conocidas como páginas cat.  Las páginas cat generalmente son mucho más rápidas de mostrar
       que las páginas del manaul originales, pero requieren espacio de almacenamiento adicional.
       La decisión de utilizar páginas cat es competencia del administrador local, el  cual  debe
       proporcionar directorios adecuados de alojarlas.

       Las  opciones  disponibles para catman son las jerarquías y secciones de páginas de manual
       para pre-formatear.  Las jerarquías  predeterminadas  son  aquellas  especificadas  en  el
       fichero  de  configuración  de  la  man-db,  y  las  secciones predeterminadas son bien el
       contenido de la variable de entorno $MANSECT delimitado con dos puntos, bien  el  conjunto
       estnándar  compilado  en  man  si  $MANSECT  está  indefinida.  Proporcionar catman con un
       conjunto de nombres de sección delimitados con espacios en blanco anula las dos  variables
       anteriores.

       catman  utiliza  la  caché  de  base  de datos de índices asociada con cada jerarquía para
       determinar qué ficheros es preciso formatear.

OPCIONES

       -d, --debug
              Escribe información de depuración.

       -M ruta, --manpath=ruta
              Especifica una ruta de búsqueda alternativa de  jerarquías  de  páginas  de  manual
              delimitadas  por  dos  puntos.   Lo  predefinido  es todas las rutas indicadas como
              jerarquías del distema en el fichero de configuración de man-db.

       -C fichero, --config-file=fichero
              Utilice este fichero de configuracion de usuario en lugar del predeterminado  según
              ~/.manpath.

       -?, --help
              Escribe un mensaje de ayuda y termina.

       --usage
              Escribe mensaje breve sobre uso del programa y termina.

       -V, --version
              Muestra información sobre la versión.

ENTORNO

       MANSECT
              Si  $MANSECT  está  establecido, su valor es una lista de secciones delimitadas por
              dos puntos y se emplea para determinar en qué secciones de manual buscar y  en  qué
              orden.   Lo  predeterminado  es "1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7", salvo
              que esté anulado por la directiva SECCIÓN en /etc/manpath.config.

       MANPATH
              Si se establece $MANPATH, su valor se  interpreta  como  la  ruta  de  búsqueda  de
              jerarquía de páginas de manual delimitadas por dos puntos.

FICHEROS

       /etc/manpath.config
              fichero de configuración de man-db.

       /usr/man/index.(bt|db|dir|pag)
              Una caché de BD indexada global tradicional.

       /var/catman/index.(bt|db|dir|pag)
              Un caché de base de datos de índices global alternativa o compatible FSSTND.

VÉASE TAMBIÉN

       man(1), manpath(5), mandb(8)

AUTOR

       Wilf. (G.Wilford@ee.surrey.ac.uk).
       Fabrizio Polacco (fpolacco@debian.org).
       Colin Watson (cjwatson@debian.org).