Man page - apropos(1)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

APROPOS

NOME
SINOPSE
DESCRIƇƃO
OPƇƕES
STATUS DE SAƍDA
AMBIENTE
ARQUIVOS
VEJA TAMBƉM
AUTOR
PROBLEMAS

NOME

apropos - pesquisa por nomes e descriƧƵes de pƔginas de manual

SINOPSE

apropos [ -dalv?V ] [ -e | -w | -r ] [ -s lista ] [ -m sistema [,...]] [ -M caminho ] [ -L localidade ] [ -C arquivo ] palavra-chave ...

DESCRIƇƃO

Cada pĆ”gina de manual possui uma descriĆ§Ć£o curta disponĆ­vel. apropos pesquisa nas descriƧƵes por ocorrĆŖncias de palavra-chave .

palavra-chave geralmente Ć© uma expressĆ£o regular, como se ( -r ) tivesse sido usada, ou pode conter opƧƵes curingas ( -w ), ou corresponder a palavra-chave exata ( -e ). Ao usar essas opƧƵes, pode ser necessĆ”rio colocar a palavra-chave entre aspas ou escapar (\) os caracteres especiais para impedir que o shell interprete-os.

As regras padrƵes de correspondĆŖncias permitem que estas sejam feitas em relaĆ§Ć£o ao nome da pĆ”gina ou limites de uma palavra na descriĆ§Ć£o.

O banco de dados pesquisado por apropos Ć© atualizado pelo programa mandb . Dependendo de sua instalaĆ§Ć£o, ele pode ser executado por um trabalho cron periĆ³dico ou pode precisar ser executado manualmente apĆ³s novas pĆ”ginas serem instaladas.

OPƇƕES

-d , --debug

Emite mensagens de depuraĆ§Ć£o.

-v , --verbose

Emite mensagens de aviso detalhadas.

-r , --regex

Interpreta cada palavra-chave como uma expressĆ£o regular. Esse Ć© o comportamento padrĆ£o. Cada palavra-chave serĆ” comparada aos nomes e Ć s descriƧƵes de pĆ”ginas independentemente. Ela pode corresponder qualquer parte de cada uma. A correspondĆŖncia nĆ£o estĆ” limitada aos limites de uma palavra.

-w , --wildcard

Interpreta cada palavra-chave como um padrĆ£o contendo caracteres curingas no estilo do shell. Cada palavra-chave serĆ” comparada com os nomes e as descriƧƵes de pĆ”ginas independentemente. Se --exact tambĆ©m for usado, uma correspondĆŖncia sĆ³ serĆ” localizada se uma palavra-chave expandida corresponder a toda uma descriĆ§Ć£o ou nome de pĆ”ginas. Do contrĆ”rio, a palavra-chave tambĆ©m serĆ” permitida corresponder a limites de uma palavra na descriĆ§Ć£o.

-e , --exact

Cada palavra-chave serĆ” comparada em sua exatidĆ£o com nomes e descriƧƵes de pĆ”ginas.

-a , --and

Exibe apenas itens que correspondam a todas as palavras-chaves fornecidas. O padrĆ£o Ć© exibir itens que correspondam a qualquer palavra-chave.

-l , --long

NĆ£o apara a saĆ­da Ć  largura do terminal. Normalmente, a saĆ­da serĆ” truncada Ć  largura do terminal para evitar resultados causados por seƧƵes NAME mal escritas.

-s lista , --sections= lista , --section= lista

Pesquisa apenas as seƧƵes de manual fornecidas. lista Ć© uma lista de seƧƵes separada pelo caractere de dois pontos ou vĆ­rgula. Se uma entrada na lista for uma Ćŗnica seĆ§Ć£o, por exemplo "3", entĆ£o a lista de descriƧƵes exibida incluirĆ” pĆ”ginas nas seƧƵes "3", "3perl", "3x" e por aĆ­ vai; se uma entrada na lista possuir uma extensĆ£o, por exemplo "3perl", entĆ£o a lista incluirĆ” apenas pĆ”ginas naquela parte exata da seĆ§Ć£o de manual.

