man/es/man8/mandb.man8

   1 '\" t
   2 .\" Man page for mandb
   3 .\"
   4 .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
   5 .\"
   6 .\" You may distribute under the terms of the GNU General Public
   7 .\" License as specified in the file COPYING that comes with the
   8 .\" man-db distribution.
   9 .\"
  10 .\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
  11 .\"
  12 .TH %thmandb% 8 "%date%" "%version%" "útiles para las Páginas del Manual"
  13 .SH NOMBRE
  14 %mandb% \- crea o actualiza los índices temporales de páginas del manual
  15 .SH SINOPSIS
  16 .B %mandb%
  17 .RB [\| \-dqsuc \||\| \-h \||\| \-V\c
  18 .RI "\|] [\|" ruta al manual \|]
  19 .SH DESCRIPCIÓN
  20 .B %mandb%
  21 se usa para crear o actualizar manualmente la base de datos temporal de
  22 .B índices
  23 que usualmente mantiene la utilidad
  24 .BR %man% .
  25 Estos índices temporales contienen información sobre el estado actual
  26 del sistema de páginas del manual, y la infomación contenida en ellos
  27 se usa por las utilidades man-db para mejorar su velocidad y funcionalidad.
  28
  29 Cuando se crea o actualiza un
  30 .BR índice,
  31 .B %mandb%
  32 le avisará de peticiones ROFF .so incorrectas, nombres falsos de páginas
  33 de manual y páginas cuyos
  34 .B whatis
  35 (descripciones cortas) no pudieron analizarse.
  36
  37 Si se le suministra a
  38 .B %mandb%
  39 una ruta opcional, delimitada con dos puntos (:), no usará la ruta
  40 de búsqueda `global' interna para la jerarquía depáginas del manual,
  41 que se determina a partir de la información que se encuentra
  42 en el fichero de configuración de man-db.
  43 .SH "BASES DE DATOS TEMPORALES"
  44 .B %mandb%
  45 puede compilarse con soporte para cualquiera de los siguientes tipos
  46 de bases de datos.
  47
  48 .TS
  49 tab (@);
  50 l l l l.
  51 Nombre@Tipo@Asinc@Nombre de fichero
  52 _
  53 Berkeley db@Árbol binario@Sí@\fIindex.bt\fR
  54 GNU gdbm@"Hashed"@Sí@\fIindex.db\fR
  55 UNIX ndbm@"Hashed"@No@\fIindex.(dir|pag)\fR
  56 .TE
  57
  58 Los tipos de base de datos que soportan actualizaciones asíncronas
  59 permiten mayor velocidad, a costa de posible corrupción en caso de
  60 una interrupción inusual.
  61 En el caso inusual de que esto ocurra, puede ser necesario volver a
  62 ejecutar
  63 .B %mandb%
  64 con la opción
  65 .B \-c
  66 para volver a crear las bases de datos desde cero.
  67 .SH OPTCIONES
  68 .TP
  69 .B \-d, \-\-debug
  70 Muestra información de depurado.
  71 .TP
  72 .B \-q, \-\-quiet
  73 No muestra ningún aviso.
  74 .TP
  75 .B \-s, \-\-no-straycats
  76 No dedica tiempo a buscar o añadir información a las bases de datos
  77 sobre páginas "cat" sin su correspondiente página fuente.
  78 .TP
  79 .B \-c, \-\-create
  80 Por defecto,
  81 .B %mandb%
  82 intentará actualizar cualquier base de datos creada previamente.
  83 Si una base de datos no existe, la creará. Esta opción fuerza a
  84 .B %mandb%
  85 a que borre las bases de datos previas, y las cree de nuevo desde cero.
  86 Esto puede ser necesario si la base de datos se corrompe o si un nuevo
  87 esquema de almacenamiento de base de datos se introduce en el futuro.
  88 .TP
  89 .B \-u, \-\-user-db
  90 Crea bases de datos del usuario únicamente, incluso si tiene los permisos
  91 de escritura necesarios para crear bases de datos `globales'.
  92 .TP
  93 .B \-h, \-\-help
  94 Muestra el mensaje de uso, y termina.
  95 .TP
  96 .B \-V, \-\-version
  97 Muestra la versión, y termina.
  98 .SH DIAGNÓSTICOS
  99 Los siguientes mensajes de aviso pueden omitirse durante la construcción
 100 de las bases de datos.
 101 .TP
 102 .B <filename>: whatis parse for page(sec) failed
 103 (<fichero>: El análisis del "whatis" para la página(sección) falló).
 104 El intento de extraer la línea o líneas de descripción breve del
 105 <fichero> dado falló. Esto se debe usualmente a que la página de manual
 106 está pobremente escrita, pero si se emiten muchos mensajes como este, es
 107 probable que el sistema contenga páginas de manual no estandar que sean
 108 incompatibles con el analizador de whatis de man-db.
 109 .TP
 110 .B <filename>: is a dangling symlink
 111 (<fichero>: es un enlace perdido)
 112 <fichero> no existe, pero un enlace simbólico hace referencia a él.
 113 Usualmente se emiten más diagnósticos para identificar el nombre de
 114 fichero del enlace problemático.
 115 .TP
 116 .B <filename>: bad symlink or ROFF `.so' request
 117 (<fichero>: enlace simbólico o petición ROFF `.so' incorrectos)
 118 <fichero> es o bien un enlace simbólico a, o contiene una petición
 119 ROFF para incluir, un fichero no existente.
 120 .TP
 121 .B <filename>: ignoring bogus filename
 122 (<fichero>: ignorando nombre falso)
 123 El <fichero> puede o no ser una página de manual válida, pero su nombre
 124 no es válido. Esto se debe usualmente a páginas de manual con la extensión
 125 de sección <x> que se han puesto en la sección <y>.
 126 .TP
 127 .B <filename_mask>: competing extensions
 128 (<máscara_de_nombre_de_fichero>: extensiones que compiten)
 129 La "wildcard" <máscara_de_nombre_de_fichero> no es única. Esto está
 130 causado usualmente por la existencia de ambas versiones, comprimida
 131 y no comprimida, de la misma página del manual. Se usará sólo la más
 132 reciente.
 133 .SH FICHEROS
 134 .TP
 135 .I %manpath_config_file%
 136 fichero de configuración de man-db.
 137 .TP
 138 .I /usr/man/index.(bt|db|dir|pag)
 139 Una base de datos temporal de
 140 .I índices
 141 tradicional.
 142 .TP
 143 .I /var/catman/index.(bt|db|dir|pag)
 144 Una base de datos temporal de
 145 .I índices
 146 alternativa o conforme al FSSTND.
 147 .SH "VÉASE TAMBIÉN"
 148 .BR %man% (1),
 149 .BR manpath (5),
 150 .BR %catman% (8).
 151 .SH AUTOR
 152 Wilf. (G.Wilford@ee.surrey.ac.uk)
 153 Traducción realizada por Enrique Zanardi (ezanardi@ull.es)