Provided by: man-db_2.6.1-2_i386 bug

NOMBRE

       mandb - crea o actualiza los indices temporales de paginas del manual

SINOPSIS

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

DESCRIPCI'ON

       mandb  se  usa  para  crear  o  actualizar manualmente la base de datos
       temporal de 'indices que usualmente mantiene  la  utilidad  man.   Estos
       indices  temporales  contienen  informacion  sobre el estado actual del
       sistema de paginas del manual, y la infomacion contenida  en  ellos  se
       usa   por   las   utilidades   man-db   para  mejorar  su  velocidad  y
       funcionalidad.

       Cuando se crea o actualiza un 'indice, mandb le  avisara  de  peticiones
       ROFF  .so  incorrectas,  nombres  falsos de paginas de manual y paginas
       cuyos whatis (descripciones cortas) no pudieron analizarse.

       Si se le suministra a mandb  una  ruta  opcional,  delimitada  con  dos
       puntos  (:),  no  usara  la  ruta  de busqueda `global' interna para la
       jerarquia depaginas del  manual,  que  se  determina  a  partir  de  la
       informacion que se encuentra en el fichero de configuracion 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         Arbol binario   Si      index.bt
       GNU gdbm v >= 1.6   "Hashed"        Si      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  asincronas
       permiten  mayor velocidad, a costa de posible corrupcion en caso de una
       interrupcion inusual.  En el caso inusual de que esto ocurra, puede ser
       necesario  volver a ejecutar mandb con la opcion -c para volver a crear
       las bases de datos desde cero.

OPTCIONES

       -d, --debug
              Muestra informacion de depurado.

       -q, --quiet
              No muestra ningun aviso.

       -s, --no-straycats
              No dedica tiempo a buscar o anadir informacion a  las  bases  de
              datos sobre paginas "cat" sin su correspondiente pagina fuente.

       -c, --create
              Por  defecto, mandb intentara actualizar cualquier base de datos
              creada previamente.  Si una base de datos no existe, la  creara.
              Esta  opcion  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 unicamente, 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 version, y termina.

DIAGN'OSTICOS

       Los  siguientes  mensajes  de  aviso   pueden   omitirse   durante   la
       construccion de las bases de datos.

       <filename>: whatis parse for page(sec) failed
              (<fichero>:  El  analisis  del  "whatis" para la pagina(seccion)
              fallo).  El intento de extraer la linea o lineas de  descripcion
              breve del <fichero> dado fallo. Esto se debe usualmente a que la
              pagina de manual esta pobremente  escrita,  pero  si  se  emiten
              muchos  mensajes  como este, es probable que el sistema contenga
              paginas 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 simbolico hace referencia a el.  Usualmente se emiten mas
              diagnosticos  para  identificar  el nombre de fichero del enlace
              problematico.

       <filename>: bad symlink or ROFF `.so' request
              (<fichero>: enlace simbolico o peticion ROFF `.so'  incorrectos)
              <fichero>  es  o  bien  un  enlace  simbolico  a, o contiene una
              peticion ROFF para incluir, un fichero no existente.

       <filename>: ignoring bogus filename
              (<fichero>: ignorando nombre falso) El <fichero> puede o no  ser
              una  pagina  de manual valida, pero su nombre no es valido. Esto
              se debe usualmente a paginas  de  manual  con  la  extension  de
              seccion <x> que se han puesto en la seccion <y>.

       <filename_mask>: competing extensions
              (<mascara_de_nombre_de_fichero>:  extensiones  que  compiten) La
              "wildcard" <mascara_de_nombre_de_fichero> no es unica. Esto esta
              causado   usualmente  por  la  existencia  de  ambas  versiones,
              comprimida y no comprimida, de la misma pagina  del  manual.  Se
              usara solo la mas reciente.

FICHEROS

       /etc/manpath.config
              fichero de configuracion de man-db.

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

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

V'EASE TAMBI'EN

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

AUTOR

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