NOMBRE

       apropos - buscar entre las páginas del manual y las descripciones

SINOPSIS

       apropos [-dhV] [-e|-w|-r] [-m sistema[,...]] [-M ruta] palabra_clave ...

DESCRIPCIÓN

       Cada  página  de  manual  contiene  una pequeña descripción.  apropos busca dentro de esas
       descripciones la presencia de la palabra_clave.

       La palabra_clave es normalmente una expresión regular, como si se  hubiese  usado  (-r)  ,
       puede  contener  caracteres comodín (-w) , o ser la palabra clave exacta (-e)  . Cuando se
       usan estas opciones, puede ser necesario entrecomillar la palabra_clave o anteponer (\)  a
       los caracteres especiales para evitar que la shell los interprete.

       Las reglas estándar permiten buscar en nombres de página y en las palabras completas de la
       descripción de cada página.

OPCIONES

       -d, --debug
              Imprime información de depuración.

       -r, --regex
              Interpreta cada palabra clave como una expresión regular. Este comportamiento es el
              predeterminado.  Cada  palabra  clave se comparará con los nombres de las páginas y
              con las descripciones de forma independiente. La comparación puede tener éxito  con
              cualquier  parte  de  ellas.  La  comparación  no tiene por qué comprender palabras
              completas, sino también partes de ellas.

       -w, --wildcard
              Interpreta cada palabra clave como un patrón que  incluye  caracteres  comodín  del
              estilo  de la shell. Cada palabra clave se comparará con los nombres de las páginas
              y con las descripciones de forma independiente. La comparación sólo tendrá éxito si
              la  palabra  clave  una vez expandida corresponde con una descripción completa o un
              nombre de página.

       -e, --exact
              Cada palabra clave se comparará de forma exacta con los nombres de  páginas  y  las
              descripciones.

       -m sistema[,...], --systems=sistema[,...]
              Si este sistema puede acceder a las páginas de manual de otro sistema operativo, se
              puede activar su búsqueda mediante esta opción.  Para  buscar  en  las  páginas  de
              NuevoSO, use la opción -m NuevoSO.

              El  sistema  especificado  puede  ser  en realidad una lista separada por comas, de
              nombres de sistemas operativos.  Para incluir la base  de  datos  de  descripciones
              whatis del sistema operativo nativo en la búsqueda basta incluir man como nombre de
              sistema en la lista de argumentos.  Esta opción hace que se ignore el contenido  de
              la variable de entorno $SYSTEM.

       -M ruta, --manpath=ruta
              Especifica  un  conjunto  de  jerarquías  de  páginas  de manual separados por "dos
              puntos".  Por defecto, apropos utiliza la variable de entorno $MANPATH a menos  que
              esté vacía o no exista, en cuyo caso determinará la ruta para las páginas de manual
              apropiadas basándose en su variable de entorno $PATH.   Esta  opción  hace  que  se
              ignore el contenido de la variable de entorno $MANPATH.

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

       -V, --version
              Presenta la información sobre la version y el autor.

ESTADO DE SALIDA

       0      Ejecución terminada con éxito.

       1      Error de uso, sintaxis o de fichero de configuración.

       2      Error operacional.

       16     No se ha encontrado nada que cuadre con los criterios especificados.

ENTORNO

       SYSTEM Si existe $SYSTEM, tendrá el mismo efecto que si se especifica su contenido como el
              argumento de la opción -m  .

       MANPATH
              Si existe $MANPATH, su valor es interpretado como la ruta al conjunto de jerarquías
              de páginas a usar separadas por "dos puntos".

       POSIXLY_CORRECT
              Si  $POSIXLY_CORRECT  existe,  incluso  si  su valor es nulo, apropos realizará por
              defecto una búsqueda como expresión regular (-r).  De  todas  formas,  este  es  el
              comportamiento predeterminado actualmente.

FICHEROS

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

       /var/cache/man/index.(bt|db|dir|pag)
              Índice alternativo o de acuerdo con el FHS del caché de la base de datos global.

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

VÉASE TAMBIÉN

       whatis(1), man(1).

AUTOR

       Wilf. (G.Wilford@ee.surrey.ac.uk)
       Fabrizio Polacco (fpolacco@debian.org).
       Traducción realizada por Luis F. González (luisgh@cogs.susx.ac.uk), y
       revisada por David Martínez (ender@adi.uam.es).