apropos [-dhV] [-e|-w|-r]
[-m sistema[,...]] [-M ruta]
palabra_clave ...
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.
- -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.
- 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.
- 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.
- /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 .
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).