.\" Man page for whatis
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man-db distribution.
.\"
.\" Sat Oct 29 13:09:31 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk) 
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WHATIS 1 2019-01-05 2.8.5 "Utilidades del paginador manual"
.SH NOMBRE
whatis \- enseña una línea de  descripciones de páginas de manuales
conectadas
.SH SINOPSIS
\fBwhatis\fP [\|\fB\-dlv?V\fP\|] [\|\fB\-r\fP\||\|\fB\-w\fP\|] [\|\fB\-s\fP \fIlistado\fP\|]
[\|\fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fIruta\fP\|] [\|\fB\-L\fP
\fIlocalización\fP\|] [\|\fB\-C\fP \fIfichero\fP\|] \fInombre\fP \&.\|.\|.
.SH DESCRIPCIÓN
Cada página de manual tienen una descripción breve disponible dentro de
ésta.  \fBwhatis\fP busca nombres de página del manual y enseña la página del
manual descrita de cualquier \fInombre\fP coincidente.

El \fInombre\fP quIzá contiene comodines (\fB\-w\fP)  o es una expresión regular
(\fB\-r\fP).  Utilizando estas opciones, quizá es necesario para entrecomillar
el \fInombre\fP o escapar (\e) los caracteres especiales para detener la shell
desde interpretación de éstas.

\fBindexa\fP bases de datos son empladas durante la búsqueda, y son
actualizadas por el programa \fBmandb\fP.  Dependiendo en su instalación,
esto quizá está ejecutado por una tarea cronometrada, o quizá requiere ser
ejecutado manualmente páginas del manual nuevas que han sido instaladas.
Para producir un texto de estilo antiguo \fBque sea\fP base de datos desde la
\fBindexación\fP relativa a la base de datos, efectúe la orden:

\fBwhatis \-M\fP \fIrutaman\fP \fB\-w '*' | sort >\fP \fImanpath/whatis\fP

donde \fIrutaman\fP es una página del manual jerárquica tal como \fI/usr/man\fP.
.SH OPCIONES
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
Muestra información depurativa.
.TP 
.if  !'po4a'hide' .BR \-v ", " \-\-verbose
Muestra mensajes detallados de advertencia.
.TP 
.if  !'po4a'hide' .BR \-r ", " \-\-regex
Interpret each \fIname\fP as a regular expression.  If a \fIname\fP matches any
part of a page name, a match will be made.  This option causes \fBwhatis\fP
to be somewhat slower due to the nature of database searches.
.TP 
.if  !'po4a'hide' .BR \-w ", " \-\-wildcard
Interpreta cada \fInombre\fP como un patrón conteniendo comodines de estilo
shell.  Para una coincidencia a ser hecha, un \fInombre\fP expandido debe
coincidir con el nombre completo de página.  Esta opción causa que
\fBwhatis\fP sea algomás lento que hacerlo naturalmente en búsqueda de base
de datos.
.TP 
.if  !'po4a'hide' .BR \-l ", " \-\-long
No corta la salida a la anchura del terminal.  Normalmente, la salida será
truncada al ancho del terminal para evitar resultados indeseables de las
secciones de \fBNOMBRE\fP pobremente escritas.
.TP 
\fB\-s\fP \fIlistado\fP, \fB\-\-section\fP \fIlistado\fP, \fB\-\-section\fP \fIlistado\fP
.\"
.\" Due to the rather silly limit of 6 args per request in some `native'
.\" *roff compilers, we have do the following to get the two-line
.\" hanging tag on one line. .PP to begin a new paragraph, then the
.\" tag, then .RS (start relative indent), the text, finally .RE
.\" (end relative indent).
.\"
Busca solo las secciones del manual dadas.  \fIlistado\fP es una lista de
secciones coloreada separadas por comas.  Si una entrada en el \fIlistado\fP es
una sección simple, por ejemplo "3", entonces la lista de descripción
enseñada incluirá páginas en secciones "3", "3perl", "3x", y así; mientras
si una entrada en el \fIlistado\fP tiene una extensión, por ejemplo "3perl",
entones la lista solo incluirá páginas dentro de esa parte exacta de la
sección del manual.
.PP
\fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIsistema\fP\|[\|,.\|.\|.\|]
.RS
If this system has access to other operating system's manual page names,
they can be accessed using this option.  To search NewOS's manual page
names, use the option \fB\-m\fP \fBNewOS\fP.

