APROPOS(1) Utilitarios de paginacao de manual APROPOS(1) NOME apropos - pesquisa por nomes e descricoes de paginas de manual SINOPSE apropos [-dalv?V] [-e|-w|-r] [-s lista] [-m sistema[,...]] [-M caminho] [-L localidade] [-C arquivo] palavra-chave ... DESCRICAO Cada pagina de manual possui uma descricao curta disponivel. apropos pesquisa nas descricoes por ocorrencias de palavra-chave. palavra-chave geralmente e uma expressao regular, como se (-r) tivesse sido usada, ou pode conter opcoes curingas (-w), ou corresponder a palavra-chave exata (-e). Ao usar essas opcoes, pode ser necessario colocar a palavra-chave entre aspas ou escapar (\) os caracteres especiais para impedir que o shell interprete-os. As regras padroes de correspondencias permitem que estas sejam feitas em relacao ao nome da pagina ou limites de uma palavra na descricao. O banco de dados pesquisado por apropos e atualizado pelo programa mandb. Dependendo de sua instalacao, ele pode ser executado por um trabalho cron periodico ou pode precisar ser executado manualmente apos novas paginas serem instaladas. OPCOES -d, --debug Emite mensagens de depuracao. -v, --verbose Emite mensagens de aviso detalhadas. -r, --regex Interpreta cada palavra-chave como uma expressao regular. Esse e o comportamento padrao. Cada palavra-chave sera comparada aos nomes e as descricoes de paginas independentemente. Ela pode corresponder qualquer parte de cada uma. A correspondencia nao esta limitada aos limites de uma palavra. -w, --wildcard Interpreta cada palavra-chave como um padrao contendo caracteres curingas no estilo do shell. Cada palavra-chave sera comparada com os nomes e as descricoes de paginas independentemente. Se --exact tambem for usado, uma correspondencia so sera localizada se uma palavra-chave expandida corresponder a toda uma descricao ou nome de paginas. Do contrario, a palavra-chave tambem sera permitida corresponder a limites de uma palavra na descricao. -e, --exact Cada palavra-chave sera comparada em sua exatidao com nomes e descricoes de paginas. -a, --and Exibe apenas itens que correspondam a todas as palavras-chaves fornecidas. O padrao e exibir itens que correspondam a qualquer palavra-chave. -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 descriptions, they can be searched using this option. To search NewOS's manual page descriptions, use the option -m NewOS. O sistema especificado pode ser uma combinacao de nomes de sistemas operacionais delimitados por virgula. Para incluir uma pesquisa as descricoes do whatis 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, apropos 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 apropos 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 apropos. 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. POSIXLY_CORRECT Se $POSIXLY_CORRECT estiver definido, ainda que com um valor nulo, a pesquisa padrao de apropos sera feita como uma expressao regular estendida (-r). Hoje em dia, esse e o comportamento padrao. 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 man(1), whatis(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 APROPOS(1)