'\" t .\" ** The above line should force tbl to be a preprocessor ** .\" Man page for man .\" .\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.) .\" Copyright (C) 2001, 2002, 2003, 2006, 2007, 2008 Colin Watson. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file COPYING 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 MAN 1 2019-01-05 2.8.5 "Utilitários de paginação de manual" .SH NOME man \- uma interface para os manuais de referência on\-line .SH SINOPSE .\" The general command line .\" The apropos command line \fBman\fP [\|\fB\-C\fP \fIarquivo\fP\|] [\|\fB\-d\fP\|] [\|\fB\-D\fP\|] [\|\fB\-\-warnings\fP\|[\|=\fIavisos\fP\|]\|] [\|\fB\-R\fP \fIcodificação\fP\|] [\|\fB\-L\fP \fIlocalidade\fP\|] [\|\fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fIcaminho\fP\|] [\|\fB\-S\fP \fIlista\fP\|] [\|\fB\-e\fP \fIextensão\fP\|] [\|\fB\-i\fP\||\|\fB\-I\fP\|] [\|\fB\-\-regex\fP\||\|\fB\-\-wildcard\fP\|] [\|\fB\-\-names\-only\fP\|] [\|\fB\-a\fP\|] [\|\fB\-u\fP\|] [\|\fB\-\-no\-subpages\fP\|] [\|\fB\-P\fP \fIpaginador\fP\|] [\|\fB\-r\fP \fItexto\fP\|] [\|\fB\-7\fP\|] [\|\fB\-E\fP \fIcodificação\fP\|] [\|\fB\-\-no\-hyphenation\fP\|] [\|\fB\-\-no\-justification\fP\|] [\|\fB\-p\fP \fItexto\fP\|] [\|\fB\-t\fP\|] [\|\fB\-T\fP\|[\|\fIdispositivo\fP\|]\|] [\|\fB\-H\fP\|[\|\fInavegador\fP\|]\|] [\|\fB\-X\fP\|[\|\fIdpi\fP\|]\|] [\|\fB\-Z\fP\|] [\|[\|\fIseção\fP\|] \fIpágina\fP[.\|\fIseção\fP\|]\ \|.\|.\|.\|]\ .\|.\|.\& .br .\" The --global-apropos command line \fBman\fP \fB\-k\fP [\|\fIopções\fP \fIdo\fP \fIapropos\fP \|] \fIexpressão\-regular\fP \&.\|.\|.\& .br .\" The whatis command line \fBman\fP \fB\-K\fP [\|\fB\-w\fP\||\|\fB\-W\fP\|] [\|\fB\-S\fP \fIlista\fP\|] [\|\fB\-i\fP\||\|\fB\-I\fP\|] [\|\fB\-\-regex\fP\|] [\|\fIseção\fP\|] \fIterminal\fP\ .\|.\|.\& .br .\" The --local command line \fBman\fP \fB\-f\fP [\|\fIopções\fP \fIdo\fP \fIwhatis\fP\|] \fIpágina\fP \&.\|.\|.\& .br .\" The --where/--where-cat command line \fBman\fP \fB\-l\fP [\|\fB\-C\fP \fIarquivo\fP\|] [\|\fB\-d\fP\|] [\|\fB\-D\fP\|] [\|\fB\-\-warnings\fP\|[\|=\fIavisos\fP\|]\|] [\|\fB\-R\fP \fIcodificação\fP\|] [\|\fB\-L\fP \fIlocalidade\fP\|] [\|\fB\-P\fP \fIpaginador\fP\|] [\|\fB\-r\fP \fItexto\fP\|] [\|\fB\-7\fP\|] [\|\fB\-E\fP \fIcodificação\fP\|] [\|\fB\-p\fP \fItexto\fP\|] [\|\fB\-t\fP\|] [\|\fB\-T\fP\|[\|\fIdispositivo\fP\|]\|] [\|\fB\-H\fP\|[\|\fInavegador\fP\|]\|] [\|\fB\-X\fP\|[\|\fIdpi\fP\|]\|] [\|\fB\-Z\fP\|] \fIarquivo\fP \&.\|.\|.\& .br .\" The --catman command line \fBman\fP \fB\-w\fP\||\|\fB\-W\fP [\|\fB\-C\fP \fIarquivo\fP\|] [\|\fB\-d\fP\|] [\|\fB\-D\fP\|] \fIpaginador\fP \&.\|.\|.\& .br .\" --help and --version \fBman\fP \fB\-c\fP [\|\fB\-C\fP \fIarquivo\fP\|] [\|\fB\-d\fP\|] [\|\fB\-D\fP\|] \fIpágina\fP \&.\|.\|.\& .br \fBman\fP [\|\fB\-?V\fP\|] .SH DESCRIÇÃO \fBman\fP é o paginador de manual do sistema. Cada argumento \fIpágina\fP fornecido ao \fBman\fP é normalmente o nome de um programa, utilitário ou função. A \fIpágina de manual\fP associada com esses argumentos é, então, localizada e exibida. Uma \fIseção\fP, se fornecida, direcionará \fBman\fP para procurar apenas naquela \fIseção\fP do manual. A ação padrão é para pesquisar em todas as seções disponíveis seguindo a seguinte ordem pré\-definida ("1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7" por padrão, a menos que seja sobrescrita pela diretiva \fBSECTION\fP em \fI/etc/manpath.config\fP), e para mostrar apenas a primeira \fIpágina\fP localizada, mesmo se \fIpágina\fP existir em várias \fIseções\fP. A tabela abaixo mostra os números \fIseção\fP do manual seguido pelos tipos de páginas que eles contêm. .TS tab (@); l lx. 1@T{ Comandos shell ou programas executáveis T} 2@T{ Chamadas de sistema (funções fornecidas pelo kernel) T} 3@T{ Chamadas de biblioteca (funções dentro de bibliotecas de programa) T} 4@T{ Arquivos especiais (geralmente localizados em \fI/dev\/\fP) T} 5@T{ Formatos de arquivo e convenções (ex.: \fI/etc/passwd\fP) T} 6@T{ Jogos T} 7@T{ Miscelânea (incluindo convenções e pacotes macro), (ex.: \& \fBman\fP(7), \fBgroff\fP(7)) T} 8@T{ Comandos de administração do sistema (geralmente apenas para root) T} 9@T{ Rotinas do kernel [\|não padrão\|] T} .TE Uma \fIpágina\fP de manual consiste em várias seções. Nomes de seção convencional incluem \fBNAME\fP, \fBSYNOPSIS\fP, \fBCONFIGURATION\fP, \fBDESCRIPTION\fP, \fBOPTIONS\fP, \fBEXIT\ STATUS\fP, \fBRETURN\ VALUE\fP, \fBERRORS\fP, \fBENVIRONMENT\fP, \fBFILES\fP, \fBVERSIONS\fP, \fBCONFORMING\ TO\fP, \fBNOTES\fP, \fBBUGS\fP, \fBEXAMPLE\fP, \fBAUTHORS\fP e \fBSEE\ ALSO\fP. As convenções a seguir se aplicam à seção \fBSYNOPSIS\fP e podem ser usadas como uma guia em outras seções. .TS tab (@); l lx. \fBtexto em negrito\fP@T{ digite exatamente como mostrado. T} \fItexto em itálico\fP@T{ substitua com o argumento apropriado. T} [\|\fB\-abc\fP\|]@T{ qualquer ou todos os argumentos dentro de [ ] são opcionais. T} \fB\-a\|\fP|\|\fB\-b\fP@T{ opções delimitadas por | não podem ser usadas juntas. T} \fIargumento\fP .\|.\|.@T{ \fIargumento\fP é repetível. T} [\|\fIexpressão\fP\|] .\|.\|.@T{ toda a \fIexpressão\fP\ dentro [ ] é repetível. T} .TE Renderização exata pode variar dependendo do dispositivo de saída. Por exemplo, man geralmente não é capaz de renderizar itálicos ao ser executado em um terminal e normalmente usará um texto sublinhado ou colorizado. A ilustração de comando ou função é um padrão que deve corresponder a todas invocações possíveis. Em alguns casos, é recomendável ilustrar invocações exclusivas como é mostrar na seção \fBSYNOPSIS\fP desta página de manual. .SH EXEMPLOS .TP \w'man\ 'u \fBman\fP\fI\ ls\fP Exibe a página de manual para o \fIitem\fP (programa) \fIls\fP. .TP \fBman \fP\fIman\fP.\fI7\fP Exibe a página de manual para o pacote macro \fIman\fP para a seção \fI7\fP. .TP \fBman\ \-a\fP\fI\ intro\fP Exibe, em sucessão, todas as páginas de manual de \fIintro\fP disponíveis contidos no manual. É possível sair entre exibições sucessivas ou pular qualquer uma delas. .TP \fBman \-t \fP\fIapelido \fP|\fI lpr \-Pps\fP Formata a página de manual referenciada por "\fIapelido\fP", geralmente uma página de manual shell, em um formato padrão \fBtroff\fP ou \fBgroff\fP e redireciona\-o para o nome da impressora \fIps\fP. A saída padrão para \fBgroff\fP geralmente é PostScript. \fBman \-\-help\fP deve avisar sobre qual processador está vinculado à opção \fB\-t\fP. .TP \fBman \-l \-T\fP\fIdvi ./foo.1x.gz\fP\fB > \fP\fI./foo.1x.dvi\fP Esse comando vai descomprimir e formatar a página de manual fonte nroff \&\fI./foo.1x.gz\fP em um arquivo \fBdevice independent (dvi)\fP. O redirecionamento é necessária, pois a opção \fB\-T\fP causa a saída ser direcionada à \fBstdout\fP (saída padrão) com nenhum paginador. A saída pode ser visto com um programa tal como \fBxdvi\fP ou processado para PostScript usando um programa como \fBdvips.\fP .TP \fBman\ \-k\fP\fI\ printf\fP Pesquisa por descrições curtas e nomes de páginas de manual para a palavra\-chave \fIprintf\fP como expressão regular. Emite qualquer correspondência. Equivalente a \fBapropos\fP\fI\ printf\fP\fB.\fP .TP \fBman\ \-f\fP\fI\ smail\fP Procura as páginas de manual referenciadas por \fIsmail\fP e imprime as descrições curtas de qualquer uma que tenha sido localizada. Equivalente a \fBwhatis\fP\fI\ smail\fP\fB.\fP .SH "VISÃO GERAL" Muitas opções estão disponíveis para \fBman\fP para fornecer tanta flexibilidade quanto for possível para o usuário. Alterações podem ser feitas ao caminho de pesquisa, ordem de seção, processador de saída e outros comportamentos e operações detalhados abaixo. Se definidas, várias variáveis de ambiente serão interrogadas para determinar a operação do \fBman\fP. É possível definir a variável "mãe" $\fBMANOPT\fP para qualquer texto no formato de linha de comando com a exceção de que quaisquer espaços usados como parte de um argumento da opção devem ser escapado (precedido por uma barra invertida). \fBman\fP analisará $\fBMANOPT\fP antes de analisar sua própria linha de comando. Aquelas opções exigindo um argumento serão sobrescritas pelas mesmas opções localizadas na linha de comando. Para redefinir todas as opções em $\fBMANOPT\fP, \fB\-D\fP pode ser especificada como uma opção inicial de linha comando. Isso vai permitir que man "esqueça" sobre as opções especificadas em $\fBMANOPT\fP, apesar delas ainda precisarem ser válidas. Os utilitários de paginação de manual empacotados como \fBman\-db\fP fazem uso extensivo dos caches de banco de dados \fBindex\fP. Esses caches contêm informações como, por exemplo, onde cada página de manual pode ser localizada no sistema de arquivos e o que seu \fIwhatis\fP (descrição curta de uma linha das páginas de manual), e permite que \fBman\fP execute mais rapidamente do que se ele tivesse que pesquisar no sistema de arquivos toda vez para localizar a página de manual apropriada. Se requisitado o uso da opção \fB\-u\fP, \fBman\fP vai assegurar que os caches permaneçam consistentes, o que pode evitar a necessidade de executar manualmente software para atualizar os tradicionais bancos de dados de texto do \fIwhatis\fP. .\"`User' manual page hierarchies will have .\".B index .\"caches created `on the fly'. Se \fBman\fP não puder localizar um banco de dados \fBindex\fP iniciado pelo \fBmandb\fP para uma hierarquia de páginas de manual em particular, ele ainda pode pesquisar pelas páginas de manual, apesar de que uma busca por arquivos será necessária para pesquisar dentro daquela hierarquia. Se \fBwhatis\fP ou \fBapropos\fP falhar em localizar um \fBindex\fP, ele tentará extrair informações a partir de um banco de dados tradicional do \fIwhatis\fP. Esses utilitários oferecem suporte a arquivos\-fonte nroff comprimidos tendo, por padrão, as extensões de \fB.Z\fP, \fB.z\fP e \fB.gz\fP. É possível lidar com qualquer extensão comprimida, mas essas informações devem ser conhecidas em tempo de compilação. Também, por padrão, qualquer página cat produzida é comprimida usando \fBgzip\fP. Cada hierarquia "global" de página de manual, tal como \fI/usr/share/man\fP ou \fI/usr/X11R6/man\fP, pode conter qualquer diretório como sua hierarquia de diretório cat. Tradicionalmente, as páginas cat são armazenadas sob a mesma hierarquia que as páginas man, mas, por motivos como aqueles especificados no \fBFilesystem Hierarchy Standard (FHS)\fP (Padrão de Hierarquia de Sistema de Arquivos), pode ser melhor armazená\-los em outro lugar. Para detalhes sobre como fazer isso, por favor leia \fBmanpath\fP(5). Para detalhes sobre como fazer isso, leia o padrão. Suporte internacional está disponível com esse pacote. Páginas de manual com idiomas nativos estão acessíveis (se disponível sem seu sistema) por meio do uso de funções de \fIlocalidade\fP. Para ativar tal suporte, é necessário definir $\fBLC_MESSAGES\fP, $\fBLANG\fP ou outra variável de ambiente dependente do sistema para a localidade de seu idioma, geralmente especificado no formato baseado no \fBPOSIX 1003.1\fP: .\" .\" Need a \c to make sure we don't get a space where we don't want one .\" <\fIidioma\fP>[\|\fB_\fP<\fIterritório\fP>\|[\|\fB.\fP<\fIconjunto\-de\-caracteres\fP>\|[\|\fB,\fP<\fIversão\fP>\|]\|]\|] Se a página desejada estiver disponível em sua \fIlocalidade\fP, ela será exibida em vez da página padrão (geralmente, inglês americano). Suporte a catálogos internacionais de mensagens também é disponibilizado por este pacote e pode ser ativado da mesma forma, novamente, se disponível. Se você descobrir que as páginas de manual e catálogos de mensagens fornecidos com este pacote não estejam disponíveis em seu idioma nativo e gostaria de fornecê\-los, por favor contate o mantenedor que estará coordenando tal atividade. Para informações a respeito de outros recursos e extensões disponíveis com este paginador de manual, por favor leia os documentos fornecidos com o pacote. .SH PADRÕES \fBman\fP vai pesquisar pelas páginas de manual desejadas dentro dos caches de banco de dados \fIindex\fP. Se a opção \fB\-u\fP for fornecida, uma verificação de consistência do cache é realizada para assegurar de que os bancos de dados reflitam precisamente o sistema de arquivos. Se essa opção sempre for fornecida, geralmente não é necessário executar \fBmandb\fP após os caches terem sido inicialmente criados, a menos que um cache tenha se corrompido. Porém, a verificação de consistência do cache pode ser lenta em sistemas com muitas páginas de manual instaladas, então ela não é executada por padrão, e administradores de sistema podem preferir executar \fBmandb\fP toda semana ou mais para manter os caches de banco de dados atualizados. Para se evitar problemas causados por caches não atualizados, \fBman\fP voltará para busca por arquivos se uma procura no cache falhar, exatamente como faria se não houvesse cache presente. Uma vez que uma página de manual tenha sido localizada, uma verificação é realizada para descobrir se um arquivo "cat" relativo pré\-formatado já existe e é mais novo que o arquivo nroff. Se ele existe e é mais novo, esse arquivo pré\-formatado (geralmente) é descomprimido e, então, exigido usando um paginador. O paginador pode ser especificado de várias formas ou senão um padrão é usado (veja a opção \fB\-P\fP para detalhes). Se nenhum cat for localizado ou é mais antigo que o arquivo nroff, o nroff é filtrado por meio de vários programas e é mostrado imediatamente. Se um arquivo cat puder ser produzido (um diretório cat relativo existe e possui permissões apropriadas), \fBman\fP vai comprimir e armazenar o arquivo cat em plano de fundo. Os filtros são decifrados por várias formas. Primeiramente, a opção de linha de comando \fB\-p\fP ou a variável de ambiente $\fBMANROFFSEQ\fP é interrogada. Se \fB\-p\fP não foi usada e a variável de ambiente não foi definida, a linha inicial do arquivo nroff é analisada para um texto de pré\-processador. Para conter um texto válido de pré\-processador, a primeira linha deve se parecer com \&\fB'\e"\fP <\fBtexto\fP> onde \fBtexto\fP pode ser qualquer combinação de letras descritas pela opção \fB\-p\fP abaixo. Se nenhum dos métodos acima fornece qualquer informação de filtro, uma definição padrão é usada. .\" ******************************************************************** Um fluxo de formatação é formado a partir dos filtros e o formatador primário (\fBnroff\fP ou [\fBtg\fP]\fBroff\fP com \fB\-t\fP) é executado. Alternativamente, se um programa executável \fImandb_nfmt\fP (ou \fImandb_tfmt\fP com \fB\-t\fP) existir na árvore raiz do man, ele é executado. É passado o arquivo\-fonte do manual, o texto de pré\-processador e, opcionalmente, o dispositivo especificado com \fB\-T\fP ou \fB\-E\fP como argumentos. .SH OPÇÕES Opções não\-argumentos que são duplicadas na linha de comando, em $\fBMANOPT\fP ou ambos, não são prejudiciais. Para opções que exigem um argumento, cada duplicação sobrescreverá o valor do argumento anterior. .SS "Opções gerais" .TP \fB\-C\ \fP\fIarquivo\fP,\ \fB\-\-config\-file=\fP\fIarquivo\fP Use esse arquivo de configuração de usuário em vez do padrão \fI~/.manpath\fP. .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Emite mensagens de depuração. .TP .if !'po4a'hide' .BR \-D ", " \-\-default Essa opção normalmente é chamada como a primeira opção e redefine o comportamento do \fBman\fP para seu padrão. Seu uso é redefinir aquelas opções que podem ter sido definidas no $\fBMANOPT\fP. Quaisquer opções que segue \fB\-D\fP terão seu efeito comum. .TP \fB\-\-warnings\fP[=\fIavisos\/\fP] Habilita avisos do \fIgroff\fP. Isso pode ser usado para realizar verificações de sanidade no texto fonte de páginas de manual. \fIavisos\fP é uma lista separada por vírgulas de nomes de avisos; se ela não for fornecida, o padrão é "mac". Veja o nó \(lqWarnings\(rq em \fBinfo groff\fP para uma lista de nomes de avisos disponíveis. .SS "Modos principais de operação" .TP .if !'po4a'hide' .BR \-f ", " \-\-whatis Equivalente a \fBwhatis\fP. Exibe uma descrição curta da página de manual, se disponível. Veja \fBwhatis\fP(1) para detalhes. .TP .if !'po4a'hide' .BR \-k ", " \-\-apropos Equivalente a \fBapropos\fP. Pesquisa as descrições curtas de página de manual para palavras\-chave e exibe quaisquer correspondências. Veja \fBapropos\fP(1) para detalhes. .TP .if !'po4a'hide' .BR \-K ", " \-\-global\-apropos Pesquisa por texto em todas as páginas de manual. Essa é uma pesquisa de força bruta, e é provável que leve algum tempo; se possível, você deveria especificar uma seção para reduzir o número de páginas que precisam ser pesquisadas. Termos de pesquisa podem ser textos simples (o padrão) ou expressões regulares se a opção \fB\-\-regex\fP for usada. .IP Note que isso pesquisa os \fIfontes\fP das páginas de manual, não o texto renderizado e, portanto, pode incluir falso positivos em razão de coisas como comentários nos arquivos\-fontes. Pesquisar o texto renderizado seria ainda mais lento. .TP .if !'po4a'hide' .BR \-l ", " \-\-local\-file .\" Compressed nroff source files with a supported compression .\" extension will be decompressed by man prior to being displaying via the .\" usual filters. Ativa modo "local". Formata e exibe arquivos locais de manual em vez de pesquisar na coleção de manuais do sistema. Cada argumento de página de manual será interpretado como um arquivo\-fonte nroff no formato correto. Nenhum arquivo cat é produzido. Se "\-" é listado como um dos argumentos, a entrada será obtida de stdin (entrada padrão). Quando essa opção não é usada, e o man falha em localizar a página solicitada, antes de exibir a mensagem de erro, ele tenta agir como se essa opção tivesse sido fornecida, usando o nome como um nome de arquivo e procurando por uma correspondência exata. .TP .if !'po4a'hide' .BR \-w ", " \-\-where ", " \-\-path ", " \-\-location Não exatamente exibe as páginas de manual, mas não imprime as localizações dos arquivos\-fonte nroff que seria formatadas. .TP .if !'po4a'hide' .BR \-W ", " \-\-where\-cat ", " \-\-location\-cat Não exatamente exibe as páginas de manual, mas não imprime as localizações dos arquivos cat que seriam exibidos. Se \-w e \-W forem ambos especificados, imprime ambos separados por um espaço. .TP .if !'po4a'hide' .BR \-c ", " \-\-catman Essa opção não é para uso geral e deveria ser usado apenas pelo programa \fBcatman\fP. .TP \fB\-R\ \fP\fIcodificação\fP,\ \fB\-\-recode\fP=\fIcodificação\fP Em vez de formatar a página de manual na forma normal, emite seu fonte convertido para a \fIcodificação\fP especificada. Se você já sabe a codificação do arquivo fonte, você também pode usar \fBmanconv\fP(1) diretamente. Porém, essa opção permite que você converta várias páginas de manual para uma única codificação sem ter que declarar explicitamente a codificação de cada uma, desde que elas já tenham sido instaladas em uma estrutura similar a uma hierarquia de página de manual. .SS "Localizando as páginas de manual" .TP \fB\-L\ \fP\fIlocalidade\fP,\ \fB\-\-locale=\fP\fIlocalidade\fP .\" .\" Due to the rather silly limit of 6 args per request in some `native' .\" *roff compilers, we have do the following to get the two-line .\" hanging tag on one line. .PP to begin a new paragraph, then the .\" tag, then .RS (start relative indent), the text, finally .RE .\" (end relative indent). .\" \fBman\fP geralmente vai determinar sua localidade atual por uma chamada à função C \fBsetlocale\fP(3), a qual pergunta a várias variáveis de ambiente, possibilitando incluir $\fBLC_MESSAGES\fP e $\fBLANG\fP. Para temporariamente substituir o valor determinado, use essa opção para fornecer uma \fIlocalidade\fP diretamente para \fBman\fP. 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. .PP \fB\-m\fP \fIsistema\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIsistema\fP\|[\|,.\|.\|.\|] .RS Se esse sistema possui acesso às páginas de manual de outro sistema operacional, é possível acessá\-las usando essa opção. Para pesquisar por uma página de manual da coleção de páginas de manual do NewOS, use a opção \fB\-m\fP \fBNewOS\fP. O \fIsistema\fP especificado pode ser uma combinação de nomes de sistemas operacionais delimitados por vírgula. Para incluir uma pesquisa às páginas de manual do sistema operacional nativo, inclua \fBman\fP como nome do sistema no texto do argumento. Essa opção vai sobrescrever a variável de ambiente $\fBSYSTEM\fP. .RE .TP \fB\-M\ \fP\fIcaminho\fP,\ \fB\-\-manpath=\fP\fIcaminho\fP Especifica um caminho man a ser usado. Por padrão, \fBman\fP usa código derivado de \fBmanpath\fP para determinar o caminho a ser pesquisado. Essa opção sobrescreve a variável de ambiente $\fBMANPATH\fP e causa a opção \fB\-m\fP a ser ignorada. O caminho especificado como um caminho man deve ser a raiz de uma hierarquia estruturada de página de manual para as seções conforme descrito no manual de man\-db (sob "The manual page system"). Para visualizar páginas de manual fora de tais hierarquias, veja a opção \fB\-l\fP. .TP \fB\-S\ \fP\fIlista\fP,\ \fB\-s\ \fP\fIlista\fP,\ \fB\-\-sections=\fP\fIlista\fP Lista é uma lista separada por caractere de vírgula ou de dois pontos com seções de manual de "ordem específica" para pesquisa. Essa opção sobrescreve a variável de ambiente $\fBMANSECT\fP. (A alternativa \fB\-s\fP é para compatibilidade com System V.) .TP \fB\-e\ \fP\fIsubextensão\fP,\ \fB\-\-extension=\fP\fIsubextensão\fP Alguns sistemas incorporam pacotes grandes de páginas de manual, como aquelas que acompanham o pacote \fBTcl\fP, à hierarquia principal de páginas de manual. Para contornar o problema de ter duas páginas de manual com o mesmo nome como \fBexit\fP(3), as páginas \fBTcl\fP geralmente eram atribuídas à seção \fBl\fP. Como isso não é uma boa ideia, agora é possível colocar as páginas na seção correta, e atribuir uma "extensão" específica a elas (ex.: \fBexit\fP(3tcl). Sob operação normal, \fBman\fP exibirá \fBexit\fP(3) como preferência em relação a \fBexit\fP(3tcl). Para negociar essa situação e para evitar de ter que saber em qual seção de página você deseja está, agora é possível fornecer ao \fBman\fP um texto \fIsubextensão\fP indicando a qual pacote a página deve pertencer. Usando o exemplo acima, fornecer a opção \fB\-e\ tcl\fP para \fBman\fP vai restringir a pesquisa a páginas tendo uma extensão de \fB*tcl\fP. .TP .if !'po4a'hide' .BR \-i ", " \-\-ignore\-case Ignora diferença maiúsculo/minúsculo para páginas de manual. Esse é o padrão. .TP .if !'po4a'hide' .BR \-I ", " \-\-match\-case Pesquisa por páginas de manual diferenciando maiúsculo/minúsculo. .TP .if !'po4a'hide' .B \-\-regex Mostra todas as páginas com qualquer parte de seus nomes ou suas descrições correspondendo a cada argumento de \fIpágina\fP como uma expressão regular, como ocorre com \fBapropos\fP(1). Já que geralmente não há uma forma razoável de pegar a "melhor" página ao pesquisar por uma expressão regular, essa opção resulta em \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-wildcard Mostra todas as páginas com qualquer parte de seus nomes ou suas descrições correspondendo a cada argumento de \fIpágina\fP usando caracteres curingas do tipo shell, como ocorre com a opção \fB\-\-wildcard\fP de \fBapropos\fP(1). O argumento de \fIpágina\fP deve corresponder ao nome completo ou descrição completa, ou corresponder a limites de uma palavra na descrição. Já que geralmente não há uma forma razoável de pegar a "melhor" página ao pesquisar por um curinga, essa opção resulta em \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-names\-only Se a opção \fB\-\-regex\fP ou \fB\-\-wildcard\fP for usada, corresponde apenas a nomes de páginas, e não a descrições de páginas, como ocorre com \fBwhatis\fP(1). Do contrário, nenhum efeito. .TP .if !'po4a'hide' .BR \-a ", " \-\-all Por padrão, \fBman\fP sairá após exibir a página de manual encontrada que seja mais adequada. Usar essa opção força \fBman\fP a exibir todas as páginas de manual com nomes que correspondam aos critérios de pesquisa. .TP .if !'po4a'hide' .BR \-u ", " \-\-update Essa opção faz com que \fBman\fP realize uma verificação de consistência a "nível de inode" em seus caches de banco de dados para garantir que eles sejam uma representação fiel do sistema de arquivos. Ele apenas terá um efeito útil se \fBman\fP estiver instalado com o bit de setuid definido. .TP .if !'po4a'hide' .B \-\-no\-subpages Por padrão, \fBman\fP tentará interpretar pares de nomes de página de manual fornecidos na linha de comando como equivalentes a um único nome de página de manual contendo um hífen ou sublinhado. Isso oferece suporte ao padrão comum de programas que implementam uma gama de subcomandos, permitindo\-lhes fornecer páginas de manual para cada um que possam ser acessadas usando sintaxe similar ao que seria usado para invocar os próprios subcomandos. Por exemplo: .nf .if !'po4a'hide' \& $ man \-aw git diff .if !'po4a'hide' \& /usr/share/man/man1/git\-diff.1.gz .fi Para desabilitar esse comportamento, use a opção \fB\-\-no\-subpages\fP. .nf .if !'po4a'hide' \& $ man \-aw \-\-no\-subpages git diff .if !'po4a'hide' \& /usr/share/man/man1/git.1.gz .if !'po4a'hide' \& /usr/share/man/man3/Git.3pm.gz .if !'po4a'hide' \& /usr/share/man/man1/diff.1.gz .fi .SS "Controlando saída formatada" .TP \fB\-P\ \fP\fIpaginador\fP,\ \fB\-\-pager=\fP\fIpaginador\fP Especifica qual paginador de saída deve ser usado. Por padrão, \fBman\fP usa \fBpager\fP, usando subsidiariamente o \fBcat\fP se o \fBpager\fP for localizado ou for um executável. Essa opção sobrescreve a variável de ambiente $\fBMANPAGER\fP, a qual, por sua vez, sobrescreve a variável de ambiente $\fBPAGER\fP. Ela não é usada em conjunto com \fB\-f\fP ou \fB\-k\fP. Esse valor pode ser um único nome de comando ou um comando com argumentos, e pode usar barra invertida, aspas simples ou aspas duplas, como no shell. Ele não pode usar "pipes" para conectar múltiplos comandos; se você precisar disso, use um script "wrapper", que pode levar o arquivo e exibir como um argumento ou na entrada padrão. .TP \fB\-r\ \fP\fIprompt\fP,\ \fB\-\-prompt=\fP\fIprompt\fP Se uma versão recente do \fBless\fP for usada como paginador, \fBman\fP tentará definir seu prompt e algumas opções sensíveis. O prompt padrão se parece como \fB\ Manual pagel\fP\fI\ nome\fP\fB(\fP\fIseção\fP\fB)\fP\fB\ line\fP\fI\ x\fP .\"The default options are .\".BR \-six8 . .\"The actual default will depend on your chosen .\".BR locale . sendo que \fInome\fP denota o nome da página de manual, \fIseção\fP denota a seção que foi localizada sob a qual foi localizada e \fIx\fP é o número da linha atual. Isso é alcançado usando a variável de ambiente $\fBLESS\fP. .\"You may need to do this if your .\"version of .\".B less .\"rejects the default options or if you prefer a different prompt. Fornecer \fB\-r\fP com um texto sobrescreverá esse padrão. O texto pode conter \fB$MAN_PN\fP que será expandido para o nome da página manual atual e o nome de sua seção envolto por "(" e ")". O texto usado para produzir o padrão poderia se expressado como \fB\e\ Manual\e\ page\e\ \e$MAN_PN\e\ ?ltline\e\ %lt?L/%L.:\fP .br \fBbyte\e\ %bB?s/%s..?\e\ (END):?pB\e\ %pB\e\e%..\fP .br \fB(press h for help or q to quit)\fP Ele é quebrado aqui em três linhas apenas para melhor legibilidade. Para seu significado, veja a página de manual do \fBless\fP(1). O texto do prompt é primeiro avaliado pelo shell. Todas as ocorrências de aspa dupla, acento grave e barra invertida no prompt devem ser escapadas por uma barra invertida. O texto do prompt pode terminar em um $ escapado, o qual pode ser seguido por outras opções para o less. Por padrão \fBman\fP define as opções \fB\-ix8\fP. A variável de ambiente $\fBMANLESS\fP descrita abaixo pode ser usada para definir um texto padrão de prompt se nenhuma for fornecida na linha de comando. .TP .if !'po4a'hide' .BR \-7 ", " \-\-ascii Ao visualizar uma página de manual em \fIascii\fP(7) puro em um terminal de 7 bits ou emulador de terminal, alguns caracteres podem não ser exibidos corretamente quando se usa a descrição de dispositivo com \fIlatin1\fP(7) com \fBGNU\fP \fBnroff\fP. Essa opção permite que páginas de manual em \fIascii\fP puro seja exibidas em \fIascii\fP com o dispositivo \fIlatin1\fP. Nenhum texto em \fIlatin1\fP será traduzido. A tabela a seguir mostra as traduções realizadas: algumas partes dela só podem ser exibidas adequadamente usando um dispositivo \fIlatin1\fP(7) do \fBGNU\fP \fBnroff\fP. .ie c \[shc] \ . ds softhyphen \[shc] .el \ . ds softhyphen \(hy .na .TS tab (@); l c c c. Descrição@Octal@latin1@ascii _ T{ hífen de continuação T}@255@\*[softhyphen]@- T{ ponto lista (ponto no meio) T}@267@\(bu@o T{ acento agudo T}@264@\(aa@' T{ sinal de multiplicação T}@327@\(mu@x .TE .ad Se a coluna em \fIlatin1\fP é exibida corretamente, seu terminal pode estar configurado para caracteres \fIlatin1\fP e essa opção não é necessária. Se as colunas \fIlatin1\fP e \fIascii\fP são idênticas, você está lendo essa página usando essa opção ou \fBman\fP não formatou essa página usando uma descrição de dispositivo \fIlatin1\fP. Se a coluna \fIlatin1\fP estiver faltando ou corrompida, você pode precisar ver as páginas de manual com essa opção. Essa opção é ignorada ao usar as opções \fB\-t\fP, \fB\-H\fP, \fB\-T\fP ou \fB\-Z\fP e pode ser inútil para \fBnroff\fP que não seja do \fBGNU\fP. .TP \fB\-E\ \fP\fIcodificação\fP,\ \fB\-\-encoding\fP=\fIcodificação\fP Gera a saída para uma codificação de caracteres diversa do padrão. Para compatibilidade reversa, \fIcodificação\fP pode ser um dispositivo \fBnroff\fP tal como \fBascii\fP, \fBlatin1\fP ou \fButf8\fP assim como uma codificação de caracteres de verdade, como \fBUTF\-8\fP. .TP .if !'po4a'hide' .BR \-\-no\-hyphenation ", " \-\-nh Normalmente, \fBnroff\fP vai hifenizar automaticamente o texto na quebra de linha mesmo em palavras que não contêm hífenes, se isso for necessário para manter palavras em uma linha sem espaçamento excessivo. Essa opção desabilita hifenização automática, de forma que as palavras serão hifenizadas somente se elas já contiverem hífenes. Se você está escrevendo uma página de manual e só deseja evitar que \fBnroff\fP hifenize uma palavra em um ponto inapropriado, não use essa opção; em vez disso, consulte a documentação do \fBnroff\fP. Por exemplo, você pode colocar "\e%" dentro de uma palavra para indicar que ela pode ser hifenizada naquele ponto ou colocar "\e%" no começo de uma palavra para evitar que ela seja hifenizada. .TP .if !'po4a'hide' .BR \-\-no\-justification ", " \-\-nj Normalmente, \fBnroff\fP justificará automaticamente um texto em ambas margens. Essa opção desabilita toda justificação, deixando como justificada apenas a margem esquerda, o que é chamado de texto "ragged\-right" em inglês. Se você está escrevendo uma página de manual e só deseja evitar que \fBnroff\fP justifique certos parágrafos, não use essa opção; em vez disso, consulte a documentação do \fBnroff\fP. Por exemplo, você pode usar as requisições ".na", ".nf", ".fi" e ".ad" para temporariamente desabilitar ajuste de preenchimento. .TP \fB\-p\ \fP\fItexti\fP,\ \fB\-\-preprocessor=\fP\fItexto\fP Especifica a sequência de pré\-processadores a serem executados antes de \fBnroff\fP ou \fBtroff\fP/\fBgroff\fP. Nem todas instalações terão um conjunto completo de pré\-processadores. Alguns dos pré\-processadores e das letras usadas para designá\-los são: \fBeqn\fP (\fBe\fP), \fBgrap\fP (\fBg\fP), \fBpic\fP (\fBp\fP), \fBtbl\fP (\fBt\fP), \fBvgrind\fP (\fBv\fP), \fBrefer\fP (\fBr\fP). Essa opção sobrescreve a variável de ambiente $\fBMANROFFSEQ\fP. \fBzsoelim\fP é sempre executado como o primeiro pré\-processador. .TP .if !'po4a'hide' .BR \-t ", " \-\-troff Usa \fIgroff -mandoc\fP para formatar a página manual para stdout (saída padrão). Essa opção não é necessária em conjunto com \fB\-H\fP, \fB\-T\fP ou \fB\-Z\fP. .TP \fB\-T\fP[\fIdispositivo\/\fP], \fB\-\-troff\-device\fP[=\fIdispositivo\/\fP] Essa opção é usada para alterar a saída do \fBgroff\fP (ou, possivelmente, \fBtroff\fP) para ser adequado para um dispositivo diferente do padrão. Essa opção resulta em \fB\-t\fP. Exemplos (com Groff\-1.17) incluem \fBdvi\fP, \fBlatin1\fP, \fBps\fP, \fButf8\fP, \fBX75\fP e \fBX100\fP. .TP \fB\-H\fP[\fInavegador\/\fP], \fB\-\-html\fP[=\fInavegador\/\fP] Essa opção fará com que \fBgroff\fP produza uma saída HTML e exiba\-a em um navegador web. A escolha do navegador é determinada pelo argumento opcional \fInavegador\fP, caso este seja fornecido, obtido pela variável de ambiente $\fBBROWSER\fP ou por um padrão em tempo de compilação, se a primeira alternativa não estiver definida (geralmente \fBlynx\fP). Essa opção resulta em \fB\-t\fP e funcionará apenas com o \fBGNU\fP \fBtroff\fP. .TP \fB\-X\fP[\fIdpi\/\fP], \fB\-\-gxditview\fP[=\fIdpi\/\fP] Essa opção exibe a saída de \fBgroff\fP em uma janela gráfica usando o programa \fBgxditview\fP. O \fIdpi\fP (pontos por polegada ou, em inglês, "dots per inch") pode ser 75, 75\-12, 100 ou 100\-12, tendo como padrão o 75; as variantes \-12 usam uma fonte de base de 12 pontos. Essa opção resulta em \fB\-T\fP com o dispositivo X75, X75\-12, X100 ou X100\-12, respectivamente. .TP .if !'po4a'hide' .BR \-Z ", " \-\-ditroff \fBgroff\fP executará \fBtroff\fP e, então, usará um pós\-processador adequado para produzir uma saída adequada para o dispositivo escolhido. Se \fIgroff -mandoc\fP for \fBgroff\fP, essa opção é passada para \fBgroff\fP e suprimirá o uso de um pós\-processador. Ela resulta em \fB\-t\fP. .SS "Obtendo ajuda" .TP .if !'po4a'hide' .BR \-? ", " \-\-help Imprime uma mensagem de ajuda e sai. .TP .if !'po4a'hide' .BR \-\-usage Imprime uma mensagem curta e sai. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Exibe informação da versão. .SH "STATUS DE SAÍDA" .TP .if !'po4a'hide' .B 0 Execução com sucesso do programa. .TP .if !'po4a'hide' .B 1 Erro de uso, de sintaxe ou no arquivo de configuração. .TP .if !'po4a'hide' .B 2 Erro operacional. .TP .if !'po4a'hide' .B 3 Um processo filho retornou um status de saída diferente de zero. .TP .if !'po4a'hide' .B 16 Pelo menos uma das páginas, palavras\-chaves ou arquivos não existem ou não correspondeu. .SH AMBIENTE .\".TP \w'MANROFFSEQ\ \ 'u .TP .if !'po4a'hide' .B MANPATH Se $\fBMANPATH\fP estiver definido, seu valor é usado como o caminho a ser pesquisado por páginas de manual. .TP .if !'po4a'hide' .B MANROFFOPT O conteúdo de $\fBMANROFFOPT\fP é adicionado à linha de comando toda vez em que \fBman\fP invoca o formatador (\fBnroff\fP, \fBtroff\fP ou \fBgroff\fP). .TP .if !'po4a'hide' .B MANROFFSEQ Se $\fBMANROFFSEQ\fP estiver definido, seu valor é usado para determinar o conjunto de pré\-processadores por meio do qual será passada cada página de manual. A lista padrão de pré\-processadores depende do sistema. .TP .if !'po4a'hide' .B MANSECT Se $\fBMANSECT\fP estiver definido, seu valor é uma lista delimitada por caractere de dois pontos contendo seções que é usada para determinar quais seções de manual devem ser pesquisadas e em qual ordem. O padrão é "1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7", a menos que seja sobrescrito pela diretiva \fBSECTION\fP em \fI/etc/manpath.config\fP. .TP .if !'po4a'hide' .BR MANPAGER , " PAGER" Se $\fBMANPAGER\fP ou $\fBPAGER\fP estiverem definidos ($\fBMANPAGER\fP é usado preferencialmente), seu valor é usado como o nome do programa para exibir a página de manual. Por padrão, \fBpager\fP é usado, usando subsidiariamente o \fBcat\fP se o \fBpager\fP for localizado ou for um executável. Esse valor pode ser um único nome de comando ou um comando com argumentos, e pode usar barra invertida, aspas simples ou aspas duplas, como no shell. Ele não pode usar "pipes" para conectar múltiplos comandos; se você precisar disso, use um script "wrapper", que pode levar o arquivo e exibir como um argumento ou na entrada padrão. .TP .if !'po4a'hide' .B MANLESS Se $\fBMANLESS\fP estiver definido, seu valor será usado como o texto de prompt padrão para o paginador \fBless\fP, como se ele tivesse sido passado usando a opção \fB\-r\fP (de forma que quaisquer ocorrências do texto \fB$MAN_PN\fP serão expandidas da mesma forma). Por exemplo, se você deseja definir o texto de prompt incondicionalmente para \(lqmeu texto de prompt\(rq, definida $\fBMANLESS\fP com \(oq\fB\-Psmeu\ texto\ de\ prompt\fP\(cq. Usar a opção \fB\-r\fP sobrescreve essa variável de ambiente. .TP .if !'po4a'hide' .B BROWSER Se $\fBBROWSER\fP estiver definido, seu valor é uma lista delimitada por caractere de dois pontos contendo os comandos, cada um dos quais, por sua vez, é usado para tentar iniciar um navegador web para \fBman\fP \fB\-\-html\fP. Em cada comando, \fI%s\fP é substituído por um nome de arquivo contendo a saída HTML de \fBgroff\fP, \fI%%\fP é substituído por um único sinal de porcentagem e um \fI%c\fP é substituído pelo caractere de dois pontos. .TP .if !'po4a'hide' .B SYSTEM Se $\fBSYSTEM\fP estiver definido, ele surte o mesmo efeito que se fosse especificado como um argumento da opção \fB\-m\fP. .TP .if !'po4a'hide' .B MANOPT Se $\fBMANOPT\fP estiver definido, ele será analisado antes da linha de comando do \fBman\fP e é esperado que tenha um formato similar. Como todas as outras variáveis de ambiente específicas do \fBman\fP podem ser expressadas como opções de linha de comando e, portanto, são candidatos de serem incluídos em $\fBMANOPT\fP, é esperado que elas se tornem obsoletas. NOTA: Todos os espaços deveriam ser interpretados como parte de um argumento da opção tem que ser escapados. .TP .if !'po4a'hide' .B MANWIDTH Se $\fBMANWIDTH\fP estiver definido, seu valor é usado como o comprimento de linha para o qual as páginas de manual deveriam ser formatadas. Se ele não estiver definido, as páginas de manual serão formatadas com um comprimento de linha apropriado para o terminal atual (usando o valor de $\fBCOLUMNS\fP, um \fBioctl\fP(2) se disponível ou retrocedendo para 80 caracteres se as duas anteriores não estiverem disponíveis). Páginas cat serão salvas somente quando a formatação padrão puder ser usada, que é quando o comprimento da linha de terminal está entre 66 e 80 caracteres. .TP .if !'po4a'hide' .B MAN_KEEP_FORMATTING Normalmente, quando a saída não está sendo direcionada para um terminal (ex.: para um arquivo ou um "pipe"), caracteres de formatação são descartados para facilitar a leitura do resultado sem ferramentas especiais. Porém, se $\fBMAN_KEEP_FORMATTING\fP estiver definido para um valor diferente de vazio, esses caracteres de formatação são mantidos. Isso pode ser útil para scripts de interfaceamento do \fBman\fP ("wrappers") que possam interpretar caracteres de formatação. .TP .if !'po4a'hide' .B MAN_KEEP_STDERR Normalmente, quando a saída está sendo direcionada para um terminal (geralmente um paginador), qualquer saída de erro do comando usado para produzir versões formatadas de páginas de manual é descartada para evitar interferência com a exibição da página. Programas tal como o \fBgroff\fP frequentemente produzem relativamente poucas mensagens de erro sobre problemas tipográficos, (ex.: alinhamento ruim), o que é geralmente um pouco confuso quando exibido junto com a página de manual. Porém, alguns usuários desejam vê\-los mesmo assim; então, se $\fBMAN_KEEP_STDERR\fP estiver definido para qualquer valor diferente de vazio, a saída de erro será exibida como normalmente faria. .TP .if !'po4a'hide' .BR LANG , " LC_MESSAGES" Dependendo do sistema e implementação, $\fBLANG\fP e/ou $\fBLC_MESSAGES\fP serão interrogados para obter a localidade atual das mensagens. \fBman\fP exibirá suas mensagens naquela localidade (se disponível). Veja \fBsetlocale\fP(3) para detalhes precisos. .SH ARQUIVOS .TP .if !'po4a'hide' .I /etc/manpath.config O arquivo de configuração do man\-db. .TP .if !'po4a'hide' .I /usr/share/man Uma hierarquia global de páginas de manual. .TP .if !'po4a'hide' .I /usr/share/man/index.(bt|db|dir|pag) Um cache global de banco de dados \fIindex\fP tradicional. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag) Um cache global de banco de dados \fIindex\fP compatível com FHS. .SH "VEJA TAMBÉM" .if !'po4a'hide' .BR apropos (1), .if !'po4a'hide' .BR groff (1), .if !'po4a'hide' .BR less (1), .if !'po4a'hide' .BR manpath (1), .if !'po4a'hide' .BR nroff (1), .if !'po4a'hide' .BR troff (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR zsoelim (1), .if !'po4a'hide' .BR setlocale (3), .if !'po4a'hide' .BR manpath (5), .if !'po4a'hide' .BR ascii (7), .if !'po4a'hide' .BR latin1 (7), .if !'po4a'hide' .BR man (7), .if !'po4a'hide' .BR catman (8), .if !'po4a'hide' .BR mandb (8), o manual do pacote man\-db, \fBFSSTND\fP .SH HISTÓRICO 1990, 1991 \(en Originalmente escrito por John W.\& Eaton (jwe@che.utexas.edu). 23 de dezembro de 1992: Rik Faith (faith@cs.unc.edu) aplicou correções de erros fornecidos por Willem Kasdorp (wkasdo@nikhefk.nikef.nl). 30 de abril de 1994 \(en 23 de fevereiro de 2000: Wilf. (G.Wilford@ee.surrey.ac.uk) desenvolveu e manteve este pacote com ajuda de algumas pessoas dedicadas. 30 de outubro de 1996 \(en 30 de março de 2001: Fabrizio Polacco manteve e aprimorou este pacote para o projeto Debian, com a ajuda de toda a comunidade. 31 de março de 2001 \(en atualmente: Colin Watson agora está desenvolvendo e mantendo man\-db.