The \fIsystem\fP specified can be a combination of comma delimited operating
system names.  To include a search of the native operating system's manual
page names, include the system name \fBman\fP in the argument string.  This
option will override the $\fBSYSTEM\fP environment variable.
.RE
.TP 
\fB\-M\ \fP\fIruta\fP,\ \fB\-\-manpath=\fP\fIruta\fP
Especifica un conjunto alternativo de página del manual delimitado por dos
puntos (:) jerárquicos para búsqueda.  Por defecto, \fBwhatis\fP utiliza la
variable de entorno $\fBMANPATH\fP, a no ser que esté vacía o no determinada,
en cualquier caso determinará una ruta del man apropiado basado en su
variable del entorno $\fBMANPATH\fP.
.TP 
\fB\-L\ \fP\fIlocal\fP,\ \fB\-\-locale=\fP\fIlocal\fP
El \fB%programa%\fP normalmente no determinará su actual localización para una
llamada a la función C \fBsetlocale\fP(3)  la cual pregunta varias variables de
entorno, posiblemente incluyendo $\fBLC_MESSAGES\fP y $\fBLANG\fP.  Para
temporalmente sobrescribir el valor determinado, utilice esta opción para
suministrar una cadena \fIlocal\fP directamente al \fBwhatis\fP.  Anote que no
tomará efecto hasta que la búsqueda para páginas actualmente comiencen.
Salidas como el mensaje de ayuda siempre será mostrado en la localización
inicialmente determinada.
.TP 
\fB\-C\ \fP\fIfichero\fP,\ \fB\-\-config\-file=\fP\fIfichero\fP
Utilice este fichero de configuracion de usuario mejor que el predeterminado
de \fI~/.manpath\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
Escribe un mensaje de ayuda y termina.
.TP 
.if  !'po4a'hide' .BR \-\-usage
Escribe mensaje breve sobre uso del programa y termina.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
Enseña la versión de información.
.SH "ESTADO DE SALIDA"
.TP 
.if  !'po4a'hide' .B 0
Ejecución del programa correcta.
.TP 
.if  !'po4a'hide' .B 1
Utilización, sintaxis o error del fichero de configuración.
.TP 
.if  !'po4a'hide' .B 2
Error operacional.
.TP 
.if  !'po4a'hide' .B 16
Nada fue encontrado coincidendo con el criterio especificado.
.SH ENTORNO
.TP 
.if  !'po4a'hide' .B SYSTEM
Si se establece $\fBSYSTEM\fP, tendrá el mismo efecto que si tuvo que ser
especificado como el argumento a la opción \fB\-m\fP.
.TP 
.if  !'po4a'hide' .B MANPATH
Si se establece $\fBMANPATH\fP, su valor es interpretado como la jerarquización
de página manual delimitada por dos puntos.
.TP 
.if  !'po4a'hide' .B MANWIDTH
Si se establece $\fBMANWIDTH\fP, su valor es utilizado como la anchura del
terminal (vea la opción \fB\-\-long\fP).  Si no está establecida, la anchura de
la terminal será calculada utilizando el valor de  $\fBCOLUMNAS\fP, un
\fBioctl\fP(2) si está disponible, o volviendo a los 80 caracteres si todo eso
falla.
.SH FICHEROS
.TP 
.if  !'po4a'hide' .I /usr/share/man/index.(bt|db|dir|pag)
Una caché de BD \fIindexado\fP global tradicional.
.TP 
.if  !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag)
Una caché de BD \fIindexado\fP compatible FHS.
.TP 
.if  !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis
Un texto tradicional \fBwhatis\fP de BD.
.SH "VEA ADEMÁS"
.if  !'po4a'hide' .BR apropos (1),
.if  !'po4a'hide' .BR man (1),
.if  !'po4a'hide' .BR mandb (8)
.SH AUTOR
.nf
.if  !'po4a'hide' Wilf. (G.Wilford@ee.surrey.ac.uk).
.if  !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi