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
ESTADO DE SAƍDA
AMBIENTE
FICHEIROS
VEJA TAMBƉM
AUTOR
ERROS

NOME

apropos - procurar nas pƔginas do manual por nomes e descriƧƵes

SINOPSE

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

DESCRIƇƃO

Cada pĆ”gina do manual tem uma breve descriĆ§Ć£o disponĆ­vel. apropos procura as descriƧƵes para instĆ¢ncias de palavra-chave .

palavra-chave Ć© habitualmente uma expressĆ£o regular, como se ( -r ) fosse usada, ou pode conter caracteres universais ( -w ), ou corresponder Ć  palavra-chave exacta ( -e ). Usando estas opƧƵes, poderĆ” ser necessĆ”rio usar aspas em palavra-chave ou escapar (\) os caracteres especiais para impedir que a shell os interprete.

As regras de comparaĆ§Ć£o padrĆ£o permitem que a comparaĆ§Ć£o seja feita contra o nome da pĆ”gina e limites da palavra na descriĆ§Ć£o.

A base de dados procurada por apropos Ć© actualizada pelo programa mandb . Dependendo da sua instalaĆ§Ć£o, pode ser uma tarefa periĆ³dica cron ou pode ter de ser manualmente executado apĆ³s a instalaĆ§Ć£o de novas pĆ”ginas do manual.

OPƇƕES

-d , --debug

Imprime informaĆ§Ć£o de depuraĆ§Ć£o.

-v , --verbose

Imprime avisos verbosos.

-r , --regex

Interpreta cada palavra-chave com regex. Esta Ć© a predefiniĆ§Ć£o. Cada palavra-chave serĆ” comparada contra os nomes de pĆ”gina e a descriĆ§Ć£o independentemente. Pode corresponder a qualquer parte de qualquer uma. A comparaĆ§Ć£o nĆ£o estĆ” limitada aos limites da palavra.

-w , --wildcard

Interpreta cada palavra-chave como um padrĆ£o contendo caracteres universais ao estilo da shell. Cada palavra-chave serĆ” comparada contra os nomes de pĆ”gina e a descriĆ§Ć£o independentemente. Se --exact tambĆ©m for usado, sĆ³ serĆ” encontrada uma correspondĆŖncia se uma palavra-chave expandida corresponder a uma descriĆ§Ć£o ou nome de pĆ”gina completas. SenĆ£o, a palavra-chave tambĆ©m poderĆ” corresponder com limites de palavras na descriĆ§Ć£o.

-e , --exact

Cada palavra-chave serƔ exactamente comparada contra os nomes de pƔgina e as descriƧƵes.

-a , --and

Mostra sĆ³ itens que cumprem todas as palavras-chave indicadas. A predefiniĆ§Ć£o Ć© mostrar itens que cumpram qualquer palavra-chave.

-l , --long

NĆ£o corta a saĆ­da para a largura do terminal. Normalmente, isto Ć© feito para evitar resultados muito feios de secƧƵes NOME mal escritas.

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

Procura sĆ³ as secƧƵes do manual indicadas. lista Ć© uma lista de secƧƵes separadas por dois-pontos ou vĆ­rgula. Se uma entrada em lista for uma secĆ§Ć£o simples, por exemplo, "3", a lista de descriƧƵes mostrada incluirĆ” pĆ”ginas nas secƧƵes "3", "3perl", "3x" e assim por diante; enquanto se uma entrada em lista tiver uma extensĆ£o, por exemplo "3perl", a lista incluirĆ” sĆ³ pĆ”ginas nessa parte exacta da secĆ§Ć£o do manual.

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

Se o sistema tiver acesso a descriƧƵes de pĆ”ginas do manual de outro sistema operativo, podem ser procuradas usando esta opĆ§Ć£o. Para procurar descriƧƵes de pĆ”ginas do manual do NovoOS, use a opĆ§Ć£o -m NovoOS .

O sistema especificado pode ser uma combinaĆ§Ć£o de nomes de sistemas operativos delimitados por vĆ­rgulas. Para incluir uma procura das descriƧƵes whatis do sistema operativo nativo, inclua o nome do sistema man na cadeia de argumentos. Esta opĆ§Ć£o irĆ” sobrescrever a variĆ”vel de ambiente $ SYSTEM .

-M caminho , --manpath= caminho

Especifique um conjunto alternativo de hierarquias de pĆ”ginas de manual delimitadas por dois-pontos para procurar. Por predefiniĆ§Ć£o, apropos usa a variĆ”vel de ambiente $ MANPATH , a menos que esteja vazia ou indefinida, caso em que determinarĆ” um manpath apropriado com base na variĆ”vel de ambiente $ PATH . Esta opĆ§Ć£o sobrescreve o conteĆŗdo de $ MANPATH .

-L idioma , --locale= idioma

O apropos normalmente determinarĆ” sua localidade actual por uma chamada Ć  funĆ§Ć£o C setlocale (3), que interroga vĆ”rias variĆ”veis de ambiente, possivelmente incluindo $ LC_MESSAGES e $ LANG . Para sobrepor temporariamente o valor determinado, use esta opĆ§Ć£o para fornecer uma cadeia idioma directamente a apropos . Note que isto nĆ£o terĆ” efeito atĆ© que a procura por pĆ”ginas realmente comece. SaĆ­das como a mensagem de ajuda serĆ£o sempre mostradas no idioma inicialmente determinado.

-C ficheiro , --config-file= ficheiro

Usa este ficheiro de configuraĆ§Ć£o do utilizador em vez do prĆ©-definido de ~/.manpath .

-? , --help

Mostra uma mensagem de ajuda e sai.

--usage

Mostra uma mensagem curta de uso e sai.

-V , --version

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

ESTADO DE SAƍDA

0

ExecuĆ§Ć£o de programa com sucesso.

1

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

2

Erro de operaĆ§Ć£o.

16

Nada encontrado que cumpra o critƩrio especificado.

AMBIENTE

SYSTEM

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

MANPATH

Se $ MANPATH estiver definido, o seu valor Ʃ interpretado como caminho de procura delimitado por dois-pontos de hierarquia de pƔginas do manual a usar.

Veja a secĆ§Ć£o SEARCH PATH de manpath (5) para o comportamento prĆ©-definido e detalhes sobre a gestĆ£o da variĆ”vel de ambiente.

MANWIDTH

Se $ MANWIDTH estiver definido, o seu valor serĆ” usado como largura do terminal (veja a opĆ§Ć£o --long ). SenĆ£o, a largura do terminal serĆ” calculada usando o valor de $ COLUMNS e ioctl (2) se disponĆ­vel ou retornando a 80 caracteres se tudo o mais falhar.

POSIXLY_CORRECT

Se $ POSIXLY_CORRECT estiver definido, mesmo como valor nulo, a procura predefinida apropos serĆ” como uma regex estendida ( -r ). Hoje em dia, esta Ć© a predefiniĆ§Ć£o de qualquer forma.

FICHEIROS

/usr/share/man/index.(bt|db|dir|pag)

Uma cache de base de dados de Ć­ndice global tradicional.

/var/cache/man/index.(bt|db|dir|pag)

Uma cache de base de dados de Ć­ndice global de acordo com FHS.

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

Uma base de dados de texto whatis tradicional.

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).

ERROS

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db