241 lines
8.4 KiB
HTML
241 lines
8.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of WHATIS</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>WHATIS</H1>
|
|
Section: Utilidades del paginador del manual (1)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOMBRE</H2>
|
|
|
|
whatis - muestra descripciones de una línea de las páginas de manual
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SINOPSIS</H2>
|
|
|
|
<B>whatis</B> [<B>-dlv?V</B>] [<B>-r</B>|<B>-w</B>] [<B>-s</B> <I>lista</I>]
|
|
[<B>-m</B> <I>sistema</I>[,...]] [<B>-M</B> <I>ruta</I>] [<B>-L</B>
|
|
<I>localización</I>] [<B>-C</B> <I>fichero</I>] <I>nombre</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPCIÓN</H2>
|
|
|
|
Cada página de manual despone de una descripción breve. <B>whatis</B> busca
|
|
nombres de página de manual y muestra las descripciones de página de
|
|
cualquier <I>nombre</I> coincidente.
|
|
<P>
|
|
El <I>nombre</I> puede contener comodines (<B>-w</B>) o puede ser una expresión
|
|
regular (<B>-r</B>). Con estas opciones puede ser necesario entrecomillar el
|
|
<I>nombre</I> o escapar (\) los caracteres especiales para impedir que la shell
|
|
los interprete.
|
|
<P>
|
|
Durante la búsqueda se utilizan bases de datos de <B>índices</B> y el programa
|
|
<B>mandb</B> las actualiza. Dependiendo de su instalación, esto lo ejecuta
|
|
una tarea de cron periódica o puede ser que requiera ejecución manual
|
|
después de instalar páginas de manual nuevas. Para generar un texto al
|
|
viejo estilo de la base de datos de <B>whatis</B> desde la base de datos de
|
|
<B>índices</B> relativa, ejecute la orden:
|
|
<P>
|
|
<B>whatis -M</B> <I>rutaman</I> <B>-w '*' | sort ></B> <I>rutaman/whatis</I>
|
|
<P>
|
|
donde <I>rutaman</I> es una jerarquía de páginas de manual tal como <I>/usr/man</I>.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPCIONES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Escribe información de depuración.
|
|
<DT id="2"><B>-v</B>, <B>--verbose</B>
|
|
|
|
|
|
<DD>
|
|
Escribe mensajes detallados de advertencia.
|
|
<DT id="3"><B>-r</B>, <B>--regex</B>
|
|
|
|
|
|
<DD>
|
|
Interpreta cada <I>nombre</I> como una expresión regular. Si un <I>nombre</I>
|
|
coincide con cualquier parte de un nombre de página, se da por satisfecha
|
|
una coincidencia. Esta opción ralentiza un poco <B>whatis</B> a causa de la
|
|
naturaleza de las búsquedas en base de datos.
|
|
<DT id="4"><B>-w</B>, <B>--wildcard</B>
|
|
|
|
|
|
<DD>
|
|
Interpreta cada <I>nombre</I> como un patrón que contiene comodines de estilo
|
|
shell. Para considerar una coincidencia, un <I>nombre</I> expandido debe
|
|
coincidir con el nombre completo de página. Esta opción ralentiza un poco
|
|
<B>whatis</B> a causa de la naturaleza de las búsquedas en base de datos.
|
|
<DT id="5"><B>-l</B>, <B>--long</B>
|
|
|
|
|
|
<DD>
|
|
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 <B>NOMBRE</B> pobremente escritas.
|
|
<DT id="6"><B>-s</B> <I>listado/</I>, <B>--sections=</B><I>listado/</I>, <B>--section=</B><I>listado</I><DD>
|
|
Busca solo las secciones del manual indicadas. <I>listado</I> es una lista de
|
|
secciones separadas por dos puntos o por comas. Si una entrada en el
|
|
<I>listado</I> es una sección simple, por ejemplo "3", entonces la lista de
|
|
descripciones mostrada incluirá páginas en las secciones "3", "3perl", "3x"
|
|
y, así, sucesivamente; mientras que si una entrada en el <I>listado</I> tiene
|
|
una extensión, por ejemplo, "3perl", entonces la lista solo incluirá páginas
|
|
en esa precisa parte de la sección del manual.
|
|
<DT id="7"><B>-m</B> <I>sistema</I>[,...], <B>--systems=</B><I>sistema</I>[,...]<DD>
|
|
Si este sistema tiene acceso a otros nombres de página de manual del sistema
|
|
operativo, pueden ser accedidas utilizando esta opción. Para buscar nombres
|
|
de página de manual del SOnuevo, utilice la opción <B>-m</B> <B>SOnuevo</B>.
|
|
<P>
|
|
El <I>sistema</I> especificado puede ser una combinación de nombres de sistema
|
|
operativo delimitados por comas. Para incluir una búsqueda de los nombes de
|
|
página de manual del sistema operativo nativo, incluya el nombre del sistema
|
|
<B>man</B> en la cadena del argumento. Esta opción anula la variable de entorno
|
|
$<B>SYSTEM</B>.
|
|
<DT id="8"><B>-M </B><I>ruta</I>, <B>--manpath=</B><I>ruta</I><DD>
|
|
Especifica un conjunto alternativo de jerarquías de páginas de manual
|
|
delimitadas por dos puntos (:) para búsquedas. Por defecto, <B>whatis</B>
|
|
utiliza la variable de entorno $<B>MANPATH</B>, a no ser que esté vacía o no
|
|
determinada, en cuyo caso determinará un manpath apropiado basado en su
|
|
variable de entorno $<B>PATH</B>. Esta opción anula el contenido de
|
|
$<B>MANPATH</B>.
|
|
<DT id="9"><B>-L </B><I>local</I>, <B>--locale=</B><I>local</I><DD>
|
|
<B>whatis</B> normalmente determinará su localización actual mediante una
|
|
llamada a la función C <B><A HREF="/cgi-bin/man/man2html?3+setlocale">setlocale</A></B>(3), la cual examina varias variables de
|
|
entorno, posiblemente incluyendo $<B>LC_MESSAGES</B> y $<B>LANG</B>. Para anular
|
|
temporalmente el valor determinado, utilice esta opción para suministrar una
|
|
cadena <I>local</I> directamente a <B>whatis</B>. Nótese que no tendrá efecto
|
|
hasta que la búsqueda de páginas realmente comience. Mensajes de salida
|
|
como el de ayuda siempre se mostrarán en la localización determinada
|
|
inicialmente.
|
|
<DT id="10"><B>-C </B><I>fichero</I>, <B>--config-file=</B><I>fichero</I><DD>
|
|
Utilice este fichero de configuracion de usuario en lugar del predeterminado
|
|
según <I>~/.manpath</I>.
|
|
<DT id="11"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Escribe un mensaje de ayuda y termina.
|
|
<DT id="12"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
Escribe mensaje breve sobre uso del programa y termina.
|
|
<DT id="13"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Muestra información sobre la versión.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ESTADO DE SALIDA</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
Ejecución del programa correcta.
|
|
<DT id="15"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Error de uso, de sintaxis o del fichero de configuración.
|
|
<DT id="16"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
Error operacional.
|
|
<DT id="17"><B>16</B>
|
|
|
|
|
|
<DD>
|
|
No se ha encontrado nada que coincida con el criterio especificado.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENTORNO</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="18"><B>SYSTEM</B>
|
|
|
|
|
|
<DD>
|
|
Si se establece $<B>SYSTEM</B>, tendrá el mismo efecto que si se hubiera
|
|
especificado como el argumento de la opción <B>-m</B>.
|
|
<DT id="19"><B>MANPATH</B>
|
|
|
|
|
|
<DD>
|
|
Si se establece $<B>MANPATH</B>, su valor se interpreta como la ruta de búsqueda
|
|
de jerarquía de páginas de manual delimitadas por dos puntos.
|
|
<DT id="20"><B>MANWIDTH</B>
|
|
|
|
|
|
<DD>
|
|
Si se establece $<B>MANWIDTH</B>, su valor se utiliza como la anchura del
|
|
terminal (vea la opción <B>--long</B>). Si no está establecida, la anchura del
|
|
terminal se calculará utilizando el valor de $<B>COLUMNS</B> y <B><A HREF="/cgi-bin/man/man2html?2+ioctl">ioctl</A></B>(2) o, en
|
|
su defecto, se toman 80 caracteres si falla todo lo demás.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>FICHEROS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="21"><I>/usr/share/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Una caché de BD <I>indexada</I> global tradicional.
|
|
<DT id="22"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Una caché de BD <I>indexado</I> compatible con FHS.
|
|
<DT id="23"><I>/usr/share/man/.../whatis</I>
|
|
|
|
|
|
<DD>
|
|
Una base de datos de texto <B>whatis</B> tradicional.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>VÉASE TAMBIÉN</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></B>(8)
|
|
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTOR</H2>
|
|
|
|
<PRE>
|
|
Wilf. (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>).Fabrizio Polacco (<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>).Colin Watson (<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>).</PRE>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="24"><A HREF="#lbAB">NOMBRE</A><DD>
|
|
<DT id="25"><A HREF="#lbAC">SINOPSIS</A><DD>
|
|
<DT id="26"><A HREF="#lbAD">DESCRIPCIÓN</A><DD>
|
|
<DT id="27"><A HREF="#lbAE">OPCIONES</A><DD>
|
|
<DT id="28"><A HREF="#lbAF">ESTADO DE SALIDA</A><DD>
|
|
<DT id="29"><A HREF="#lbAG">ENTORNO</A><DD>
|
|
<DT id="30"><A HREF="#lbAH">FICHEROS</A><DD>
|
|
<DT id="31"><A HREF="#lbAI">VÉASE TAMBIÉN</A><DD>
|
|
<DT id="32"><A HREF="#lbAJ">AUTOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:04:59 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|