Provided by: man-db_2.5.7-4_i386 bug

NOMBRE

       whatis - imprime descripciones de pginas de manual

SINOPSIS

       whatis [-dhV] [-r|-w] [-m sistema[,...]] [-M ruta] nombre ...

DESCRIPCIN

       Cada  pgina  de  manual contiene una pequea descripcin.  whatis realiza
       una bsqueda entre los  nombres  de  las  pginas  de  manual,  mostrando
       aquellos que se asemejen al nombre dado.

       nombre  puede  contener  caracteres comodn (-w) o puede tratarse de una
       expresin regular (-r).  Si se usa una de estas opciones, puede resultar
       necesario  entrecomillar  el nombre o anteponer `\' a dichos caracteres
       para evitar que el intrprete de rdenes los sustituya.

       Las bases de datos ndices son usadas durante la bsqueda.  Para  generar
       una  base  de  datos  whatis antigua tipo texto de la base index ndice,
       basta usar la orden:

       whatis -M ruta_de_manual -w '*' | sort > ruta_de_manual/whatis

       donde ruta_de_manual es una jerarqua de  pginas  de  manual  como,  por
       ejemplo, /usr/man.

OPCIONES

       -d, --debug
              Imprime informacin de depurado.

       -r, --regex
              Interpreta  cada nombre como una expresin regular.  Si un nombre
              se asemeja a  cualquier  parte  del  nombre  de  una  pgina,  se
              interpretar  como  una  identificacin positiva.  Esta opcin hace
              que whatis funcione algo ms lento  dada  la  naturaleza  de  las
              bsquedas en bases de datos.

       -w, --wildcard
              Interpreta  cada  nombre  como  un patrn que contiene caracteres
              comodn al estlo del intrprete de rdenes.  Para que  se  produzca
              una   identificacin   positiva,   el   nombre   expandido   debe
              corresponder al nombre de la pgina completo.   Esta  opcin  hace
              que  whatis  funcione  algo  ms  lento dada la naturaleza de las
              bsquedas en bases de datos.

       -m sistema[,...], --systems=sistema[,...]
              Si este sistema tiene acceso a los nombres de pginas del  manual
              de  otro  sistema  operativo,  se puede acceder a ellos mediante
              esta opcin.  Para buscar entre las pginas  de  NuevoSO,  use  la
              opcin -m NuevoSO.

              El  sistema especificado puede en realidad ser una combinacin de
              nombres de sistemas operativos separados por "comas".

              Para incluir en la bsqueda  las  pginas  del  sistema  operativo
              nativo,  incluya  el  nombre  de  sistema  man  en  la cadena de
              argumentos.  El valor dado en esta  opcin  es  utlizado  por  el
              sistema en lugar de la variable del entorno $SYSTEM.

       -M ruta, --manpath=ruta
              Especifica   un  conjunto  de  jerarquas  de  pginas  de  manual
              delimitado por "dos puntos" en el que se  realizar  la  bsqueda.
              Por defecto, apropos usa la variable de entorno $MANPATH a menos
              que sta est vaca o desactivada, en cuyo caso  se  determinar  la
              ruta  de manual apropiada en base al contenido de la variable de
              entorno $PATH.  El valor dado en esta opcin es utlizado  por  el
              sistema en lugar de la variable del entorno $MANPATH.

       -h, --help
              Imprime un mensaje de ayuda y termina.

       -V, --version
              Presenta la informacin sobre el autor y la versin.

ESTADO DE SALIDA

       0      La ejecucin del programa ha terminado con xito.

       1      Error de uso, sintaxis o del fichero de configuracin.

       2      Error operacional.

       16     No  se  han  encontrado  pginas  de manual que se asemejen a los
              criterios especificados.

ENTORNO

       SYSTEM Si la variable $SYSTEM est activa, tendr el mismo efecto que  si
              su contenido hubiese sido usado como argumento con la opcin -m .

       MANPATH
              Si la variable $MANPATH est activa, su valor se interpreta  como
              la  lista  de  sucesivas jerarquas de pginas de manual separadas
              por "dos puntos", que se usar en la bsqueda.

FICHEROS

       /usr/man/index.(bt|db|dir|pag)
              ndice tradicional global del cach de la base de datos.

       /var/catman/index.(bt|db|dir|pag)
              ndice global alternativo o de acuerdo al FSSTND del cach  de  la
              base de datos.

       /usr/man/.../whatis
              Base de datos whatis tradicional tipo texto.

VASE TAMBIN

       apropos(1), man(1).

AUTOR

       Wilf.  (G.Wilford@ee.surrey.ac.uk)  Traduccin  realizada  por  Luis  F.
       Gonzlez (luisgh@cogs.susx.ac.uk)