.\" Man page for apropos .\" .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH APROPOS 1 2024-08-29 2.13.0 "Utilidades do paginador do manual" .SH NOME apropos \- procurar nas páginas do manual por nomes e descrições .SH SINOPSE \fBapropos\fP [\|\fB\-dalv?V\fP\|] [\|\fB\-e\fP\||\|\fB\-w\fP\||\|\fB\-r\fP\|] [\|\fB\-s\fP \fIlista\fP\|] [\|\fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fIcaminho\fP\|] [\|\fB\-L\fP \fIidioma\fP\|] [\|\fB\-C\fP \fIficheiro\fP\|] \fIpalavra\-chave\fP \&.\|.\|. .SH DESCRIÇÃO Cada página do manual tem uma breve descrição disponível. \fBapropos\fP procura as descrições para instâncias de \fIpalavra\-chave\fP \fIpalavra\-chave\fP é habitualmente uma expressão regular, como se (\fB\-r\fP) fosse usada, ou pode conter caracteres universais (\fB\-w\fP), ou corresponder à palavra\-chave exacta (\fB\-e\fP). Usando estas opções, poderá ser necessário usar aspas em \fIpalavra\-chave\fP ou escapar (\e) 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 \fBapropos\fP é actualizada pelo programa \fBmandb\fP. 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. .SH OPÇÕES .TP .if !'po4a'hide' .BR \-d ", " \-\-debug imprime informação de depuração. .TP .if !'po4a'hide' .BR \-v ", " \-\-verbose imprime avisos verbosos. .TP .if !'po4a'hide' .BR \-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. .TP .if !'po4a'hide' .BR \-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 \fB\-\-exact\fP 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. .TP .if !'po4a'hide' .BR \-e ", " \-\-exact cada palavra\-chave será exactamente comparada contra os nomes de página e as descrições. .TP .if !'po4a'hide' .BR \-a ", " \-\-and Mostra só itens que cumprem todas as palavras\-chave indicadas. A predefinição é mostrar itens que cumpram qualquer palavra\-chave. .TP .if !'po4a'hide' .BR \-l ", " \-\-long não corta a saída para a largura do terminal. Normalmente, isto é feito para evitar resultados muito feios de secções \fBNOME\fP mal escritas. .TP \fB\-s\fP \fIlista\/\fP, \fB\-\-sections=\fP\fIlista\/\fP, \fB\-\-section=\fP\fIlista\fP procura só as secções do manual indicadas. \fIlista\fP é uma lista de secções separadas por dois\-pontos ou vírgula. Se uma entrada em \fIlista\fP 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 \fIlista\fP tiver uma extensão, por exemplo "3perl", a lista incluirá só páginas nessa parte exacta da secção do manual. .TP \fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIsistema\fP\|[\|,.\|.\|.\|] 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 \fB\-m\fP \fBNewOS\fP. O \fIsistema\fP especificado pode ser uma combinação de nomes de sistemas operativos delimitados por vírgulas. Para incluir uma procura das descrições \fBwhatis\fP do sistema operativo nativo, inclua o nome do sistema \fBman\fP na cadeia de argumentos. Esta opção irá sobrescrever a variável de ambiente $\fBSYSTEM\fP. .TP \fB\-M\ \fP\fIcaminho\fP,\ \fB\-\-manpath=\fP\fIcaminho\fP Especifique um conjunto alternativo de hierarquias de páginas de manual delimitadas por dois\-pontos para procurar. Por predefinição, \fBapropos\fP usa a variável de ambiente $\fBMANPATH\fP, a menos que esteja vazia ou indefinida, caso em que determinará um manpath apropriado com base na variável de ambiente $\fBPATH\fP. Esta opção sobrescreve o conteúdo de $\fBMANPATH\fP. .TP \fB\-L\ \fP\fIidioma\fP,\ \fB\-\-locale=\fP\fIidioma\fP O \fBapropos\fP normalmente determinará sua localidade actual por uma chamada à função C \fBsetlocale\fP(3), que interroga várias variáveis de ambiente, possivelmente incluindo $\fBLC_MESSAGES\fP e $\fBLANG\fP. Para sobrepor temporariamente o valor determinado, use esta opção para fornecer uma cadeia \fIidioma\fP directamente a \fBapropos\fP. 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. .TP \fB\-C\ \fP\fIficheiro\fP,\ \fB\-\-config\-file=\fP\fIficheiro\fP Use this user configuration file rather than the default of \fI\(ti/.manpath\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help mostra uma mensagem de ajuda e sai. .TP .if !'po4a'hide' .B \-\-usage mostra uma mensagem curta de uso e sai. .TP .if !'po4a'hide' .BR \-V ", " \-\-version mostra informação da versão. .SH "ESTADO DE SAÍDA" .TP .if !'po4a'hide' .B 0 Execução de programa com sucesso. .TP .if !'po4a'hide' .B 1 Erro de uso, sintaxe ou ficheiro de configuração. .TP .if !'po4a'hide' .B 2 Erro de operação. .TP .if !'po4a'hide' .B 16 Nada encontrado que cumpra o critério especificado. .SH AMBIENTE .TP .if !'po4a'hide' .B SYSTEM Se $\fBSYSTEM\fP estiver definido, terá o mesmo efeito como se fosse especificado como argumento da opção \fB\-m\fP. .TP .if !'po4a'hide' .B MANPATH Se $\fBMANPATH\fP estiver definido, o seu valor é interpretado como caminho de procura delimitado por dois\-pontos de hierarquia de páginas do manual a usar. See the \fBSEARCH PATH\fP section of \fBmanpath\fP(5) for the default behaviour and details of how this environment variable is handled. .TP .if !'po4a'hide' .B MANWIDTH Se $\fBMANWIDTH\fP estiver definido, o seu valor será usado como largura do terminal (veja a opção \fB\-\-long\fP). Senão, a largura do terminal será calculada usando o valor de $\fBCOLUMNS\fP e \fBioctl\fP(2) se disponível ou retornando a 80 caracteres se tudo o mais falhar. .TP .if !'po4a'hide' .B POSIXLY_CORRECT Se $\fBPOSIXLY_CORRECT\fP estiver definido, mesmo como valor nulo, a procura predefinida \fBapropos\fP será como uma regex estendida (\fB\-r\fP). Hoje em dia, esta é a predefinição de qualquer forma. .SH FICHEIROS .TP .if !'po4a'hide' .I /usr/share/man/index.(bt\^|\^db\^|\^dir\^|\^pag) Uma cache de base de dados de \fIíndice\fP global tradicional. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag) Uma cache de base de dados de \fIíndice\fP global de acordo com FHS. .TP .if !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis Uma base de dados de texto \fBwhatis\fP tradicional .SH "VEJA TAMBÉM" .if !'po4a'hide' .BR man (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR mandb (8) .SH AUTOR .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .SH ERROS .if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db