{"id":5897,"date":"2022-12-20T18:57:41","date_gmt":"2022-12-20T21:57:41","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/man-pt\/"},"modified":"2022-12-20T18:57:41","modified_gmt":"2022-12-20T21:57:41","slug":"man-pt","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/man-pt\/","title":{"rendered":"MAN (pt)"},"content":{"rendered":"

MAN<\/h1>\n

NOME<\/a>
SINOPSE<\/a>
DESCRI\u00c3\u00c3O<\/a>
EXEMPLOS<\/a>
RESUMO<\/a>
PREDEFINI\u00c3\u00c3ES<\/a>
OP\u00c3\u00c3ES<\/a>
ESTADO DE SA\u00c3DA<\/a>
AMBIENTE<\/a>
FICHEIROS<\/a>
VEJA TAMB\u00c3M<\/a>
HIST\u00c3RICO<\/a>
ERROS<\/a> <\/p>\n

\n

NOME <\/a> <\/h2>\n

man \u2212 um ambiente para os manuais de refer\u00c3\u00aancia do sistema<\/p>\n

SINOPSE <\/a> <\/h2>\n

man<\/b> [man op\u00c3\u00a7\u00c3\u00b5es<\/i>] [[sec\u00c3\u00a7\u00c3\u00a3o<\/i>] p\u00c3\u00a1gina\u00a0<\/i>…]\u00a0…
man \u2212k<\/b> [apropos op\u00c3\u00a7\u00c3\u00b5es<\/i>] expreg<\/i> …
man \u2212K<\/b> [man op\u00c3\u00a7\u00c3\u00b5es<\/i>] [sec\u00c3\u00a7\u00c3\u00a3o<\/i>] termo\u00a0<\/i>…
man \u2212f<\/b> [whatis op\u00c3\u00a7\u00c3\u00b5ess<\/i>] p\u00c3\u00a1gina<\/i> …
man \u2212l<\/b> [man op\u00c3\u00a7\u00c3\u00b5es<\/i>] ficheiro<\/i> …
man \u2212w<\/b>|\u2212W<\/b> [man op\u00c3\u00a7\u00c3\u00b5es<\/i>] p\u00c3\u00a1gina<\/i> …<\/p>\n

DESCRI\u00c3\u00c3O <\/a> <\/h2>\n

man<\/b> \u00c3\u00a9 o paginador do manual do sistema. Cada argumento p\u00c3\u00a1gina<\/i> dado a man<\/b> \u00c3\u00a9 normalmente o nome de um programa, utilit\u00c3\u00a1rio ou fun\u00c3\u00a7\u00c3\u00a3o. A p\u00c3\u00a1gina do manual<\/i> associada a cada um destes argumentos \u00c3\u00a9 procurada e mostrada. A sec\u00c3\u00a7\u00c3\u00a3o<\/i>, se indicada, informa man<\/b> para procurar s\u00c3\u00b3 nessa sec\u00c3\u00a7\u00c3\u00a3o<\/i> do manual. A ac\u00c3\u00a7\u00c3\u00a3o predefinida \u00c3\u00a9 procurar em todas as sec\u00c3\u00a7\u00c3\u00b5es<\/i> dispon\u00c3veis seguindo uma ordem pr\u00c3\u00a9\u2212estabelecida (veja DEFAULTS<\/b>) e mostrar s\u00c3\u00b3 a primeira p\u00c3\u00a1gina<\/i> encontrada, mesmo se p\u00c3\u00a1gina<\/i> existir em v\u00c3\u00a1rias sec\u00c3\u00a7\u00c3\u00b5es<\/i>.<\/p>\n

A tabela abaixo mostra os n\u00c3\u00bameros de sec\u00c3\u00a7\u00c3\u00a3o<\/i> do manual, seguidos dos tipos de p\u00c3\u00a1gina que cont\u00c3\u00aam.<\/p>\n

\"Image<\/p>\n

Uma p\u00c3\u00a1gina<\/i> do manual consiste em v\u00c3\u00a1rias sec\u00c3\u00a7\u00c3\u00b5es.<\/p>\n

Nomes de sec\u00c3\u00a7\u00c3\u00a3o conventionais incluem NOME<\/b>, SINOPSE<\/b>, CONFIGURA\u00c3\u00c3O<\/b>, DESCRI\u00c3\u00c3O<\/b>, OP\u00c3\u00c3ES<\/b>, ESTADO\u00a0DE\u00a0SA\u00c3DA<\/b>, VALOR\u00a0DEVOLVIDO<\/b>, ERROS<\/b>, AMBIENTE<\/b>, FICHEIROS<\/b>, VERS\u00c3ES<\/b>, CONFORME\u00a0A<\/b>, NOTAS<\/b>, BUGS<\/b>, EXEMPLO<\/b>, AUTORES<\/b>, e VEJA\u00a0TAMB\u00c3M<\/b>.<\/p>\n

As seguintes conven\u00c3\u00a7\u00c3\u00b5es aplicam\u2212se \u00c3\u00a0 sec\u00c3\u00a7\u00c3\u00a3o SINOPSE<\/b>, podendo ser usadas como guia noutras sec\u00c3\u00a7\u00c3\u00b5es.<\/p>\n

\u00a0<\/p>\n

\"Image<\/p>\n

O desenho exacto pode variar, dependendo do dispositivo de sa\u00c3da. Por exemplo, habitualmente, o manual n\u00c3\u00a3o desenha it\u00c3\u00a1licos quando executado num terminal, tipicamente usar\u00c3\u00a1 texto sublinhado ou colorido.<\/p>\n

A ilustra\u00c3\u00a7\u00c3\u00a3o do comando ou fun\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 um padr\u00c3\u00a3o que dever\u00c3\u00a1 corresponder a todas as poss\u00c3veis chamadas. Nalguns casos, \u00c3\u00a9 aconselh\u00c3\u00a1vel ilustrar v\u00c3\u00a1rias chamadas exclusivas, tal como mostrado na sec\u00c3\u00a7\u00c3\u00a3o SINOPSE<\/b> desta p\u00c3\u00a1gina do manual.<\/p>\n

EXEMPLOS <\/a> <\/h2>\n

man\u00a0<\/b>ls<\/i><\/p>\n

Mostra a p\u00c3\u00a1gina do manual para o item<\/i> (programa) ls<\/i>.<\/p>\n

man<\/b> man<\/i>.7<\/i><\/p>\n

Mostra a p\u00c3\u00a1gina do manual para o pacote de macro man<\/i> da sec\u00c3\u00a7\u00c3\u00a3o 7<\/i> (esta \u00c3\u00a9 uma sintaxe alternativa de “man<\/b> 7 man<\/i>“).<\/p>\n

man \u2019<\/b>man<\/i>(7<\/i>)\u2019<\/p>\n

Mostra a p\u00c3\u00a1gina do manual para o pacote de macro man<\/i> da sec\u00c3\u00a7\u00c3\u00a3o 7<\/i> (esta \u00c3\u00a9 uma sintaxe alternativa de “man<\/b> 7 man<\/i>“. Pode ser mais conveniente ao copiar\/colar refer\u00c3\u00aancias cruzadas em p\u00c3\u00a1ginas do manual. Note que os par\u00c3\u00aanteses normalmente t\u00c3\u00aam de estar entre aspas para os proteger da shell).<\/p>\n

man\u00a0\u2212a\u00a0<\/b>intro<\/i><\/p>\n

Mostra, em sucess\u00c3\u00a3o, todas as p\u00c3\u00a1ginas do manual intro<\/i> dispon\u00c3- veis. \u00c3 poss\u00c3vel sair entre exibi\u00c3\u00a7\u00c3\u00b5es sucessivas ou saltar qualquer uma delas.<\/p>\n

man \u2212t<\/b> bash<\/i> | lpr \u2212Pps<\/i><\/p>\n

Formata a p\u00c3\u00a1gina do manual para bash<\/i>, para o formato predefinido troff<\/b> ou groff<\/b> e encaminha para a impressoara ps<\/i>. A sa\u00c3da predefinida para groff<\/b> \u00c3\u00a9 habitualmente PostScript. man \u2212\u2212help<\/b> deve indicar a qual processador est\u00c3\u00a1 ligada a op\u00c3\u00a7\u00c3\u00a3o \u2212t<\/b>.<\/p>\n

man \u2212l \u2212T<\/b>dvi .\/foo.1x.gz<\/i>><\/b> .\/foo.1x.dvi<\/i><\/p>\n

Este comando descomprime e formata a p\u00c3\u00a1gina fonte do manual do nroff .\/foo.1x.gz<\/i> para um ficheiro independente do dispositivo (dvi)<\/b>. O redireccionamento \u00c3\u00a9 necess\u00c3\u00a1rio dado que a bandeira \u2212T<\/b> causa o redireccionamento da sa\u00c3da para stdout<\/b> sem paginador. A sa\u00c3da poderia ser vista com um programa do tipo xdvi<\/b> ou mais processada para PostScript usando um programa como dvips.<\/b><\/p>\n

man\u00a0\u2212k\u00a0<\/b>printf<\/i><\/p>\n

Procura nas descri\u00c3\u00a7oes curtas e nomes de p\u00c3\u00a1ginas do manual pela palavra\u2212chave printf<\/i> como express\u00c3\u00a3o regular. Imprime quaisquer correspond\u00c3\u00aancias. Equivalente a apropos\u00a0<\/b>printf<\/i>.<\/b><\/p>\n

man\u00a0\u2212f\u00a0<\/b>smail<\/i><\/p>\n

Procura nas p\u00c3\u00a1ginas do manual referenciadas por smail<\/i> e imprime as descri\u00c3\u00a7\u00c3\u00b5es curtas encontradas. Equivalente a whatis\u00a0<\/b>smail<\/i>.<\/b><\/p>\n

RESUMO <\/a> <\/h2>\n

Muitas op\u00c3\u00a7\u00c3\u00b5es est\u00c3\u00a3o dispon\u00c3veis para man<\/b> para fornecer tanta flexibilidade quanta poss\u00c3vel ao utilizador. Pode alterar o caminho de procura, a ordem das sec\u00c3\u00a7\u00c3\u00b5es, o processador de sa\u00c3da e outros comportamentos e opera\u00c3\u00a7\u00c3\u00b5es, detalhadas abaixo.<\/p>\n

Se definido, v\u00c3\u00a1rias vari\u00c3\u00a1veis de ambiente s\u00c3\u00a3o interrogadas para determinar a opera\u00c3\u00a7\u00c3\u00a3o de man<\/b>. \u00c3 poss\u00c3vel definir a vari\u00c3\u00a1vel “catch all” $MANOPT<\/b> para qualquer cadeia no formato de linha de comando, com a excep\u00c3\u00a7\u00c3\u00a3o de que quaisquer espa\u00c3\u00a7os usados como parte do argumento de uma op\u00c3\u00a7\u00c3\u00a3o devem ser escapados (precedidos por barra invertida). man<\/b> analisar\u00c3\u00a1 $MANOPT<\/b> antes de analisar a sua pr\u00c3\u00b3pria linha de comando. As op\u00c3\u00a7\u00c3\u00b5es que requerem um argumento ser\u00c3\u00a3o substitu\u00c3das pelas mesmas op\u00c3\u00a7\u00c3\u00b5es encontradas na linha de comando. Para repor todas as op\u00c3\u00a7\u00c3\u00b5es definidas em $MANOPT<\/b>, \u2212D<\/b> pode ser especificada como op\u00c3\u00a7\u00c3\u00a3o inicial da linha de comando. Isto permitir\u00c3\u00a1 que man “esque\u00c3\u00a7a” as op\u00c3\u00a7\u00c3\u00b5es especificadas em $MANOPT<\/b>, embora elas pudessem ainda ser v\u00c3\u00a1lidas.<\/p>\n

As p\u00c3\u00a1ginas do manual s\u00c3\u00a3o normalmente armazenadas em formato nroff<\/b>(1) sob uma pasta como \/usr\/share\/man<\/i>. Nalgumas instala\u00c3\u00a7\u00c3\u00b5es, poder\u00c3\u00a1 haver tamb\u00c3\u00a9m cat pages<\/i> pr\u00c3\u00a9\u2212formatadas para melhorar o desempenho. Veja manpath<\/b>(5) para detalhes onde estes ficheiros s\u00c3\u00a3o armazenados.<\/p>\n

Est\u00c3\u00a1 dispon\u00c3vel suporte internacional para este pacote, controlado pela sua idioma<\/i>. Se o seu sistema n\u00c3\u00a3o definiu isto automaticamente, \u00c3\u00a9 necess\u00c3\u00a1rio definir $LC_MESSAGES<\/b>, $LANG<\/b> ou outra vari\u00c3\u00a1vel de ambiente dependente do sistema para o seu idioma, normalmente especificado no formato POSIX<\/b>:<\/p>\n

<idioma<\/i>>[_<\/b><territ\u00c3\u00b3rio<\/i>>[.<\/b><conjunto de caracteres<\/i>>[,<\/b><vers\u00c3\u00a3o<\/i>>]]]<\/p>\n

Se a p\u00c3\u00a1gina desejada estiver dispon\u00c3vel no seu idioma<\/i> ser\u00c3\u00a1 mostrada, em vez da p\u00c3\u00a1gina padr\u00c3\u00a3o (normalmente Ingl\u00c3\u00aas dos EUA)<\/p>\n

Se verificar que as tradu\u00c3\u00a7\u00c3\u00b5es fornecidos com este pacote n\u00c3\u00a3o est\u00c3\u00a3o dispon\u00c3veis no seu idioma e gostaria de os disponibilizar, por favor, contacte o gestor que coordena essa actividade.<\/p>\n

P\u00c3\u00a1ginas individuais do manual s\u00c3\u00a3o normalmente escritas e mantidas pelos programadores do programa, fun\u00c3\u00a7\u00c3\u00a3o ou outro t\u00c3\u00b3pico que documentam e n\u00c3\u00a3o est\u00c3\u00a3o inclu\u00c3das neste pacote. Se achar que uma p\u00c3\u00a1gina est\u00c3\u00a1 em falta ou \u00c3\u00a9 inadequada, por favor reporte\u2212o aos gestores do pacote em causa.<\/p>\n

Para informa\u00c3\u00a7\u00c3\u00a3o sobre outras funcionalidades e extens\u00c3\u00b5es dispon\u00c3veis com este paginador do manual, por favor, leia os documentos fornecidos com o pacote.<\/p>\n

PREDEFINI\u00c3\u00c3ES <\/a> <\/h2>\n

A ordem das sec\u00c3\u00a7\u00c3\u00b5es a procurar pode ser sobreposta pela vari\u00c3\u00a1vel de ambiente $MANSECT<\/b> ou pela directiva SECTION<\/b> em \/etc\/man_db.conf<\/i>. Por predefini\u00c3\u00a7\u00c3\u00a3o, \u00c3\u00a9 como segue:<\/p>\n

1 1p 8 2 3 3p 3pm 4 5 6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8x<\/p>\n

A p\u00c3\u00a1gina do manual formatada \u00c3\u00a9 mostrada usando um paginador<\/i>. Isto pode ser especificado de v\u00c3\u00a1rias formas, ou retorna \u00c3\u00a0 predefini\u00c3\u00a7\u00c3\u00a3o (veja a op\u00c3\u00a7\u00c3\u00a3o \u2212P<\/b> para detalhes).<\/p>\n

Os filtros s\u00c3\u00a3o decifrados por v\u00c3\u00a1rios meios. Primeiro, a op\u00c3\u00a7\u00c3\u00a3o da linha de comandos \u2212p<\/b> ou a vari\u00c3\u00a1vel de ambiente $MANROFFSEQ<\/b> s\u00c3\u00a3o interrogadas. Se \u2212p<\/b> n\u00c3\u00a3o foi usada e a vari\u00c3\u00a1vel n\u00c3\u00a3o foi definida, \u00c3\u00a9 procurada a linha inicial do ficheiro nroff por uma cadeia de pr\u00c3\u00a9\u2212processador. Para conter uma cadeia de pr\u00c3\u00a9\u2212processador v\u00c3\u00a1lida, a linha deve parecer\u2212se com:<\/p>\n

\u2019”<\/b> <cadeia<\/b>><\/p>\n

onde cadeia<\/b> pode ser qualquer combina\u00c3\u00a7\u00c3\u00a3o de letras descritas na op\u00c3\u00a7\u00c3\u00a3o \u2212p<\/b> abaixo.<\/p>\n

Se nenhum dos m\u00c3\u00a9todos acima fornecer informa\u00c3\u00a7\u00c3\u00a3o de filtragem, ser\u00c3\u00a1 usado um conjunto predefinido.<\/p>\n

Um t\u00c3\u00banel de formata\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 formado a partir dos filtros e do paginador prim\u00c3\u00a1rio (noff<\/b> ou [tg<\/b>]roff<\/b> com \u2212t<\/b>) e executado. Alternativamente, se um programa execut\u00c3\u00a1vel mandb_nfmt<\/i> (ou mandb_tfmt<\/i> com \u2212t<\/b>) existir na raiz da \u00c3\u00a1rvore do manual, ser\u00c3\u00a1 executado. Recebe o ficheiro fonte do manual, a cadeia de pr\u00c3\u00a9\u2212processamento e, opcionalmente, o dispositivo especificado com \u2212T<\/b> ou \u2212E<\/b> como argumentos.<\/p>\n

OP\u00c3\u00c3ES <\/a> <\/h2>\n

Op\u00c3\u00a7\u00c3\u00b5es n\u00c3\u00a3o\u2212argumento que sejam duplicadas na linha de comandos, em $MANOPT<\/b>, ou em ambas, n\u00c3\u00a3o s\u00c3\u00a3o prejudiciais. Para op\u00c3\u00a7\u00c3\u00b5es que requerem um argumento, cada duplica\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se ao valor anterior do argumento.<\/p>\n

Op\u00c3\u00a7\u00c3\u00b5es gerais
\u2212C\u00a0<\/b>ficheiro<\/i>,\u00a0\u2212\u2212config\u2212file=<\/b>ficheiro<\/i><\/p>\n

usa este ficheiro do utilizador em vez do predefinido de ~\/.manpath<\/i>.<\/p>\n

\u2212d<\/b>, \u2212\u2212debug<\/b><\/p>\n

imprime informa\u00c3\u00a7\u00c3\u00a3o de depura\u00c3\u00a7\u00c3\u00a3o.<\/p>\n

\u2212D<\/b>, \u2212\u2212default<\/b><\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 normalmente emitida como a primeira op\u00c3\u00a7\u00c3\u00a3o e rep\u00c3\u00b5e o comportamento de man<\/b> na predefini\u00c3\u00a7\u00c3\u00a3o. A sua finalidade \u00c3\u00a9 repor as op\u00c3\u00a7\u00c3\u00b5es que possam ter sido definidas em $MANOPT<\/b>. Quaisquer op\u00c3\u00a7\u00c3\u00b5es a seguir a \u2212D<\/b> ter\u00c3\u00a3o o seu efeito habitual.<\/p>\n

\u2212\u2212warnings<\/b>[=avisos<\/i>]<\/p>\n

Activa os avisos de groff<\/i>. Pode ser usado para realizar testes de sanidade no texto fonte das p\u00c3\u00a1ginas do manual. warnings<\/i> \u00c3\u00a9 uma lista de nomes de aviso, separados por v\u00c3rgulas; se n\u00c3\u00a3o for indicada, a predefini\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 “mac”. Veja \u201cAvisos\u201d em info groff<\/b> para uma lista de nomes de avisos dispon\u00c3veis.<\/p>\n

Modos principais de opera\u00c3\u00a7\u00c3\u00a3o
\u2212f<\/b>, \u2212\u2212whatis<\/b><\/p>\n

Equivalente a whatis<\/b>. Mostra uma breve descri\u00c3\u00a7\u00c3\u00a3o da p\u00c3\u00a1gina do manual, se dispon\u00c3vel. Veja whatis<\/b>(1) para detalhes.<\/p>\n

\u2212k<\/b>, \u2212\u2212apropos<\/b><\/p>\n

Equivalente a apropos<\/b>. Procura nas descri\u00c3\u00a7\u00c3\u00b5es curtas das p\u00c3\u00a1ginas do manual por palavras\u2212chave e mostra as correspond\u00c3\u00aancias. Veja apropos<\/b>(1) para detalhes.<\/p>\n

\u2212K<\/b>, \u2212\u2212global\u2212apropos<\/b><\/p>\n

Procura texto em todas as p\u00c3\u00a1ginas do manual. Esta \u00c3\u00a9 uma procura brutal e provavelmente levar\u00c3\u00a1 algum tempo; Se puder, especifique uma sec\u00c3\u00a7\u00c3\u00a3o para reduzir o n\u00c3\u00bamero de p\u00c3\u00a1ginas a procurar. Os termos de procura podem ser cadeias simples (predefini\u00c3\u00a7\u00c3\u00a3o) ou express\u00c3\u00b5es regulares, se a op\u00c3\u00a7\u00c3\u00a3o \u2212\u2212regex<\/b> for usada.<\/p>\n

Note que isto procura as fontes<\/i> das p\u00c3\u00a1ginas do manual, n\u00c3\u00a3o o texto produzido, pelo que pode incluir falsos positivos devido a coment\u00c3\u00a1rios nas fontes. Procurar no texto formatado, seria muito mais lento.<\/p>\n

\u2212l<\/b>, \u2212\u2212local\u2212file<\/b><\/p>\n

Activa o modo “local”. Formata e mostra ficheiros locais do manual, em vez de procurar na colec\u00c3\u00a7\u00c3\u00a3o de manuais do sistema. Cada argumento de p\u00c3\u00a1gina do manual ser\u00c3\u00a1 interpretado como um ficheiro\u2212fonte nroff no formato correcto. Nenhum ficheiro cat \u00c3\u00a9 produzido. Se \u2019\u2212\u2019 for um dos argumentos, a entrada ser\u00c3\u00a1 lida de stdin. Quando esta op\u00c3\u00a7\u00c3\u00a3o n\u00c3\u00a3o \u00c3\u00a9 usada e o manual n\u00c3\u00a3o encontra a p\u00c3\u00a1gina necess\u00c3\u00a1ria, antes de mostrar a mensagem de erro, tenta agir como se a op\u00c3\u00a7\u00c3\u00a3o fosse fornecida, usando o nome como nome de ficheiro e procurando uma correspond\u00c3\u00aancia exacta.<\/p>\n

\u2212w<\/b>, \u2212\u2212where<\/b>, \u2212\u2212path<\/b>, \u2212\u2212location<\/b><\/p>\n

N\u00c3\u00a3o mostra realmente a p\u00c3\u00a1gina do manual, mas imprime a localiza\u00c3\u00a7\u00c3\u00a3o do ficheiro fonte nroff que seria formatado. Se \u2212a<\/b> for tamb\u00c3\u00a9m usada, imprime as localiza\u00c3\u00a7\u00c3\u00b5es de todos os ficheiros fonte que cumprem o crit\u00c3\u00a9rio de procura.<\/p>\n

\u2212W<\/b>, \u2212\u2212where\u2212cat<\/b>, \u2212\u2212location\u2212cat<\/b><\/p>\n

N\u00c3\u00a3o mostra realmente a p\u00c3\u00a1gina do manual, mas imprime a localiza\u00c3\u00a7\u00c3\u00a3o do ficheiro cat pr\u00c3\u00a9\u2212formatado que seria mostrado. Se \u2212a<\/b> for tamb\u00c3\u00a9m usada, imprime as localiza\u00c3\u00a7\u00c3\u00b5es de todos os ficheiros cat pr\u00c3\u00a9\u2212formatados que cumprem o crit\u00c3\u00a9rio de procura.<\/p>\n

Se \u2212w<\/b> e \u2212W<\/b> forem ambas usadas, imprime o ficheiro\u2212fonte e o ficheiro cat separados por um espa\u00c3\u00a7o. Se forem usadas \u2212w<\/b>, \u2212W<\/b> e \u2212a<\/b>, faz isto para todas as correspond\u00c3\u00aancias poss\u00c3veis.<\/p>\n

\u2212c<\/b>, \u2212\u2212catman<\/b><\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o n\u00c3\u00a3o \u00c3\u00a9 para uso geral e s\u00c3\u00b3 deve ser usada pelo programa catman<\/b>.<\/p>\n

\u2212R\u00a0<\/b>codifica\u00c3\u00a7\u00c3\u00a3o<\/i>,\u00a0\u2212\u2212recode<\/b>=codifica\u00c3\u00a7\u00c3\u00a3o<\/i><\/p>\n

Em vez de formatar a p\u00c3\u00a1gina do manual da maneira usual, envia a sua fonte convertida para a codifica\u00c3\u00a7\u00c3\u00a3o<\/i> especificada. Se j\u00c3\u00a1 conhece a codifica\u00c3\u00a7\u00c3\u00a3o do ficheiro fonte, tamb\u00c3\u00a9m pode usar manconv<\/b>(1) directamente. No entanto, essa op\u00c3\u00a7\u00c3\u00a3o permite converter v\u00c3\u00a1rias p\u00c3\u00a1ginas do manual numa \u00c3\u00banica codifica\u00c3\u00a7\u00c3\u00a3o sem ter de declarar explicitamente a codifica\u00c3\u00a7\u00c3\u00a3o de cada uma, desde que j\u00c3\u00a1 tenham sido instaladas numa estrutura semelhante a uma hierarquia de p\u00c3\u00a1gina do manual.<\/p>\n

Considere usar antes man-recode<\/b>(1) para converter m\u00c3\u00baltiplas p\u00c3\u00a1ginas do manual, dado que tem um ambiente desenhado para convers\u00c3\u00a3o em lote e, como tal, pode ser bastante mais r\u00c3\u00a1pido.<\/p>\n

Encontrar p\u00c3\u00a1ginas do manual
\u2212L\u00a0<\/b>idioma<\/i>,\u00a0\u2212\u2212locale=<\/b>idioma<\/i><\/p>\n

O man<\/b> normalmente determinar\u00c3\u00a1 sua localidade actual por uma chamada \u00c3\u00a0 fun\u00c3\u00a7\u00c3\u00a3o C setlocale<\/b>(3), que interroga v\u00c3\u00a1rias vari\u00c3\u00a1veis de ambiente, possivelmente incluindo $LC_MESSAGES<\/b> e $LANG<\/b>. Para sobrepor temporariamente o valor determinado, use esta op\u00c3\u00a7\u00c3\u00a3o para fornecer uma cadeia idioma<\/i> directamente a man<\/b>. Note que isto n\u00c3\u00a3o ter\u00c3\u00a1 efeito at\u00c3\u00a9 que a procura por p\u00c3\u00a1ginas realmente comece. Sa\u00c3das como a mensagem de ajuda ser\u00c3\u00a3o sempre mostradas no idioma inicialmente determinado.<\/p>\n

\u2212m<\/b> sistema<\/i>[,…], \u2212\u2212systems=<\/b>sistema<\/i>[,…]<\/p>\n

Se este sistema tem acesso a p\u00c3\u00a1ginas do manual de outro sistema operativo, pode aceder\u2212lhes usando esta op\u00c3\u00a7\u00c3\u00a3o. Para procurar uma p\u00c3\u00a1gina do manual da colec\u00c3\u00a7\u00c3\u00a3o do NovoOS, use a op\u00c3\u00a7\u00c3\u00a3o \u2212m NovoOS<\/b>.<\/p>\n

O sistema<\/i> especificado pode ser uma combina\u00c3\u00a7\u00c3\u00a3o de nomes de sistemas operativos, separados por v\u00c3rgulas. Para incluir uma procura de p\u00c3\u00a1ginas do manual do sistema operativo nativo, inclua o nome do sistema man<\/b> na cadeia de argumentos. Esta op\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $SYSTEM<\/b>.<\/p>\n

\u2212M\u00a0<\/b>caminho<\/i>,\u00a0\u2212\u2212manpath=<\/b>caminho<\/i><\/p>\n

Especifica um caminho de manual alternativo. Por predefini\u00c3\u00a7\u00c3\u00a3o, man<\/b> usa c\u00c3\u00b3digo derivado de manpath<\/b> para determinar o caminho a procurar. Esta,op\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $MANPATH<\/b> e faz com que a op\u00c3\u00a7\u00c3\u00a3o \u2212m<\/b> seja ignorada.<\/p>\n

Um caminho especificado como sendo caminho do manual,tem de ser a raiz de uma hierarquia de p\u00c3\u00a1ginas do manual estruturada em sec\u00c3\u00a7\u00c3\u00b5es, tal como descrito no manual do man\u2212db (sob “O sistema de p\u00c3\u00a1ginas do manual”). Para ver p\u00c3\u00a1ginas do manual fora desta hierarquia, veja a op\u00c3\u00a7\u00c3\u00a3o \u2212l<\/b>.<\/p>\n

\u2212S<\/b> lista<\/i>, \u2212s<\/b> lista<\/i>, \u2212\u2212sections=<\/b>lista<\/i><\/p>\n

A lista<\/i> \u00c3\u00a9 uma lista de sec\u00c3\u00a7\u00c3\u00b5es separada por dois\u2212pontos ou v\u00c3rgulas, usada para determinar quais as sec\u00c3\u00a7\u00c3\u00b5es do manual a procurar e em que ordem. Esta op\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $MANSECT<\/b>. A sintaxe \u2212s<\/b> \u00c3\u00a9 para compatibilidade com System V.<\/p>\n

\u2212e\u00a0<\/b>sub\u2212extens\u00c3\u00a3o<\/i>,\u00a0\u2212\u2212extension=<\/b>sub\u2212extens\u00c3\u00a3o<\/i><\/p>\n

Alguns sistemas incorporam grandes pacotes de p\u00c3\u00a1ginas do manual, tais como as que acompanham o pacote Tcl<\/b>, na hierarquia principal das p\u00c3\u00a1ginas do manual. Para contornar o problema de ter duas p\u00c3\u00a1gina de manual com o mesmo nome,, tais como exit<\/b>(3), as p\u00c3\u00a1ginas Tcl<\/b> foram todas habitualmente atribu\u00c3das \u00c3\u00a0 sec\u00c3\u00a7\u00c3\u00a3o l<\/b>. Como isto era infeliz, \u00c3\u00a9 agora poss\u00c3vel p\u00c3\u00b4r as p\u00c3\u00a1ginas na sec\u00c3\u00a7\u00c3\u00a3o correcta e atribuir\u2212lhes uma “extens\u00c3\u00a3o” espec\u00c3fica, neste caso, exit<\/b>(3tcl). Sob opera\u00c3\u00a7\u00c3\u00a3o normal, man<\/b> mostrar\u00c3\u00a1 exit<\/b>(3) preferencialmente a exit<\/b>(3tcl). Para negociar esta situa\u00c3\u00a7\u00c3\u00a3o e evitar ter de saber qual a sec\u00c3\u00a7\u00c3\u00a3o em que est\u00c3\u00a1 o que necessita, \u00c3\u00a9 agora poss\u00c3vel dar a man<\/b> uma cadeia sub\u2212extens\u00c3\u00a3o<\/i> indicando a que pacote a p\u00c3\u00a1gina tem de pertencer. Usando o exemplo acima, indicando a op\u00c3\u00a7\u00c3\u00a3o \u2212e\u00a0tcl<\/b> a man<\/b> restringe a procura a p\u00c3\u00a1ginas com uma extens\u00c3\u00a3o *tcl<\/b>.<\/p>\n

\u2212i<\/b>, \u2212\u2212ignore\u2212case<\/b><\/p>\n

Ignora mai\u00c3\u00basculas ao procurar p\u00c3\u00a1ginas do manual. \u00c3 a predefini\u00c3\u00a7\u00c3\u00a3o.<\/p>\n

\u2212I<\/b>, \u2212\u2212match\u2212case<\/b><\/p>\n

Procura p\u00c3\u00a1ginas do manual diferenciando mai\u00c3\u00basculas.<\/p>\n

\u2212\u2212regex<\/b><\/p>\n

Mostra todas as p\u00c3\u00a1ginas com qualquer parte ou dos seus nomes ou das suas descri\u00c3\u00a7\u00c3\u00b5es correspondentes a cada argumento de p\u00c3\u00a1gina<\/i> como express\u00c3\u00a3o regular, como com apropos<\/b>(1). Como n\u00c3\u00a3o h\u00c3\u00a1 habitualmente forma de escolher a “melhor” p\u00c3\u00a1gina ao procurar uma express\u00c3\u00a3o regular, esta op\u00c3\u00a7\u00c3\u00a3o implica \u2212a<\/b>.<\/p>\n

\u2212\u2212wildcard<\/b><\/p>\n

Mostra todas as p\u00c3\u00a1ginas com qualquer parte ou dos seus nomes ou das suas descri\u00c3\u00a7\u00c3\u00b5es correspondentes a cada argumento page<\/i> usando caracteres universais, como com apropos<\/b>(1) \u2212wildcard<\/b>. O argumento page<\/i> tem de corresponder ao nome ou descri\u00c3\u00a7\u00c3\u00a3o completos ou corresponder aos limites de palavras na descri\u00c3\u00a7\u00c3\u00a3o. Como n\u00c3\u00a3o h\u00c3\u00a1 habitualmente forma de escolher a “melhor” p\u00c3\u00a1gina ao procurar um car\u00c3\u00a1cter universal, esta op\u00c3\u00a7\u00c3\u00a3o implica \u2212a<\/b>.<\/p>\n

\u2212\u2212names\u2212only<\/b><\/p>\n

Se a op\u00c3\u00a7\u00c3\u00a3o \u2212\u2212regex<\/b> ou \u2212\u2212wildcard<\/b> forem usadas, compara s\u00c3\u00b3 nomes de p\u00c3\u00a1gina, n\u00c3\u00a3o descri\u00c3\u00a7\u00c3\u00b5es, como com whatis<\/b>(1). Sen\u00c3\u00a3o, n\u00c3\u00a3o tem efeito.<\/p>\n

\u2212a<\/b>, \u2212\u2212all<\/b><\/p>\n

Por predefini\u00c3\u00a7\u00c3\u00a3o, man<\/b> sai ap\u00c3\u00b3s mostrar a p\u00c3\u00a1gina de manual mais adequada que encontrar. Usar esta op\u00c3\u00a7\u00c3\u00a3o for\u00c3\u00a7a man<\/b> a mostrar todas as p\u00c3\u00a1ginas do manual com nomes que cumpram o crit\u00c3\u00a9rio de procura.<\/p>\n

\u2212u<\/b>, \u2212\u2212update<\/b><\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o faz com que man<\/b> actualize as caches da sua base de dados de p\u00c3\u00a1ginas do manual instaladas. Isto s\u00c3\u00b3 \u00c3\u00a9 necess\u00c3\u00a1rio em raras ocasi\u00c3\u00b5es e \u00c3\u00a9 normalmente melhor executar mandb<\/b>(8).<\/p>\n

\u2212\u2212no\u2212subpages<\/b><\/p>\n

Por predefini\u00c3\u00a7\u00c3\u00a3o, man<\/b> tentar\u00c3\u00a1 interpretar pares de nomes de p\u00c3\u00a1ginas do manual dados na linha de comandos como equivalentes a um \u00c3\u00banico nome de p\u00c3\u00a1gina do manual contendo um h\u00c3fen ou um sublinhado. Isto suporta o padr\u00c3\u00a3o comum de programas que implementam v\u00c3\u00a1rios sub\u2212comandos, permitindo que eles forne\u00c3\u00a7am p\u00c3\u00a1ginas de manual para cada um que possa ser acedido usando uma sintaxe semelhante \u00c3\u00a0 que seria usada para chamar os pr\u00c3\u00b3prios sub\u2212comandos. Por exemplo:<\/p>\n

$ man \u2212aw git diff
\/usr\/share\/man\/man1\/git\u2212diff.1.gz<\/p>\n

Para desactivar este comportamento, use a op\u00c3\u00a7\u00c3\u00a3o \u2212\u2212no\u2212subpages<\/b>.<\/p>\n

$ man \u2212aw \u2212\u2212no\u2212subpages git diff
\/usr\/share\/man\/man1\/git.1.gz
\/usr\/share\/man\/man3\/Git.3pm.gz
\/usr\/share\/man\/man1\/diff.1.gz<\/p>\n

Controlar sa\u00c3da formatada
\u2212P\u00a0<\/b>paginador<\/i>,\u00a0\u2212\u2212pager=<\/b>paginador<\/i><\/p>\n

Especifica o paginador de sa\u00c3da a usar. Por predefini\u00c3\u00a7\u00c3\u00a3o, man<\/b> usa less<\/b>, caindo em cat<\/b> se o less<\/b> n\u00c3\u00a3o for encontrado ou n\u00c3\u00a3o for execut\u00c3\u00a1vel. Esta op\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $MANPAGER<\/b>, que, por sua vez, se sobrep\u00c3\u00b5e \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $PAGER<\/b>. N\u00c3\u00a3o \u00c3\u00a9 usada em conjunto com \u2212f<\/b> ou \u2212k<\/b>.<\/p>\n

O valor pode ser um simples nome de comando ou um comando com argumentos e pode usar cita\u00c3\u00a7\u00c3\u00b5es de shell (barras invertidas, aspas simples ou aspas duplas). N\u00c3\u00a3o pode usar t\u00c3\u00baneis para ligar v\u00c3\u00a1rios comandos; se for tal preciso, use um script, o que pode levar o ficheiro a ser visto como argumento ou na sa\u00c3da padr\u00c3\u00a3o.<\/p>\n

\u2212r\u00a0<\/b>prompt<\/i>,\u00a0\u2212\u2212prompt=<\/b>prompt<\/i><\/p>\n

Se for usada uma vers\u00c3\u00a3o recente do less<\/b> como paginador, o man<\/b> tentar\u00c3\u00a1 definir o seu prompt e algumas op\u00c3\u00a7\u00c3\u00b5es sens\u00c3veis. O prompt predefinido parece\u2212se com<\/p>\n

P\u00c3\u00a1gina do manual<\/b> nome<\/i>(<\/b>sec<\/i>) linha<\/b> x<\/i><\/p>\n

onde nome<\/i> denota o nome da p\u00c3\u00a1gina do manual, sec<\/i> denota a sec\u00c3\u00a7\u00c3\u00a3o onde foi encontrada e x<\/i> o n\u00c3\u00bamero de linha actual. Isto consegue\u2212se usando a vari\u00c3\u00a1vel de ambiente $LESS<\/b>.<\/p>\n

Fornecer \u2212r<\/b> com uma cadeia sobrep\u00c3\u00b5e esta predefini\u00c3\u00a7\u00c3\u00a3o. A cadeia pode conter o texto $MAN_PN<\/b>, que ser\u00c3\u00a1 expandido para o nome da p\u00c3\u00a1gina de manual actual e seu nome de sec\u00c3\u00a7\u00c3\u00a3o, entre “(” e “)”. A cadeia usada para produzir a predefini\u00c3\u00a7\u00c3\u00a3o pode ser expressa como<\/p>\n

\u00a0P\u00c3\u00a1gina\u00a0do\u00a0manual\u00a0$MAN_PN\u00a0?ltlinha\u00a0%lt?L\/%L.:
byte\u00a0%bB?s\/%s..?\u00a0(END):?pB\u00a0%pB\\%..
(prima h para ajuda ou q para sair)<\/b><\/p>\n

Est\u00c3\u00a1 dividida em tr\u00c3\u00aas linhas para melhorar a legibilidade. Para ver o seu significado, veja a p\u00c3\u00a1gina do less<\/b>(1). A cadeia do prompt \u00c3\u00a9 primeiro avaliada pela shell. Todas as aspas e barras invertidas no prompt t\u00c3\u00aam de ser escapadas com uma barra invertida precedente. A cadeia pode terminar num $ escapadoque pode ser seguido de mais op\u00c3\u00a7\u00c3\u00b5es do less<\/b>. Por predefini\u00c3\u00a7\u00c3\u00a3o, man<\/b> define as op\u00c3\u00a7\u00c3\u00b5es \u2212ix8<\/b><\/p>\n

A vari\u00c3\u00a1vel de ambiente $MANLESS<\/b> descrita abaixo pode ser usada para definir uma cadeia de prompt predefinida, se nenhuma for indicada na linha de comandos.<\/p>\n

\u22127<\/b>, \u2212\u2212ascii<\/b><\/p>\n

Ao ver uma p\u00c3\u00a1gina do manual pura ascii<\/i>(7) num terminal de 7 bitou num emulador de terminal, alguns caracteres podem n\u00c3\u00a3o se ver corectamente ao usar a descri\u00c3\u00a7\u00c3\u00a3o de dispositivo latin1<\/i>(7) com GNU nroff<\/b>. Esta op\u00c3\u00a7\u00c3\u00a3o permite que p\u00c3\u00a1ginas do manual puras ascii<\/i> sejam mostradas em ascii<\/i> com o dispositivo latin1<\/i>. N\u00c3\u00a3o traduzir\u00c3\u00a1 nenhum texto latin1<\/i>. A tabela seguinte mostra as tradu\u00c3\u00a7\u00c3\u00b5es realizadas: algumas partes s\u00c3\u00b3 poder\u00c3\u00a3o ser vistas adequadamente ao usar o dispositivo latin1<\/i>(7) do GNU nroff<\/b>.<\/p>\n

\"Image<\/p>\n

Se a coluna latin1<\/i> \u00c3\u00a9 mostrada correctamente, o seu terminal pode estar definido para caracteres latin1<\/i> e esta op\u00c3\u00a7\u00c3\u00a3o n\u00c3\u00a3o \u00c3\u00a9 necess\u00c3\u00a1ria. se as colunas latin1<\/i> e ascii<\/i> s\u00c3\u00a3o id\u00c3\u00aanticas, est\u00c3\u00a1 a ler esta p\u00c3\u00a1gina com esta op\u00c3\u00a7\u00c3\u00a3o ou o man<\/b> n\u00c3\u00a3o formatou esta p\u00c3\u00a1gina usando a descri\u00c3\u00a7\u00c3\u00a3o do dispositivo latin1<\/i> Se a coluna latin1<\/i> est\u00c3\u00a1 em flata ou corrompida, poder\u00c3\u00a1 ter de ver as p\u00c3\u00a1ginas do manual com esta op\u00c3\u00a7\u00c3\u00a3o.<\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 ignorada ao usar as op\u00c3\u00a7\u00c3\u00b5es \u2212t<\/b>, \u2212H<\/b>, \u2212T<\/b>, ou \u2212Z<\/b> e pode ser in\u00c3\u00batil para um nroff<\/b> diferente do GNU nroffs<\/b>.<\/p>\n

\u2212E\u00a0<\/b>codifica\u00c3\u00a7\u00c3\u00a3o<\/i>,\u00a0\u2212\u2212encoding<\/b>=codifica\u00c3\u00a7\u00c3\u00a3o<\/i><\/p>\n

Gera sa\u00c3da para uma codifica\u00c3\u00a7\u00c3\u00a3o de caracteres diferente da predefinida. Para compatibilidade, a codifica\u00c3\u00a7\u00c3\u00a3o<\/i> pode ser um dispositivo nroff<\/b> tal como ascii<\/b>, latin1<\/b>, ou utf8<\/b>, assim como uma verdadeira codifica\u00c3\u00a7\u00c3\u00a3o de caracteres, como UTF\u22128<\/b>.<\/p>\n

\u2212\u2212no\u2212hyphenation<\/b>, \u2212\u2212nh<\/b><\/p>\n

Normalmente, o nroff<\/b> hifeniza o texto nas quebras de linha, mesmo com palavras que n\u00c3\u00a3o cont\u00c3\u00aam h\u00c3fenes, se for necess\u00c3\u00a1rio para dispor palavras numa linha sem espa\u00c3\u00a7o excessivo. Esta op\u00c3\u00a7\u00c3\u00a3o desactiva a hifeniza\u00c3\u00a7\u00c3\u00a3o autom\u00c3\u00a1tica, pelo que as palavras s\u00c3\u00b3 ser\u00c3\u00a3o divididas se j\u00c3\u00a1 contiverem h\u00c3fenes.<\/p>\n

Se est\u00c3\u00a1 a escrever uma p\u00c3\u00a1gina do manual e simplesmente quer impedir o nroff<\/b> de hifenizar erradamente uma palavra, n\u00c3\u00a3o use esta op\u00c3\u00a7\u00c3\u00a3o, consulte antes a documenta\u00c3\u00a7\u00c3\u00a3o do nroff<\/b>; e.g., pode p\u00c3\u00b4r “%” dentro de uma palavra para indicar que ela pode ser hifenizada nesse ponto, ou p\u00c3\u00b4r “%” no in\u00c3cio da palavra para impedir que seja hifenizada.<\/p>\n

\u2212\u2212no\u2212justification<\/b>, \u2212\u2212nj<\/b><\/p>\n

Normalmente, o nroff<\/b> alinha o texto a ambas as margens. Esta op\u00c3\u00a7\u00c3\u00a3o desactiva este alinhamento, alinhando o texto s\u00c3\u00b3 \u00c3\u00a0 esquerda.<\/p>\n

Se est\u00c3\u00a1 a escrever uma p\u00c3\u00a1gina do manual e simplesmente quer impedir o nroff<\/b> de alinhar assim determinados par\u00c3\u00a1grafos, n\u00c3\u00a3o use esta op\u00c3\u00a7\u00c3\u00a3o, consulte antes a documenta\u00c3\u00a7\u00c3\u00a3o do nroff<\/b>; e.g., pode usar os pedidos “.na”, “.nf”, “.fi” e “.ad” para desactivar temporariamente o ajuste e preenchimento.<\/p>\n

\u2212p\u00a0<\/b>cadeia<\/i>,\u00a0\u2212\u2212preprocessor=<\/b>cadeia<\/i><\/p>\n

Especifica a sequ\u00c3\u00aancia de pr\u00c3\u00a9\u2212processadores a executar antes de nroff<\/b> ou troff<\/b>\/groff<\/b>. Nem todas as instala\u00c3\u00a7\u00c3\u00b5es ter\u00c3\u00a3o um conjunto completo de pr\u00c3\u00a9\u2212processadores. Alguns deles e as letras usadas para os designar s\u00c3\u00a3o: eqn<\/b> (e<\/b>), grap<\/b> (g<\/b>), pic<\/b> (p<\/b>), tbl<\/b> (t<\/b>), vgrind<\/b> (v<\/b>), refer<\/b> (r<\/b>). Esta op\u00c3\u00a7\u00c3\u00a3o sobrep\u00c3\u00b5e\u2212se \u00c3\u00a0 vari\u00c3\u00a1vel de ambiente $MANROFFSEQ<\/b>. zsoelim<\/b> \u00c3\u00a9 sempre executado como primeiro pr\u00c3\u00a9\u2212processador.<\/p>\n

\u2212t<\/b>, \u2212\u2212troff<\/b><\/p>\n

Usa groff \u2212mandoc<\/i> para formatar a p\u00c3\u00a1gina do manual para a sa\u00c3da padr\u00c3\u00a3o. Esta op\u00c3\u00a7\u00c3\u00a3o n\u00c3\u00a3o \u00c3\u00a9 requerida em conjunto com \u2212H<\/b>, \u2212T<\/b>, ou \u2212Z<\/b>.<\/p>\n

\u2212T<\/b>[dispositivo<\/i>], \u2212\u2212troff\u2212device<\/b>[=dispositivo<\/i>]<\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 usada para alterar a sa\u00c3da de groff<\/b> (ou possivelmente troff<\/b>) para a adequar a outro dispositivo que n\u00c3\u00a3o o predefinido. Implica \u2212t<\/b>. Exemplos (dados com Groff\u22121.17) incluem dvi<\/b>, latin1<\/b>, ps<\/b>, utf8<\/b>, X75<\/b> e X100<\/b>.<\/p>\n

\u2212H<\/b>[navegador<\/i>], \u2212\u2212html<\/b>[=navegador<\/i>]<\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o faz com que o groff<\/b> produza sa\u00c3da HTML e mostra essa sa\u00c3da num navegador web. A escolha do navegador \u00c3\u00a9 determinada pelo argumento opcional navegador<\/i>, se for fornecido pela vari\u00c3\u00a1vel de ambiente $BROWSER<\/b> ou por valor predefinido compilado em tempo de execu\u00c3\u00a7\u00c3\u00a3o, se aquela n\u00c3\u00a3o estiver definida (normalmente o lynx<\/b>). Esta op\u00c3\u00a7\u00c3\u00a3o implica \u2212t<\/b> e s\u00c3\u00b3 funciona com o GNU troff<\/b>.<\/p>\n

\u2212X<\/b>[dpi<\/i>], \u2212\u2212gxditview<\/b>[=dpi<\/i>]<\/p>\n

Esta op\u00c3\u00a7\u00c3\u00a3o mostra a sa\u00c3da do groff<\/b> numa janela gr\u00c3\u00a1fica usando o programa gxditview<\/b>. Os dpi<\/i> (dots per inch) podem ser 75, 75\u221212, 100, ou 100\u221212, predefinidos para 75; as variantes \u221212 usam uma letra de 12\u2212pontos. Esta op\u00c3\u00a7\u00c3\u00a3o implica \u2212T<\/b> com os dispositivos X75, X75\u221212, X100, ou X100\u221212, respectivamente.<\/p>\n

\u2212Z<\/b>, \u2212\u2212ditroff<\/b><\/p>\n

O groff<\/b> executar\u00c3\u00a1 o troff<\/b> e usar\u00c3\u00a1 o p\u00c3\u00b3s\u2212processador apropriado para produzir uma sa\u00c3da adequada ao dispositivo escolhido. Se o groff \u2212mandoc<\/i> for o groff<\/b>, esta op\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 passada ao groff<\/b> e vai suprimir o uso de um p\u00c3\u00b3s\u2212processador. Implica \u2212t<\/b>.<\/p>\n

Obter ajuda
\u2212?<\/b>, \u2212\u2212help<\/b><\/p>\n

mostra uma mensagem de ajuda e sai.<\/p>\n

\u2212\u2212usage<\/b><\/p>\n

mostra uma mensagem curta de uso e sai.<\/p>\n

\u2212V<\/b>, \u2212\u2212version<\/b><\/p>\n

mostra informa\u00c3\u00a7\u00c3\u00a3o da vers\u00c3\u00a3o.<\/p>\n

ESTADO DE SA\u00c3DA <\/a> <\/h2>\n\n\n\n\n\n\n
<\/td>\n\n

0<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Execu\u00c3\u00a7\u00c3\u00a3o de programa com sucesso.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

1<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Erro de uso, sintaxe ou ficheiro de configura\u00c3\u00a7\u00c3\u00a3o.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

2<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Erro de opera\u00c3\u00a7\u00c3\u00a3o.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

3<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Um processo filho devolveu um estado de sa\u00c3da n\u00c3\u00a3o\u2212zero.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

16<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Pelo menos uma de p\u00c3\u00a1ginas\/ficheiros\/palavras\u2212chave n\u00c3\u00a3o existe ou n\u00c3\u00a3o teve correspond\u00c3\u00aancias.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

AMBIENTE <\/a> <\/h2>\n

MANPATH<\/b><\/p>\n

Se $MANPATH<\/b> estiver definida, o seu valor \u00c3\u00a9 usado como caminho de procura de p\u00c3\u00a1ginas do manual.<\/p>\n

MANROFFOPT<\/b><\/p>\n

Sempre que man<\/b> chama o formatador (nroff<\/b>, troff<\/b>, ou groff<\/b>), adiciona o conte\u00c3\u00bado de $MANROFFOPT<\/b> \u00c3\u00a0 linha de comandos do formatador.<\/p>\n

MANROFFSEQ<\/b><\/p>\n

Se $MANROFFSEQ<\/b> estiver definida, o seu valor \u00c3\u00a9 usado para determinar o conjunto de pr\u00c3\u00a9\u2212processadores por onde passar cada p\u00c3\u00a1gina do manual. A lista de pr\u00c3\u00a9\u2212processadores depende do sistema.<\/p>\n

MANSECT<\/b><\/p>\n

Se $MANSECT<\/b> estiver definida, o seu valor \u00c3\u00a9 uma lista de sec\u00c3\u00a7\u00c3\u00b5es separada por dois\u2212pontos e \u00c3\u00a9 usada para determinar que sec\u00c3\u00a7\u00c3\u00b5es do manual procurar e em que ordem. A predefini\u00c3\u00a7\u00c3\u00a3o \u00c3\u00a9 “1 1p 8 2 3 3p 3pm 4 5 6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8x”, a n\u00c3\u00a3o ser que sobreposta pela directiva SECTION<\/b> em \/etc\/man_db.conf<\/i>.<\/p>\n

MANPAGER<\/b>, PAGER<\/b><\/p>\n

Se $MANPAGER<\/b> ou $PAGER<\/b> estiverem definidas ($MANPAGER<\/b> \u00c3\u00a9 preferida), o seu valor \u00c3\u00a9 usado como nome do programa usado para mostrar a p\u00c3\u00a1gina do manual. Por predefini\u00c3\u00a7\u00c3\u00a3o, \u00c3\u00a9 usada less<\/b>, voltando a cat<\/b> se o less<\/b> n\u00c3\u00a3o for encontrado ou n\u00c3\u00a3o for execut\u00c3\u00a1vel.<\/p>\n

O valor pode ser um simples nome de comando ou um comando com argumentos e pode usar cita\u00c3\u00a7\u00c3\u00b5es de shell (barras invertidas, aspas simples ou aspas duplas). N\u00c3\u00a3o pode usar t\u00c3\u00baneis para ligar v\u00c3\u00a1rios comandos; se for tal preciso, use um script, o que pode levar o ficheiro a ser visto como argumento ou na sa\u00c3da padr\u00c3\u00a3o.<\/p>\n

MANLESS<\/b><\/p>\n

Se $MANLESS<\/b> estiver definida, o seu valor ser\u00c3\u00a1 usado como cadeia de prompt predefinida do paginador less<\/b>, como se fosse passada como op\u00c3\u00a7\u00c3\u00a3o \u2212r<\/b> (quaisquer ocorr\u00c3\u00aancias de $MAN_PN<\/b> ser\u00c3\u00a3o expandidas da mesma forma). Por exemplo, se quiser definir a cadeia de prompt incondicionalmente para \u201cminha cadeia de prompt\u201d, defina $MANLESS<\/b> para \u2018\u2212Psminha\u00a0cadeia\u00a0de\u00a0prompt<\/b>\u2019. Usar a op\u00c3\u00a7\u00c3\u00a3o \u2212r<\/b> sobrep\u00c3\u00b5e\u2212se a esta vari\u00c3\u00a1vel de ambiente.<\/p>\n

BROWSER<\/b><\/p>\n

Se $BROWSER<\/b> estiver definida, o seu valor \u00c3\u00a9 uma lista de comandos separados por dois\u2212pontos, cada um dos quais \u00c3\u00a9 usado \u00c3\u00a0 vez para tentar iniciar um navegador web para o man \u2212\u2212html<\/b>. Em cada comando, %s<\/i> \u00c3\u00a9 substitu\u00c3do por um nome de ficheiro contendo a sa\u00c3da HTML do groff<\/b>, %%<\/i> \u00c3\u00a9 substitu\u00c3do por um \u00c3\u00banico sinal de percentagem (%) e %c<\/i> \u00c3\u00a9 substitu\u00c3do por dois\u2212pontos (:).<\/p>\n\n\n\n
<\/td>\n\n

SYSTEM<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Se $SYSTEM<\/b> estiver definido, ter\u00c3\u00a1 o mesmo efeito como se fosse especificado como argumento da op\u00c3\u00a7\u00c3\u00a3o \u2212m<\/b>.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

MANOPT<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Se $MANOPT<\/b> estiver definida, ser\u00c3\u00a1 analisada antes da linha de comandos do man<\/b> e \u00c3\u00a9 esperado que tenha um formato similar. Como todas as outras vari\u00c3\u00a1veis de ambiente espec\u00c3ficas do man<\/b> podem ser expressadas como op\u00c3\u00a7\u00c3\u00b5es de linha de comandos, sendo assim candidatas a serem inclu\u00c3das em $MANOPT<\/b>, espera\u2212se que se tornem obsoletas. Nota: todos os espa\u00c3\u00a7os que devam ser interpretados como parte do argumento da linha de comandos, t\u00c3\u00aam de ser escapados.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

MANWIDTH<\/b><\/p>\n

Se $MANWIDTH<\/b> estiver definida, o seu valor \u00c3\u00a9 usado como tamanho da linha para o qual as p\u00c3\u00a1ginas do manual devem ser formatadas. Sen\u00c3\u00a3o, ser\u00c3\u00a3o formatadas com um tamanho apropriado ao terminal actual (usando o valor de $COLUMNS<\/b>, e ioctl<\/b>(2) se dispon\u00c3vel, ou retornando a 80 caracteres se nenhuma estiver dispon\u00c3vel). As p\u00c3\u00a1ginas cat s\u00c3\u00b3 ser\u00c3\u00a3o gravadas quando se puder usar o formato predefinido, ou seja, quando o tamanho da linha do terminal esteja entre 66 e 80 caracteres.<\/p>\n

MAN_KEEP_FORMATTING<\/b><\/p>\n

Normalmente, quando a sa\u00c3da n\u00c3\u00a3o \u00c3\u00a9 direccionada para um terminal (vai para um ficheiro ou um t\u00c3\u00banel), os caracteres de formata\u00c3\u00a7\u00c3\u00a3o s\u00c3\u00a3o descartados para simplificar a leitura do resultado sem ferramentas especiais. Contudo, se $MAN_KEEP_FORMATTING<\/b> estiver definida para qualquer coisa diferente de um valor vazio, estes caracteres s\u00c3\u00a3o mantidos. Pode ser \u00c3\u00batil para programas acima do man<\/b> que possam interpretar caracteres de formata\u00c3\u00a7\u00c3\u00a3o.<\/p>\n

MAN_KEEP_STDERR<\/b><\/p>\n

Normalmente, quando a sa\u00c3da \u00c3\u00a9 direccionada para um terminal (habitualmente um paginador), qualquer erro de sa\u00c3da do comando usado para produzir vers\u00c3\u00b5es formatadas de p\u00c3\u00a1ginas do manual, \u00c3\u00a9 descartado para evitar interfer\u00c3\u00aancias com o paginador. Programas como o groff<\/b> produzem frequentemente mensagens de erro relativamente insignificantes sobre problemas tipogr\u00c3\u00a1ficos, tais como mau alinhamento, que s\u00c3\u00a3o invis\u00c3veis e geralmente causam confus\u00c3\u00a3o ao serem mostradas junto \u00c3\u00a0 p\u00c3\u00a1gina do manual. Contudo, alguns utilizadores querem v\u00c3\u00aa\u2212las mesmo assim, pelo que se $MAN_KEEP_STDERR<\/b> tiver um valor n\u00c3\u00a3o\u2212vazio, o erro de sa\u00c3da ser\u00c3\u00a1 sempre mostrado.<\/p>\n

LANG<\/b>, LC_MESSAGES<\/b><\/p>\n

Dependendo do sistema e da implementa\u00c3\u00a7\u00c3\u00a3o, ou uma ou ambas $LANG<\/b> e $LC_MESSAGES<\/b> ser\u00c3\u00a3o interrogadas sobre o idioma da mensagem actual. O man<\/b> mostrar\u00c3\u00a1 as suas mensagens nesse idioma (se dispon\u00c3vel). Veja setlocale<\/b>(3) para detalhes precisos.<\/p>\n

FICHEIROS <\/a> <\/h2>\n

\/etc\/man_db.conf<\/i><\/p>\n

ficheiro de configura\u00c3\u00a7\u00c3\u00a3o do man\u2212db.<\/p>\n

\/usr\/share\/man<\/i><\/p>\n

Uma hierarquia global de p\u00c3\u00a1ginas do manual.<\/p>\n

VEJA TAMB\u00c3M <\/a> <\/h2>\n

apropos<\/b>(1), groff<\/b>(1), less<\/b>(1), manpath<\/b>(1), nroff<\/b>(1), troff<\/b>(1), whatis<\/b>(1), zsoelim<\/b>(1), manpath<\/b>(5), man<\/b>(7), catman<\/b>(8), mandb<\/b>(8)<\/p>\n

A documenta\u00c3\u00a7\u00c3\u00a3o para alguns pacotes pode estar dispon\u00c3vel noutros formatos, tais como info<\/b>(1) ou HTML.<\/p>\n

HIST\u00c3RICO <\/a> <\/h2>\n

1990, 1991 \u2013 Originalmente escrito por John W. Eaton (jwe@che.utexas.edu).<\/p>\n

Dec 23 1992: Rik Faith (faith@cs.unc.edu) aplicou repara\u00c3\u00a7\u00c3\u00b5es de erros fornecidas por Willem Kasdorp (wkasdo@nikhefk.nikef.nl).<\/p>\n

30 de Abril de 1994 \u2013 23 de Fevereiro de 2000: Wilf. (G.Wilford@ee.surrey.ac.uk) tem vindo a desenvolver e manter este pacote com a ajuda de alguns indiv\u00c3duos dedicados.<\/p>\n

30 de Outubro de 1996 \u2013 30 de Mar\u00c3\u00a7o de 2001: Fabrizio Polacco manteve e melhorou este pacote para o projecto Debian, com a ajuda de toda a comunidade.<\/p>\n

31 de Mar\u00c3\u00a7o de 2001 \u2013 hoje em dia: Colin Watson mant\u00c3\u00a9m e desenvolve o pacote man\u2212db.<\/p>\n

ERROS <\/a> <\/h2>\n

https:\/\/savannah.nongnu.org\/bugs\/?group=man-db<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

MAN NOME SINOPSE DESCRI\u00c3\u00c3O EXEMPLOS RESUMO PREDEFINI\u00c3\u00c3ES OP\u00c3\u00c3ES ESTADO DE SA\u00c3DA AMBIENTE FICHEIROS VEJA TAMB\u00c3M HIST\u00c3RICO ERROS NOME man \u2212 um ambiente para os manuais de refer\u00c3\u00aancia do sistema SINOPSE man [man op\u00c3\u00a7\u00c3\u00b5es] [[sec\u00c3\u00a7\u00c3\u00a3o] p\u00c3\u00a1gina\u00a0…]\u00a0… man \u2212k [apropos op\u00c3\u00a7\u00c3\u00b5es] expreg … man \u2212K [man op\u00c3\u00a7\u00c3\u00b5es] [sec\u00c3\u00a7\u00c3\u00a3o] termo\u00a0… man \u2212f [whatis op\u00c3\u00a7\u00c3\u00b5ess] p\u00c3\u00a1gina … man \u2212l […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[962],"tags":[964,963,2594],"class_list":["post-5897","post","type-post","status-publish","format-standard","hentry","category-1-comandos-generales","tag-964","tag-man","tag-pt"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/5897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=5897"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/5897\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=5897"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=5897"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=5897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}