man/es/man1/whatis.man1

   1 .\" Man page for whatis
   2 .\"
   3 .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
   4 .\"
   5 .\" You may distribute under the terms of the GNU General Public
   6 .\" License as specified in the file COPYING that comes with the
   7 .\" man-db distribution.
   8 .\"
   9 .\" Sat Oct 29 13:09:31 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
  10 .\"
  11 .TH %thwhatis% 1 "%date%" "%version%" "Útiles de Páginas de Manual"
  12 .SH NOMBRE
  13 %whatis% \- imprime descripciones de páginas de manual
  14 .SH SINOPSIS
  15 .B %whatis%
  16 .RB [\| \-dhV \|]
  17 .RB [\| \-r \||\| \-w\c
  18 \|]
  19 .RB [\| \-m
  20 .IR sistema \|[\|,.\|.\|.\|]\|]
  21 .RB [\| \-M
  22 .IR ruta \|]
  23 .I nombre
  24 \&.\|.\|.
  25 .SH DESCRIPCIÓN
  26 Cada página de manual contiene una pequeña descripción.
  27 .B %whatis%
  28 realiza una búsqueda entre los nombres de las páginas de manual,
  29 mostrando aquellos que se asemejen al
  30 .I nombre
  31 dado.
  32
  33 .I nombre
  34 puede contener caracteres comodín
  35 .RB ( \-w )
  36 o puede tratarse de una expresión regular
  37 .RB ( \-r ).
  38 Si se usa una de estas opciones,
  39 puede resultar necesario entrecomillar el
  40 .I nombre
  41 o anteponer `\\' a dichos caracteres para evitar que el intérprete de
  42 órdenes los sustituya.
  43
  44 Las bases de datos
  45 .B índices
  46 son usadas durante la búsqueda.
  47 Para generar una base de datos
  48 .B whatis
  49 antigua tipo texto de la base
  50 .B index
  51 índice, basta usar la orden:
  52
  53 .B %whatis% \-M
  54 .I ruta_de_manual
  55 .B \-w  '*' | sort >
  56 .I ruta_de_manual/whatis
  57
  58 donde
  59 .I ruta_de_manual
  60 es una jerarquía de páginas de manual como, por ejemplo,
  61 .IR /usr/man .
  62 .SH OPCIONES
  63 .TP
  64 .B \-d, \-\-debug
  65 Imprime información de depurado.
  66 .TP
  67 .B \-r, \-\-regex
  68 Interpreta cada
  69 .I nombre
  70 como una expresión regular.
  71 Si un
  72 .I nombre
  73 se asemeja a cualquier parte del nombre de una página, se interpretará como
  74 una identificación positiva.
  75 Esta opción hace que
  76 .B %whatis%
  77 funcione algo más lento dada la naturaleza de las búsquedas en
  78 bases de datos.
  79 .TP
  80 .B \-w, \-\-wildcard
  81 Interpreta cada
  82 .I nombre
  83 como un patrón que contiene caracteres comodín al estílo del
  84 intérprete de órdenes.
  85 Para que se produzca una identificación positiva, el
  86 .I nombre
  87 expandido debe corresponder al nombre de la página completo.
  88 Esta opción hace que
  89 .B %whatis%
  90 funcione algo más lento dada la naturaleza de las búsquedas en bases de datos.
  91
  92 .\"
  93 .\" Due to the rather silly limit of 6 args per request in some `native'
  94 .\" *roff compilers, we have do the following to get the two-line
  95 .\" hanging tag on one line. .PP to begin a new paragraph, then the
  96 .\" tag, then .RS (start relative indent), the text, finally .RE
  97 .\" (end relative indent).
  98 .\"
  99 .PP
 100 .B \-m
 101 .I sistema\c
 102 .RB \|[\|,.\|.\|.\|]\| ,
 103 .BI \-\-systems= sistema\c
 104 \|[\|,.\|.\|.\|]
 105 .RS
 106 Si este sistema tiene acceso a los nombres de páginas del manual de otro
 107 sistema operativo, se puede acceder a ellos mediante esta opción.
 108 Para buscar entre las páginas de NuevoSO,
 109 use la opción
 110 .B \-m
 111 .BR NuevoSO .
 112
 113 El
 114 .I sistema
 115 especificado puede en realidad ser una combinación de nombres de
 116 sistemas operativos separados por "comas".
 117
 118 Para incluir en la búsqueda las páginas del sistema operativo nativo,
 119 incluya el nombre de sistema
 120 .B man
 121 en la cadena de argumentos.
 122 El valor dado en esta opción es utlizado por el sistema en lugar
 123 de la variable del entorno
 124 .RB $ SYSTEM .
 125 .RE
 126 .TP
 127 .BI \-M\  ruta ,\ \-\-manpath= ruta
 128 Especifica un conjunto de jerarquías de páginas de manual delimitado
 129 por "dos puntos" en el que se realizará la búsqueda.
 130 Por defecto,
 131 .B %apropos%
 132 usa la variable de entorno
 133 .RB $ MANPATH
 134 a menos que ésta esté vacía o desactivada, en cuyo caso se determinará la
 135 ruta de manual apropiada en base al contenido de la variable de entorno
 136 .RB $ PATH .
 137 El valor dado en esta opción es utlizado por el sistema en lugar
 138 de la variable del entorno
 139 .RB $ MANPATH .
 140 .TP
 141 .B \-h, \-\-help
 142 Imprime un mensaje de ayuda y termina.
 143 .TP
 144 .B \-V, \-\-version
 145 Presenta la información sobre el autor y la versión.
 146 .SH "ESTADO DE SALIDA"
 147 .TP
 148 .B 0
 149 La ejecución del programa ha terminado con éxito.
 150 .TP
 151 .B 1
 152 Error de uso, sintaxis o del fichero de configuración.
 153 .TP
 154 .B 2
 155 Error operacional.
 156 .TP
 157 .B 16
 158 No se han encontrado páginas de manual que se asemejen a los
 159 criterios especificados.
 160 .SH ENTORNO
 161 .TP
 162 .B SYSTEM
 163 Si la variable
 164 .RB $ SYSTEM
 165 está activa, tendrá el mismo efecto que si su contenido hubiese sido usado
 166 como argumento con la opción
 167 .B \-m .
 168 .TP
 169 .B MANPATH
 170 Si la variable
 171 .RB $ MANPATH
 172 está activa, su valor se interpreta como la lista de sucesivas
 173 jerarquías de páginas de manual separadas por "dos puntos",
 174 que se usará en la búsqueda.
 175 .SH FICHEROS
 176 .TP
 177 .I /usr/man/index.(bt|db|dir|pag)
 178 .I Índice
 179 tradicional global del caché de la base de datos.
 180 .TP
 181 .I /var/catman/index.(bt|db|dir|pag)
 182 .I Índice
 183 global alternativo o de acuerdo al FSSTND del caché de la base de datos.
 184
 185 .TP
 186 .I /usr/man/\|.\|.\|.\|/whatis
 187 Base de datos
 188 .B whatis
 189 tradicional tipo texto.
 190 .SH "VÉASE TAMBIÉN"
 191 .BR %apropos% (1),
 192 .BR %man% (1).
 193 .SH AUTOR
 194 Wilf. (G.Wilford@ee.surrey.ac.uk)
 195 Traducción realizada por Luis F. González (luisgh@cogs.susx.ac.uk)