WHATIS(1) Utilidades do paginador do manual WHATIS(1) NOME whatis - mostra descricoes das paginas do manual numa linha SINOPSE whatis [-dlv?V] [-r|-w] [-s lista] [-m sistema[,...]] [-M caminho] [-L idioma] [-C ficheiro] nome ... DESCRICAO Cada pagina do manual tem em si uma breve descricao. O whatis procura os nomes das paginas do manual e mostra as descricoes, caso encontre algum nome. O nome pode conter caracteres universais (-w) ou ser uma expressao regular (-r). Se usar estas opcoes, podera ser necessario por o nome entre aspas ou escapar (\) os caracteres especiais para impedir que a shell os interprete. Durante a procura, sao usadas bases de dados de indice e sao actualizadas pelo programa mandb. Dependendo da sua instalacao, isto pode ser executado por uma tarefa cron periodica, ou pode ter de ser manualmente excutado apos a instalacao de novas paginas do manual. Para produzir umbase de dados whatis em texto de estilo antigo a partir da base de dados de indice relativa, emita o comando: whatis -M manpath -w '*' | sort > manpath/whatis onde manpath e uma hierarquia de paginas do manual, tal como /usr/man. OPCOES -d, --debug imprime informacao de depuracao. -v, --verbose imprime avisos verbosos. -r, --regex Interpreta cada nome como uma expressao regular. Se um nome corresponder a qualquer parte de um nome de pagina, sera feita uma correspondencia. Esta opcao faz com que o whatis seja algo mais lento devido a natureza das bases de dados de procura. -w, --wildcard Interpreta cada nome como um padrao contendo caracteres universais ao estilo da shell. Para que haja uma correspondencia, um nome expandido tem de corresponder a todo o nome da pagina. Esta opcao faz com que o whatis seja algo mais lento devido a natureza das base de dados de procura. -l, --long nao corta a saida para a largura do terminal. Normalmente, isto e feito para evitar resultados muito feios de seccoes NOME mal escritas. -s lista, --sections=lista, --section=lista procura so as seccoes do manual indicadas. lista e uma lista de seccoes separadas por dois-pontos ou virgula. Se uma entrada em lista for uma seccao simples, por exemplo, "3", a lista de descricoes mostrada incluira paginas nas seccoes "3", "3perl", "3x" e assim por diante; enquanto se uma entrada em lista tiver uma extensao, por exemplo "3perl", a lista incluira so paginas nessa parte exacta da seccao do manual. -m sistema[,...], --systems=sistema[,...] If this system has access to other operating systems' manual page names, they can be accessed using this option. To search NewOS's manual page names, use the option -m NewOS. O sistema especificado pode ser uma combinacao de nomes de sistemas operativos, separados por virgulas. Para incluir uma procura de nomes de paginas do manual do sistema nativo, o nome de sistema man tem de estar incluido na cadeia de argumentos. Esta opcao sobrepoe-se a variavel de ambiente $SYSTEM. -M caminho, --manpath=caminho Especifique um conjunto alternativo de hierarquias de paginas de manual delimitadas por dois-pontos para procurar. Por predefinicao, whatis usa a variavel de ambiente $MANPATH, a menos que esteja vazia ou indefinida, caso em que determinara um manpath apropriado com base na variavel de ambiente $PATH. Esta opcao sobrescreve o conteudo de $MANPATH. -L idioma, --locale=idioma O whatis normalmente determinara sua localidade actual por uma chamada a funcao C setlocale(3), que interroga varias variaveis de ambiente, possivelmente incluindo $LC_MESSAGES e $LANG. Para sobrepor temporariamente o valor determinado, use esta opcao para fornecer uma cadeia idioma directamente a whatis. Note que isto nao tera efeito ate que a procura por paginas realmente comece. Saidas como a mensagem de ajuda serao sempre mostradas no idioma inicialmente determinado. -C ficheiro, --config-file=ficheiro Use this user configuration file rather than the default of ~/.manpath. -?, --help mostra uma mensagem de ajuda e sai. --usage mostra uma mensagem curta de uso e sai. -V, --version mostra informacao da versao. ESTADO DE SAIDA 0 Execucao de programa com sucesso. 1 Erro de uso, sintaxe ou ficheiro de configuracao. 2 Erro de operacao. 16 Nada encontrado que cumpra o criterio especificado. AMBIENTE SYSTEM Se $SYSTEM estiver definido, tera o mesmo efeito como se fosse especificado como argumento da opcao -m. MANPATH Se $MANPATH estiver definido, o seu valor e interpretado como caminho de procura delimitado por dois-pontos de hierarquia de paginas do manual a usar. See the SEARCH PATH section of manpath(5) for the default behaviour and details of how this environment variable is handled. MANWIDTH Se $MANWIDTH estiver definido, o seu valor sera usado como largura do terminal (veja a opcao --long). Senao, a largura do terminal sera calculada usando o valor de $COLUMNS e ioctl(2) se disponivel ou retornando a 80 caracteres se tudo o mais falhar. FICHEIROS /usr/share/man/index.(bt|db|dir|pag) Uma cache de base de dados de indice global tradicional. /var/cache/man/index.(bt|db|dir|pag) Uma cache de base de dados de indice global de acordo com FHS. /usr/share/man/.../whatis Uma base de dados de texto whatis tradicional VEJA TAMBEM apropos(1), man(1), mandb(8) AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). ERROS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 WHATIS(1)