WHATIS(1) Utilitarios de paginacao de manual WHATIS(1) NOME whatis - exibe descricoes de uma linha de paginas de manual SINOPSE whatis [-dlv?V] [-r|-w] [-s lista] [-m sistema[,...]] [-M caminho] [-L localidade] [-C arquivo] nome ... DESCRICAO Cada pagina de manual possui uma descricao curta disponivel. whatis pesquisa os nomes de paginas de manual e exibe as descricoes de pagina de manual de qualquer nome correspondido. nome pode conter curingas (-w) ou ser uma expressao regular (-r). Ao usar essas opcoes, pode ser necessario colocar nome entre aspas ou escapar (\) os caracteres especiais para impedir o shell de interpreta-las. Banco de dados index sao usados durante a pesquisa e sao atualizados pelo programa mandb. Dependendo da sua instalacao, isso pode ser executado por um trabalho periodico do cron, ou pode ser necessario executar manualmente apos novas paginas de manual serem instaladas. Para produzir um banco de dados do whatis no estilo texto antigo a partir do banco de dados index, use o comando: whatis -M caminho man -w '*' | sort > manpath/whatis sendo que caminho man e a hierarquia de pagina de manual tal como /usr/man. OPCOES -d, --debug Emite mensagens de depuracao. -v, --verbose Emite mensagens de aviso detalhadas. -r, --regex Interpreta cada nome como uma expressao regular. Se um nome corresponde a qualquer parte de um nome de pagina, uma correspondencia sera feita. Essa opcao faz com que whatis seja um pouco mais lento devido a natureza das pesquisas a banco de dados. -w, --wildcard Interpreta cada nome como um padrao contendo caracteres curingas do tipo shell. Para uma correspondencia ser feita, um nome expandido deve corresponder a todo um nome de pagina. Essa opcao faz com que whatis seja um pouco mais lento devido a natureza das pesquisa a banco de dados. -l, --long Nao apara a saida a largura do terminal. Normalmente, a saida sera truncada a largura do terminal para evitar resultados causados por secoes NAME mal escritas. -s lista, --sections=lista, --section=lista Pesquisa apenas as secoes de manual fornecidas. lista e uma lista de secoes separada pelo caractere de dois pontos ou virgula. Se uma entrada na lista for uma unica secao, por exemplo "3", entao a lista de descricoes exibida incluira paginas nas secoes "3", "3perl", "3x" e por ai vai; se uma entrada na lista possuir uma extensao, por exemplo "3perl", entao a lista incluira apenas paginas naquela parte exata da secao de 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 operacionais delimitados por virgula. Para incluir uma pesquisa aos nomes de paginas de manual do sistema operacional nativo, inclua man como nome do sistema no texto do argumento. Essa opcao vai sobrescrever a variavel de ambiente $SYSTEM. -M caminho, --manpath=caminho Especifica um conjunto alternativo de hierarquias de paginas de manual, separadas por caractere de dois pontos, a ser pesquisado. Por padrao, whatis usa a variavel de ambiente $MANPATH, a menos que esteja vazia ou nao definida, caso em que ele vai determinar um manpath apropriado baseado em sua variavel de ambiente $PATH. Essa opcao sobrescreve o conteudo de $MANPATH. -L localidade, --locale=localidade whatis geralmente vai determinar sua localidade atual por uma chamada a funcao C setlocale(3), a qual pergunta a varias variaveis de ambiente, possibilitando incluir $LC_MESSAGES e $LANG. Para temporariamente substituir o valor determinado, use essa opcao para fornecer uma localidade diretamente para whatis. Note que isso nao surtira efeito ate que a pesquisa por paginas seja iniciada. Saida como a mensagem de ajuda sempre sera exibida na localidade inicialmente determinada. -C arquivo, --config-file=arquivo Use this user configuration file rather than the default of ~/.manpath. -?, --help Imprime uma mensagem de ajuda e sai. --usage Imprime uma mensagem curta e sai. -V, --version Exibe informacao da versao. STATUS DE SAIDA 0 Execucao com sucesso do programa. 1 Erro de uso, de sintaxe ou no arquivo de configuracao. 2 Erro operacional. 16 Nada foi localizado que correspondesse aos criterios especificados. AMBIENTE SYSTEM Se $SYSTEM estiver definido, ele tera o mesmo efeito que se fosse especificado como um argumento da opcao -m. MANPATH Se $MANPATH estiver definido, seu valor e interpretado como um caminho de pesquisa de hierarquia de paginas de manual, separadas por caractere de dois pontos, a ser usado. 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, seu valor e usado como largura do terminal (veja a opcao --long). Se nao estiver definido, a largura do terminal sera calculada usando o valor de $COLUMNS e ioctl(2), se disponivel, ou recorrendo ao padrao de 80 caracteres se todo resto falhar. ARQUIVOS /usr/share/man/index.(bt|db|dir|pag) Um cache global de banco de dados index tradicional. /var/cache/man/index.(bt|db|dir|pag) Um cache global de banco de dados index compativel com FHS. /usr/share/man/.../whatis Um banco de dados de texto tradicional do whatis. 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). PROBLEMAS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 WHATIS(1)