mandb(b)         tiles para las Pginas del Manual        mandb(b)



NOMBRE
       mandb  -  crea o actualiza los ndices temporales de pginas
       del manual

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

DESCRIPCIN
       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  informa-
       cin  sobre el estado actual del sistema de pginas del man-
       ual, y la infomacin contenida en  ellos  se  usa  por  las
       utilidades  man_db para mejorar su velocidad y funcionali-
       dad.

       Cuando se crea o actualiza un ndice, mandb  le  avisar  de
       peticiones  ROFF .so incorrectas, nombres falsos de pginas
       de manual y pginas 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  bsqueda  `global'
       interna  para  la  jerarqua  depginas  del  manual, que se
       determina a partir de la informacin que se encuentra en el
       fichero de configuracin de man_db.

BASES DE DATOS TEMPORALES
       mandb  puede compilarse con soporte para cualquiera de los
       siguientes tipos de bases de datos.

       tab (@); l l l l.  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
       asncronas  permiten  mayor  velocidad,  a costa de posible
       corrupcin en caso de una interrupcin inusual.  En el  caso
       inusual  de  que esto ocurra, puede ser necesario volver a
       ejecutar mandb con la opcin -c para  volver  a  crear  las
       bases de datos desde cero.

OPTCIONES
       -d, --debug
              Muestra informacin de depurado.

       -q, --quiet
              No muestra ningn aviso.

       -s, --no-straycats
              No  dedica tiempo a buscar o aadir informacin a las
              bases de datos sobre pginas "cat" sin su correspon-
              diente pgina fuente.

       -c, --create
              Por  defecto,  mandb  intentar actualizar cualquier
              base de datos creada previamente.  Si una  base  de
              datos  no  existe,  la  crear.  Esta opcin 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 versin, y termina.

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

       <filename>: whatis parse for page(e) failed
              (<fichero>:   El   anlisis  del  "whatis"  para  la
              pgina(a) fall).  El intento de extraer la lnea
              o  lneas  de  descripcin  breve  del <fichero> dado
              fall. Esto se debe usualmente a  que  la  pgina  de
              manual  est  pobremente  escrita, pero si se emiten
              muchos mensajes como este, es probable que el  sis-
              tema contenga pginas 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 simblico hace  referencia  a
              l.   Usualmente se emiten ms diagnsticos para iden-
              tificar el  nombre  de  fichero  del  enlace  prob-
              lemtico.

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

       <filename>: ignoring bogus filename
              (<fichero>: ignorando nombre  falso)  El  <fichero>
              puede  o  no ser una pgina de manual vlida, pero su
              nombre no es vlido. Esto se debe usualmente a  pgi-
              nas  de manual con la extensin de seccin <x> que se
              han puesto en la seccin <y>.

       <filename_mask>: competing extensions
              (<mscara_de_nombre_de_fichero>:   extensiones   que
              compiten)     La     "wildcard"     <mscara_de_nom-
              bre_de_fichero> no es nica. Esto est causado usual-
              mente  por  la  existencia de ambas versiones, com-
              primida y no comprimida, de la misma pgina del man-
              ual. Se usar slo la ms reciente.

FICHEROS
       /etc/manpath.config
              fichero de configuracin 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.

VASE TAMBIN
       man(n), manpath(h), catman(n).

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



2.3.20                  07 September 2001                mandb(b)