Provided by: man-db_2.5.5-1build1_i386 bug

NOMBRE

       mandb - crea o actualiza los índices temporales de páginas del manual

SINOPSIS

       mandb [-dqsuc|-h|-V] [rutaalmanual]

DESCRIPCIÓN

       mandb  se  usa  para  crear  o  actualizar manualmente la base de datos
       temporal de índices que usualmente mantiene  la  utilidad  man.   Estos
       índices  temporales  contienen  información  sobre el estado actual del
       sistema de páginas del manual, y la infomación contenida  en  ellos  se
       usa   por   las   utilidades   man-db   para  mejorar  su  velocidad  y
       funcionalidad.

       Cuando se crea o actualiza un índice, mandb le  avisará  de  peticiones
       ROFF  .so  incorrectas,  nombres  falsos de páginas de manual y páginas
       cuyos whatis (descripciones cortas) no pudieron analizarse.

       Si se le suministra a mandb  una  ruta  opcional,  delimitada  con  dos
       puntos  (:),  no  usará  la  ruta  de búsqueda ‘global’ interna para la
       jerarquía depáginas del  manual,  que  se  determina  a  partir  de  la
       información  que se encuentra en el fichero de configuración de man-db.

BASES DE DATOS TEMPORALES

       mandb puede compilarse con soporte para cualquiera  de  los  siguientes
       tipos de bases de datos.

       Nombre              Tipo            Asinc   Nombre de fichero
       --------------------------------------------------------------
       Berkeley db         Árbol binario   Sí      index.bt
       GNU gdbm v >= 1.6   "Hashed"        Sí      index.db
       GNU gdbm v <  1.6   "Hashed"        No      index.db
       UNIX ndbm           "Hashed"        No      index.(dir|pag)

       Los  tipos  de  base  de  datos que soportan actualizaciones asíncronas
       permiten mayor velocidad, a costa de posible corrupción en caso de  una
       interrupción inusual.  En el caso inusual de que esto ocurra, puede ser
       necesario volver a ejecutar mandb con la opción -c para volver a  crear
       las bases de datos desde cero.

OPTCIONES

       -d, --debug
              Muestra información de depurado.

       -q, --quiet
              No muestra ningún aviso.

       -s, --no-straycats
              No  dedica  tiempo  a buscar o añadir información a las bases de
              datos sobre páginas "cat" sin su correspondiente página  fuente.

       -c, --create
              Por  defecto, mandb intentará actualizar cualquier base de datos
              creada previamente.  Si una base de datos no existe, la  creará.
              Esta  opción  fuerza  a  mandb  a  que  borre las bases de datos
              previas, y las  cree  de  nuevo  desde  cero.   Esto  puede  ser
              necesario  si la base de datos se corrompe o si un nuevo esquema
              de almacenamiento de base de datos se introduce en el futuro.

       -u, --user-db
              Crea bases de datos del usuario únicamente, incluso si tiene los
              permisos  de  escritura  necesarios  para  crear  bases de datos
              ‘globales’.

       -h, --help
              Muestra el mensaje de uso, y termina.

       -V, --version
              Muestra la versión, y termina.

DIAGNÓSTICOS

       Los  siguientes  mensajes  de  aviso   pueden   omitirse   durante   la
       construcción de las bases de datos.

       <filename>: whatis parse for page(sec) failed
              (<fichero>:  El  análisis  del  "whatis" para la página(sección)
              falló).  El intento de extraer la línea o líneas de  descripción
              breve del <fichero> dado falló. Esto se debe usualmente a que la
              página de manual está pobremente  escrita,  pero  si  se  emiten
              muchos  mensajes  como este, es probable que el sistema contenga
              páginas de manual no estandar  que  sean  incompatibles  con  el
              analizador de whatis de man-db.

       <filename>: is a dangling symlink
              (<fichero>:  es  un enlace perdido) <fichero> no existe, pero un
              enlace simbólico hace referencia a él.  Usualmente se emiten más
              diagnósticos  para  identificar  el nombre de fichero del enlace
              problemático.

       <filename>: bad symlink or ROFF.sorequest
              (<fichero>: enlace simbólico o petición ROFF ‘.so’  incorrectos)
              <fichero>  es  o  bien  un  enlace  simbólico  a, o contiene una
              petición ROFF para incluir, un fichero no existente.

       <filename>: ignoring bogus filename
              (<fichero>: ignorando nombre falso) El <fichero> puede o no  ser
              una  página  de manual válida, pero su nombre no es válido. Esto
              se debe usualmente a páginas  de  manual  con  la  extensión  de
              sección <x> que se han puesto en la sección <y>.

       <filename_mask>: competing extensions
              (<máscara_de_nombre_de_fichero>:  extensiones  que  compiten) La
              "wildcard" <máscara_de_nombre_de_fichero> no es única. Esto está
              causado   usualmente  por  la  existencia  de  ambas  versiones,
              comprimida y no comprimida, de la misma página  del  manual.  Se
              usará sólo la más reciente.

FICHEROS

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

       /usr/man/index.(bt|db|dir|pag)
              Una base de datos temporal de ndices tradicional.

       /var/catman/index.(bt|db|dir|pag)
              Una  base de datos temporal de ndices alternativa o conforme al
              FSSTND.

VÉASE TAMBIÉN

       man(1), manpath(5), catman(8).

AUTOR

       Wilf.  (G.Wilford@ee.surrey.ac.uk)  Traducción  realizada  por  Enrique
       Zanardi (ezanardi@ull.es)