whatis(s)           tiles de Pginas de Manual           whatis(s)



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_man-
       ual/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  nom-
              bre de una pgina, se interpretar como una identifi-
              cacin positiva.  Esta opcin hace  que  whatis  fun-
              cione  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  fun-
              cione  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  pgi-
              nas  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 sepa-
              rados 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 configu-
              racin.

       2      Error operacional.

       16     No se han encontrado pginas de manual que se aseme-
              jen 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(s), man(n).

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



2.3.20                  07 September 2001               whatis(s)