WHATIS(1) Utilidades de paginador del manual WHATIS(1) NOMBRE whatis - muestra descripciones de una linea de las paginas de manual SINOPSIS whatis [-dlv?V] [-r|-w] [-s lista] [-m sistema[,...]] [-M ruta] [-L localizacion] [-C archivo] nombre ... DESCRIPCION Cada pagina de manual despone de una descripcion breve. whatis busca nombres de pagina de manual y muestra las descripciones de pagina de cualquier nombre coincidente. El nombre puede contener comodines (-w) o puede ser una expresion regular (-r). Con estas opciones puede ser necesario entrecomillar el nombre o escapar (\) los caracteres especiales para impedir que la shell los interprete. Durante la busqueda se utilizan bases de datos de indices y el programa mandb las actualiza. Dependiendo de su instalacion, esto lo ejecuta una tarea de cron periodica o puede ser que requiera ejecucion manual despues de instalar paginas de manual nuevas. Para generar una base de datos de whatis en texto al viejo estilo a partir de la base de datos de indices relativa, ejecute la orden: whatis -M rutaman -w '*' | sort > rutaman/whatis donde rutaman es una jerarquia de paginas de manual tal como /usr/man. OPCIONES -d, --debug Escribe informacion de depuracion. -v, --verbose Escribe mensajes detallados de advertencia. -r, --regex Interpreta cada nombre como una expresion regular. Si un nombre coincide con cualquier parte de un nombre de pagina, se da por satisfecha una coincidencia. Esta opcion ralentiza un poco whatis a causa de la naturaleza de las busquedas en base de datos. -w, --wildcard Interpreta cada nombre como un patron que contiene comodines de estilo shell. Para considerar una coincidencia, un nombre expandido debe coincidir con el nombre completo de pagina. Esta opcion ralentiza un poco whatis a causa de la naturaleza de las busquedas en base de datos. -l, --long No corta la salida a la anchura del terminal. Normalmente, la salida sera truncada al ancho del terminal para evitar resultados indeseables de las secciones de NOMBRE pobremente escritas. -s listado, --sections=listado, --section=listado Busca solo las secciones del manual indicadas. listado es una lista de secciones separadas por dos puntos o por comas. Si una entrada en el listado es una seccion simple, por ejemplo "3", entonces la lista de descripciones mostrada incluira paginas en las secciones "3", "3perl", "3x" y, asi, sucesivamente; mientras que si una entrada en el listado tiene una extension, por ejemplo, "3perl", entonces la lista solo incluira paginas en esa precisa parte de la seccion del manual. -m sistema[,...], --systems=sistema[,...] Si este sistema tiene acceso a los nombres de paginas de manual de otro sistema operativo, pueden consultarse utilizando esta opcion. Para consultar los nombres de paginas de manual del SOnuevo, utilice la opcion -m SOnuevo. El sistema especificado puede ser una combinacion de nombres de sistema operativo delimitados por comas. Para incluir una busqueda de los nombes de pagina de manual del sistema operativo nativo, incluya el nombre del sistema man en la cadena del argumento. Esta opcion anula la variable de entorno $SYSTEM. -M ruta, --manpath=ruta Especifica un conjunto alternativo de jerarquias de paginas de manual delimitadas por dos puntos (:) para busquedas. Por defecto, whatis utiliza la variable de entorno $MANPATH, a no ser que este vacia o no determinada, en cuyo caso determinara un manpath apropiado basado en su variable de entorno $PATH. Esta opcion anula el contenido de $MANPATH. -L local, --locale=local whatis normalmente determinara su localizacion actual mediante una llamada a la funcion C setlocale(3), la cual examina varias variables de entorno, posiblemente incluyendo $LC_MESSAGES y $LANG. Para anular temporalmente el valor determinado, utilice esta opcion para suministrar una cadena local directamente a whatis. Notese que no tendra efecto hasta que la busqueda de paginas realmente comience. Mensajes de salida como el de ayuda siempre se mostraran en la localizacion determinada inicialmente. -C archivo, --config-file=archivo Use this user configuration file rather than the default of ~/.manpath. -?, --help Escribe un mensaje de ayuda y termina. --usage Escribe mensaje breve sobre uso del programa y termina. -V, --version Muestra informacion sobre la version. ESTADO DE SALIDA 0 Ejecucion del programa correcta. 1 Error de uso, de sintaxis o del archivo de configuracion. 2 Error operacional. 16 No se ha encontrado nada que coincida con el criterio especificado. ENTORNO SYSTEM Si $SYSTEM esta establecida, tendra el mismo efecto que si se hubiera especificado como el argumento de la opcion -m. MANPATH Si $MANPATH esta establecida, su valor se interpreta como la ruta de busqueda de jerarquia de paginas de manual delimitadas por dos puntos. Vea la seccion RUTA DE BUSQUEDA de manpagh(5) para conocer el comportamiento predeterminado y los detalles acerca de como se utiliza esta variable de entorno. MANWIDTH Si $MANWIDTH esta establecida, su valor se utiliza como la anchura del terminal (vea la opcion --long). Si no esta establecida, la anchura del terminal se calculara utilizando el valor de $COLUMNS y ioctl(2) o, en su defecto, se toman 80 caracteres si falla todo lo demas. ARCHIVOS /usr/share/man/index.(bt|db|dir|pag) Una cache de BD de indexado global tradicional. /var/cache/man/index.(bt|db|dir|pag) Una cache de BD de indexado global compatible con FHS. /usr/share/man/.../whatis Una BD de texto whatis tradicional. VEASE TAMBIEN apropos(1), man(1), mandb(8) AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). DEFECTOS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 WHATIS(1)