-m sistema [,...], --systems= sistema [,...]

Se sistema atual possuir acesso Ć s descriƧƵes de pĆ”ginas de manual de outros sistemas operacionais, Ć© possĆ­vel pesquisar nelas usando essa opĆ§Ć£o. Para pesquisar nas descriƧƵes de pĆ”gina de manual do NewOS, use a opĆ§Ć£o -m NewOS .

O sistema especificado pode ser uma combinaĆ§Ć£o de nomes de sistemas operacionais delimitados por vĆ­rgula. Para incluir uma pesquisa Ć s descriƧƵes do whatis do sistema operacional nativo, inclua man como nome do sistema no texto do argumento. Essa opĆ§Ć£o vai sobrescrever a variĆ”vel de ambiente $ SYSTEM .

-M caminho , --manpath= caminho

Especifica um conjunto alternativo de hierarquias de pĆ”ginas de manual, separadas por caractere de dois pontos, a ser pesquisado. Por padrĆ£o, apropos usa a variĆ”vel de ambiente $ MANPATH , a menos que esteja vazia ou nĆ£o definida, caso em que ele vai determinar um manpath apropriado baseado em sua variĆ”vel de ambiente $ PATH . Essa opĆ§Ć£o sobrescreve o conteĆŗdo de $ MANPATH .

-L localidade , --locale= localidade

apropos geralmente vai determinar sua localidade atual por uma chamada Ć  funĆ§Ć£o C setlocale (3), a qual pergunta a vĆ”rias variĆ”veis de ambiente, possibilitando incluir $ LC_MESSAGES e $ LANG . Para temporariamente substituir o valor determinado, use essa opĆ§Ć£o para fornecer uma localidade diretamente para apropos . Note que isso nĆ£o surtirĆ” efeito atĆ© que a pesquisa por pĆ”ginas seja iniciada. SaĆ­da como a mensagem de ajuda sempre serĆ” exibida na localidade inicialmente determinada.

-C arquivo , --config-file= arquivo

Usa esse arquivo de configuraĆ§Ć£o de usuĆ”rio em vez do padrĆ£o ~/.manpath .

-? , --help

Imprime uma mensagem de ajuda e sai.

--usage

Imprime uma mensagem curta e sai.

-V , --version

Exibe informaĆ§Ć£o da versĆ£o.

STATUS DE SAƍDA

0

ExecuĆ§Ć£o com sucesso do programa.

1

Erro de uso, de sintaxe ou no arquivo de configuraĆ§Ć£o.

2

Erro operacional.

16

Nada foi localizado que correspondesse aos critƩrios especificados.

AMBIENTE

SYSTEM

Se $ SYSTEM estiver definido, ele terĆ” o mesmo efeito que se fosse especificado como um argumento da opĆ§Ć£o -m .

MANPATH

Se $ MANPATH estiver definido, seu valor Ʃ interpretado como um caminho de pesquisa de hierarquia de pƔginas de manual, separadas por caractere de dois pontos, a ser usado.

Veja a seĆ§Ć£o CAMINHO DE PESQUISA de manpath (5) para o comportamento padrĆ£o e detalhes de como essa variĆ”vel de ambiente Ć© manipulada.

MANWIDTH

Se $ MANWIDTH estiver definido, seu valor Ć© usado como largura do terminal (veja a opĆ§Ć£o --long ). Se nĆ£o estiver definido, a largura do terminal serĆ” calculada usando o valor de $ COLUMNS e ioctl (2), se disponĆ­vel, ou recorrendo ao padrĆ£o de 80 caracteres se todo resto falhar.

POSIXLY_CORRECT

Se $ POSIXLY_CORRECT estiver definido, ainda que com um valor nulo, a pesquisa padrĆ£o de apropos serĆ” feita como uma expressĆ£o regular estendida ( -r ). Hoje em dia, esse Ć© o comportamento padrĆ£o.

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 compatĆ­vel com FHS.

/usr/share/man/.../whatis

Um banco de dados de texto tradicional do whatis .

VEJA TAMBƉM

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