MAN(1) Utilidades do paginador do manual MAN(1) NOME man - um ambiente para os manuais de referencia do sistema SINOPSE man [man opcoes] [[seccao] pagina ...] ... man -k [apropos opcoes] expreg ... man -K [man opcoes] [seccao] termo ... man -f [whatis opcoess] pagina ... man -l [man opcoes] ficheiro ... man -w|-W [man opcoes] pagina ... DESCRICAO man e o paginador do manual do sistema. Cada argumento pagina dado a man e normalmente o nome de um programa, utilitario ou funcao. A pagina do manual associada a cada um destes argumentos e procurada e mostrada. A seccao, se indicada, informa man para procurar so nessa seccao do manual. A accao predefinida e procurar em todas as seccoes disponiveis seguindo uma ordem pre-estabelecida (veja DEFAULTS) e mostrar so a primeira pagina encontrada, mesmo se pagina existir em varias seccoes. A tabela abaixo mostra os numeros de seccao do manual, seguidos dos tipos de pagina que contem. 1 Programas executaveis ou comandos da shell 2 Chamadas de sistema (funcoes fornecidas pelo kernel) 3 Funcoes de biblioteca (funcoes dentro de bibliotecas de programas) 4 Ficheiros especiais (habitualmente encontrados em /dev) 5 Formatos de ficheiro e convencoes e.g. /etc/passwd 6 Jogos 7 Miscellaneous (including macro packages and conventions), e.g. man(7), groff(7), man-pages(7) 8 Comandos de administracao do sistema (habitualmente so para root) 9 Rotinas do kernel [Nao padrao] Uma pagina do manual consiste em varias seccoes. Conventional section names include NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLE, AUTHORS, and SEE ALSO. As seguintes convencoes aplicam-se a seccao SINOPSE, podendo ser usadas como guia noutras seccoes. texto em negrito digite tal como ve. texto em italico substituir com o argumento apropriado. [-abc] todo e qualquer argumento entre [ ] e opcional. -a|-b opcoes delimitadas por | nao podem ser usadas em conjunto. argumento ... O argumento pode ser repetido. [expressao] ... Toda a expressao dentro de [ ] pode ser repetida. O desenho exacto pode variar, dependendo do dispositivo de saida. Por exemplo, habitualmente, o manual nao desenha italicos quando executado num terminal, tipicamente usara texto sublinhado ou colorido. A ilustracao do comando ou funcao e um padrao que devera corresponder a todas as possiveis chamadas. Nalguns casos, e aconselhavel ilustrar varias chamadas exclusivas, tal como mostrado na seccao SINOPSE desta pagina do manual. EXEMPLOS man ls Mostra a pagina do manual para o item (programa) ls. man man.7 Mostra a pagina do manual para o pacote de macro man da seccao 7 (esta e uma sintaxe alternativa de "man 7 man"). man 'man(7)' Mostra a pagina do manual para o pacote de macro man da seccao 7 (esta e uma sintaxe alternativa de "man 7 man". Pode ser mais conveniente ao copiar/colar referencias cruzadas em paginas do manual. Note que os parenteses normalmente tem de estar entre aspas para os proteger da shell). man -a intro Mostra, em sucessao, todas as paginas do manual intro disponiveis. E possivel sair entre exibicoes sucessivas ou saltar qualquer uma delas. man -t bash | lpr -Pps Formata a pagina do manual para bash, para o formato predefinido troff ou groff e encaminha para a impressoara ps. A saida predefinida para groff e habitualmente PostScript. man --help deve indicar a qual processador esta ligada a opcao -t. man -l -Tdvi ./foo.1x.gz> ./foo.1x.dvi Este comando descomprime e formata a pagina fonte do manual do nroff ./foo.1x.gz para um ficheiro independente do dispositivo (dvi). O redireccionamento e necessario dado que a bandeira -T causa o redireccionamento da saida para stdout sem paginador. A saida poderia ser vista com um programa do tipo xdvi ou mais processada para PostScript usando um programa como dvips. man -k printf Procura nas descricoes curtas e nomes de paginas do manual pela palavra-chave printf como expressao regular. Imprime quaisquer correspondencias. Equivalente a apropos printf. man -f smail Procura nas paginas do manual referenciadas por smail e imprime as descricoes curtas encontradas. Equivalente a whatis smail. RESUMO Muitas opcoes estao disponiveis para man para fornecer tanta flexibilidade quanta possivel ao utilizador. Pode alterar o caminho de procura, a ordem das seccoes, o processador de saida e outros comportamentos e operacoes, detalhadas abaixo. Se definido, varias variaveis de ambiente sao interrogadas para determinar a operacao de man. E possivel definir a variavel "catch all" $MANOPT para qualquer cadeia no formato de linha de comando, com a excepcao de que quaisquer espacos usados como parte do argumento de uma opcao devem ser escapados (precedidos por barra invertida). man analisara $MANOPT antes de analisar a sua propria linha de comando. As opcoes que requerem um argumento serao substituidas pelas mesmas opcoes encontradas na linha de comando. Para repor todas as opcoes definidas em $MANOPT, -D pode ser especificada como opcao inicial da linha de comando. Isto permitira que man "esqueca" as opcoes especificadas em $MANOPT, embora elas pudessem ainda ser validas. As paginas do manual sao normalmente armazenadas em formato nroff(1) sob uma pasta como /usr/share/man. Nalgumas instalacoes, podera haver tambem cat pages pre-formatadas para melhorar o desempenho. Veja manpath(5) para detalhes onde estes ficheiros sao armazenados. Esta disponivel suporte internacional para este pacote, controlado pela sua idioma. Se o seu sistema nao definiu isto automaticamente, e necessario definir $LC_MESSAGES, $LANG ou outra variavel de ambiente dependente do sistema para o seu idioma, normalmente especificado no formato POSIX: [_[.[,]]] Se a pagina desejada estiver disponivel no seu idioma sera mostrada, em vez da pagina padrao (normalmente Ingles dos EUA) Se verificar que as traducoes fornecidos com este pacote nao estao disponiveis no seu idioma e gostaria de os disponibilizar, por favor, contacte o gestor que coordena essa actividade. Paginas individuais do manual sao normalmente escritas e mantidas pelos programadores do programa, funcao ou outro topico que documentam e nao estao incluidas neste pacote. Se achar que uma pagina esta em falta ou e inadequada, por favor reporte-o aos gestores do pacote em causa. Para informacao sobre outras funcionalidades e extensoes disponiveis com este paginador do manual, por favor, leia os documentos fornecidos com o pacote. PREDEFINICOES A ordem das seccoes a procurar pode ser sobreposta pela variavel de ambiente $MANSECT ou pela directiva SECTION em /etc/man_db.conf. Por predefinicao, e como segue: 1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7 A pagina do manual formatada e mostrada usando um paginador. Isto pode ser especificado de varias formas, ou retorna a predefinicao (veja a opcao -P para detalhes). Os filtros sao decifrados por varios meios. Primeiro, a opcao da linha de comandos -p ou a variavel de ambiente $MANROFFSEQ sao interrogadas. Se -p nao foi usada e a variavel nao foi definida, e procurada a linha inicial do ficheiro nroff por uma cadeia de pre-processador. Para conter uma cadeia de pre-processador valida, a linha deve parecer-se com: '\" onde cadeia pode ser qualquer combinacao de letras descritas na opcao -p abaixo. Se nenhum dos metodos acima fornecer informacao de filtragem, sera usado um conjunto predefinido. Um tunel de formatacao e formado a partir dos filtros e do paginador primario (noff ou [tg]roff com -t) e executado. Alternativamente, se um programa executavel mandb_nfmt (ou mandb_tfmt com -t) existir na raiz da arvore do manual, sera executado. Recebe o ficheiro fonte do manual, a cadeia de pre-processamento e, opcionalmente, o dispositivo especificado com -T ou -E como argumentos. OPCOES Opcoes nao-argumento que sejam duplicadas na linha de comandos, em $MANOPT, ou em ambas, nao sao prejudiciais. Para opcoes que requerem um argumento, cada duplicacao sobrepoe-se ao valor anterior do argumento. Opcoes gerais -C ficheiro, --config-file=ficheiro Use this user configuration file rather than the default of ~/.manpath. -d, --debug imprime informacao de depuracao. -D, --default Esta opcao e normalmente emitida como a primeira opcao e repoe o comportamento de man na predefinicao. A sua finalidade e repor as opcoes que possam ter sido definidas em $MANOPT. Quaisquer opcoes a seguir a -D terao o seu efeito habitual. --warnings[=avisos] Enable warnings from groff. This may be used to perform sanity checks on the source text of manual pages. warnings is a comma-separated list of warning names; if it is not supplied, the default is "mac". To disable a groff warning, prefix it with "!": for example, --warnings=mac,!break enables warnings in the "mac" category and disables warnings in the "break" category. See the "Warnings" node in info groff for a list of available warning names. Modos principais de operacao -f, --whatis Approximately equivalent to whatis. Display a short description from the manual page, if available. See whatis(1) for details. -k, --apropos Approximately equivalent to apropos. Search the short manual page descriptions for keywords and display any matches. See apropos(1) for details. -K, --global-apropos Procura texto em todas as paginas do manual. Esta e uma procura brutal e provavelmente levara algum tempo; Se puder, especifique uma seccao para reduzir o numero de paginas a procurar. Os termos de procura podem ser cadeias simples (predefinicao) ou expressoes regulares, se a opcao --regex for usada. Note that this searches the sources of the manual pages, not the rendered text, and so may include false positives due to things like comments in source files, or false negatives due to things like hyphens being written as "\-" in source files. Searching the rendered text would be much slower. -l, --local-file Activate "local" mode. Format and display local manual files instead of searching through the system's manual collection. Each manual page argument will be interpreted as an nroff source file in the correct format. No cat file is produced. If '-' is listed as one of the arguments, input will be taken from stdin. If this option is not used, then man will also fall back to interpreting manual page arguments as local file names if the argument contains a "/" character, since that is a good indication that the argument refers to a path on the file system. -w, --where, --path, --location Nao mostra realmente a pagina do manual, mas imprime a localizacao do ficheiro fonte nroff que seria formatado. Se -a for tambem usada, imprime as localizacoes de todos os ficheiros fonte que cumprem o criterio de procura. -W, --where-cat, --location-cat Nao mostra realmente a pagina do manual, mas imprime a localizacao do ficheiro cat pre-formatado que seria mostrado. Se -a for tambem usada, imprime as localizacoes de todos os ficheiros cat pre-formatados que cumprem o criterio de procura. Se -w e -W forem ambas usadas, imprime o ficheiro-fonte e o ficheiro cat separados por um espaco. Se forem usadas -w, -W e -a, faz isto para todas as correspondencias possiveis. -c, --catman Esta opcao nao e para uso geral e so deve ser usada pelo programa catman. -R codificacao, --recode=codificacao Em vez de formatar a pagina do manual da maneira usual, envia a sua fonte convertida para a codificacao especificada. Se ja conhece a codificacao do ficheiro fonte, tambem pode usar manconv(1) directamente. No entanto, essa opcao permite converter varias paginas do manual numa unica codificacao sem ter de declarar explicitamente a codificacao de cada uma, desde que ja tenham sido instaladas numa estrutura semelhante a uma hierarquia de pagina do manual. Considere usar antes man-recode(1) para converter multiplas paginas do manual, dado que tem um ambiente desenhado para conversao em lote e, como tal, pode ser bastante mais rapido. Encontrar paginas do manual -L idioma, --locale=idioma O man normalmente determinara sua localidade actual por uma chamada a funcao C setlocale(3), que interroga varias variaveis de ambiente, possivelmente incluindo $LC_MESSAGES e $LANG. Para sobrepor temporariamente o valor determinado, use esta opcao para fornecer uma cadeia idioma directamente a man. Note que isto nao tera efeito ate que a procura por paginas realmente comece. Saidas como a mensagem de ajuda serao sempre mostradas no idioma inicialmente determinado. -m sistema[,...], --systems=sistema[,...] If this system has access to other operating systems' manual pages, they can be accessed using this option. To search for a manual page from NewOS's manual page collection, use the option -m NewOS. O sistema especificado pode ser uma combinacao de nomes de sistemas operativos, separados por virgulas. Para incluir uma procura de paginas do manual do sistema operativo nativo, inclua o nome do sistema man na cadeia de argumentos. Esta opcao sobrepoe-se a variavel de ambiente $SYSTEM. -M caminho, --manpath=caminho Especifica um caminho de manual alternativo. Por predefinicao, man usa codigo derivado de manpath para determinar o caminho a procurar. Esta,opcao sobrepoe-se a variavel de ambiente $MANPATH e faz com que a opcao -m seja ignorada. Um caminho especificado como sendo caminho do manual,tem de ser a raiz de uma hierarquia de paginas do manual estruturada em seccoes, tal como descrito no manual do man-db (sob "O sistema de paginas do manual"). Para ver paginas do manual fora desta hierarquia, veja a opcao -l. -S lista, -s lista, --sections=lista A lista e uma lista de seccoes separada por dois-pontos ou virgulas, usada para determinar quais as seccoes do manual a procurar e em que ordem. Esta opcao sobrepoe-se a variavel de ambiente $MANSECT. A sintaxe -s e para compatibilidade com System V. -e sub-extensao, --extension=sub-extensao Alguns sistemas incorporam grandes pacotes de paginas do manual, tais como as que acompanham o pacote Tcl, na hierarquia principal das paginas do manual. Para contornar o problema de ter duas pagina de manual com o mesmo nome,, tais como exit(3), as paginas Tcl foram todas habitualmente atribuidas a seccao l. Como isto era infeliz, e agora possivel por as paginas na seccao correcta e atribuir-lhes uma "extensao" especifica, neste caso, exit(3tcl). Sob operacao normal, man mostrara exit(3) preferencialmente a exit(3tcl). Para negociar esta situacao e evitar ter de saber qual a seccao em que esta o que necessita, e agora possivel dar a man uma cadeia sub-extensao indicando a que pacote a pagina tem de pertencer. Usando o exemplo acima, indicando a opcao -e tcl a man restringe a procura a paginas com uma extensao *tcl. -i, --ignore-case Ignora maiusculas ao procurar paginas do manual. E a predefinicao. -I, --match-case Procura paginas do manual diferenciando maiusculas. --regex Mostra todas as paginas com qualquer parte ou dos seus nomes ou das suas descricoes correspondentes a cada argumento de pagina como expressao regular, como com apropos(1). Como nao ha habitualmente forma de escolher a "melhor" pagina ao procurar uma expressao regular, esta opcao implica -a. --wildcard Mostra todas as paginas com qualquer parte ou dos seus nomes ou das suas descricoes correspondentes a cada argumento page usando caracteres universais, como com apropos(1) -wildcard. O argumento page tem de corresponder ao nome ou descricao completos ou corresponder aos limites de palavras na descricao. Como nao ha habitualmente forma de escolher a "melhor" pagina ao procurar um caracter universal, esta opcao implica -a. --names-only Se a opcao --regex ou --wildcard forem usadas, compara so nomes de pagina, nao descricoes, como com whatis(1). Senao, nao tem efeito. -a, --all Por predefinicao, man sai apos mostrar a pagina de manual mais adequada que encontrar. Usar esta opcao forca man a mostrar todas as paginas do manual com nomes que cumpram o criterio de procura. -u, --update Esta opcao faz com que man actualize as caches da sua base de dados de paginas do manual instaladas. Isto so e necessario em raras ocasioes e e normalmente melhor executar mandb(8). --no-subpages Por predefinicao, man tentara interpretar pares de nomes de paginas do manual dados na linha de comandos como equivalentes a um unico nome de pagina do manual contendo um hifen ou um sublinhado. Isto suporta o padrao comum de programas que implementam varios sub-comandos, permitindo que eles fornecam paginas de manual para cada um que possa ser acedido usando uma sintaxe semelhante a que seria usada para chamar os proprios sub-comandos. Por exemplo: $ man -aw git diff /usr/share/man/man1/git-diff.1.gz Para desactivar este comportamento, use a opcao --no-subpages. $ man -aw --no-subpages git diff /usr/share/man/man1/git.1.gz /usr/share/man/man3/Git.3pm.gz /usr/share/man/man1/diff.1.gz Controlar saida formatada -P paginador, --pager=paginador Especifica o paginador de saida a usar. Por predefinicao, man usa less, caindo em cat se o less nao for encontrado ou nao for executavel. Esta opcao sobrepoe-se a variavel de ambiente $MANPAGER, que, por sua vez, se sobrepoe a variavel de ambiente $PAGER. Nao e usada em conjunto com -f ou -k. O valor pode ser um simples nome de comando ou um comando com argumentos e pode usar citacoes de shell (barras invertidas, aspas simples ou aspas duplas). Nao pode usar tuneis para ligar varios comandos; se for tal preciso, use um script, o que pode levar o ficheiro a ser visto como argumento ou na saida padrao. -r prompt, --prompt=prompt Se for usada uma versao recente do less como paginador, o man tentara definir o seu prompt e algumas opcoes sensiveis. O prompt predefinido parece-se com Pagina do manual nome(sec) linha x onde nome denota o nome da pagina do manual, sec denota a seccao onde foi encontrada e x o numero de linha actual. Isto consegue-se usando a variavel de ambiente $LESS. Fornecer -r com uma cadeia sobrepoe esta predefinicao. A cadeia pode conter o texto $MAN_PN, que sera expandido para o nome da pagina de manual actual e seu nome de seccao, entre "(" e ")". A cadeia usada para produzir a predefinicao pode ser expressa como \ Pagina\ do\ manual\ \$MAN_PN\ ?ltlinha\ %lt?L/%L.: byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%.. (prima h para ajuda ou q para sair) Esta dividida em tres linhas para melhorar a legibilidade. Para ver o seu significado, veja a pagina do less(1). A cadeia do prompt e primeiro avaliada pela shell. Todas as aspas e barras invertidas no prompt tem de ser escapadas com uma barra invertida precedente. A cadeia pode terminar num $ escapadoque pode ser seguido de mais opcoes do less. Por predefinicao, man define as opcoes -ix8 A variavel de ambiente $MANLESS descrita abaixo pode ser usada para definir uma cadeia de prompt predefinida, se nenhuma for indicada na linha de comandos. -7, --ascii Ao ver uma pagina do manual pura ascii(7) num terminal de 7 bitou num emulador de terminal, alguns caracteres podem nao se ver corectamente ao usar a descricao de dispositivo latin1(7) com GNU nroff. Esta opcao permite que paginas do manual puras ascii sejam mostradas em ascii com o dispositivo latin1. Nao traduzira nenhum texto latin1. A tabela seguinte mostra as traducoes realizadas: algumas partes so poderao ser vistas adequadamente ao usar o dispositivo latin1(7) do GNU nroff. Descricao Octal latin1 ascii ------------------------------------------- hifen de 255 - - continuacao lista (ponto 267 o o central) acento agudo 264 ' ' sinal de 327 x x multiplicacao Se a coluna latin1 e mostrada correctamente, o seu terminal pode estar definido para caracteres latin1 e esta opcao nao e necessaria. se as colunas latin1 e ascii sao identicas, esta a ler esta pagina com esta opcao ou o man nao formatou esta pagina usando a descricao do dispositivo latin1 Se a coluna latin1 esta em flata ou corrompida, podera ter de ver as paginas do manual com esta opcao. Esta opcao e ignorada ao usar as opcoes -t, -H, -T, ou -Z e pode ser inutil para um nroff diferente do GNU nroffs. -E codificacao, --encoding=codificacao Gera saida para uma codificacao de caracteres diferente da predefinida. Para compatibilidade, a codificacao pode ser um dispositivo nroff tal como ascii, latin1, ou utf8, assim como uma verdadeira codificacao de caracteres, como UTF-8. --no-hyphenation, --nh Normalmente, o nroff hifeniza o texto nas quebras de linha, mesmo com palavras que nao contem hifenes, se for necessario para dispor palavras numa linha sem espaco excessivo. Esta opcao desactiva a hifenizacao automatica, pelo que as palavras so serao divididas se ja contiverem hifenes. Se esta a escrever uma pagina do manual e simplesmente quer impedir o nroff de hifenizar erradamente uma palavra, nao use esta opcao, consulte antes a documentacao do nroff; e.g., pode por "\%" dentro de uma palavra para indicar que ela pode ser hifenizada nesse ponto, ou por "\%" no inicio da palavra para impedir que seja hifenizada. --no-justification, --nj Normalmente, o nroff alinha o texto a ambas as margens. Esta opcao desactiva este alinhamento, alinhando o texto so a esquerda. Se esta a escrever uma pagina do manual e simplesmente quer impedir o nroff de alinhar assim determinados paragrafos, nao use esta opcao, consulte antes a documentacao do nroff; e.g., pode usar os pedidos ".na", ".nf", ".fi" e ".ad" para desactivar temporariamente o ajuste e preenchimento. -p cadeia, --preprocessor=cadeia Especifica a sequencia de pre-processadores a executar antes de nroff ou troff/groff. Nem todas as instalacoes terao um conjunto completo de pre-processadores. Alguns deles e as letras usadas para os designar sao: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Esta opcao sobrepoe-se a variavel de ambiente $MANROFFSEQ. zsoelim e sempre executado como primeiro pre-processador. -t, --troff Usa groff -mandoc para formatar a pagina do manual para a saida padrao. Esta opcao nao e requerida em conjunto com -H, -T, ou -Z. -T[dispositivo], --troff-device[=dispositivo] This option is used to change groff (or possibly troff's) output to be suitable for a device other than the default. It implies -t. Examples (as of groff 1.23.0) include dvi, latin1, pdf, ps, utf8, X75 and X100. -H[navegador], --html[=navegador] Esta opcao faz com que o groff produza saida HTML e mostra essa saida num navegador web. A escolha do navegador e determinada pelo argumento opcional navegador, se for fornecido pela variavel de ambiente $BROWSER ou por valor predefinido compilado em tempo de execucao, se aquela nao estiver definida (normalmente o lynx). Esta opcao implica -t e so funciona com o GNU troff. -X[dpi], --gxditview[=dpi] Esta opcao mostra a saida do groff numa janela grafica usando o programa gxditview. Os dpi (dots per inch) podem ser 75, 75-12, 100, ou 100-12, predefinidos para 75; as variantes -12 usam uma letra de 12-pontos. Esta opcao implica -T com os dispositivos X75, X75-12, X100, ou X100-12, respectivamente. -Z, --ditroff O groff executara o troff e usara o pos-processador apropriado para produzir uma saida adequada ao dispositivo escolhido. Se o groff -mandoc for o groff, esta opcao e passada ao groff e vai suprimir o uso de um pos-processador. Implica -t. Obter ajuda -?, --help mostra uma mensagem de ajuda e sai. --usage mostra uma mensagem curta de uso e sai. -V, --version mostra informacao da versao. ESTADO DE SAIDA 0 Execucao de programa com sucesso. 1 Erro de uso, sintaxe ou ficheiro de configuracao. 2 Erro de operacao. 3 Um processo filho devolveu um estado de saida nao-zero. 16 Pelo menos uma de paginas/ficheiros/palavras-chave nao existe ou nao teve correspondencias. AMBIENTE MANPATH Se $MANPATH estiver definida, o seu valor e usado como caminho de procura de paginas do manual. See the SEARCH PATH section of manpath(5) for the default behaviour and details of how this environment variable is handled. MANROFFOPT Sempre que man chama o formatador (nroff, troff, ou groff), adiciona o conteudo de $MANROFFOPT a linha de comandos do formatador. For example, MANROFFOPT=-P-i tells the formatter to use italic text (which is only supported by some terminals) rather than underlined text. MANROFFSEQ Se $MANROFFSEQ estiver definida, o seu valor e usado para determinar o conjunto de pre-processadores por onde passar cada pagina do manual. A lista de pre-processadores depende do sistema. MANSECT Se $MANSECT estiver definida, o seu valor e uma lista de seccoes separada por dois-pontos e e usada para determinar que seccoes do manual procurar e em que ordem. A predefinicao e "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7", a nao ser que sobreposta pela directiva SECTION em /etc/man_db.conf. MANPAGER, PAGER Se $MANPAGER ou $PAGER estiverem definidas ($MANPAGER e preferida), o seu valor e usado como nome do programa usado para mostrar a pagina do manual. Por predefinicao, e usada less, voltando a cat se o less nao for encontrado ou nao for executavel. O valor pode ser um simples nome de comando ou um comando com argumentos e pode usar citacoes de shell (barras invertidas, aspas simples ou aspas duplas). Nao pode usar tuneis para ligar varios comandos; se for tal preciso, use um script, o que pode levar o ficheiro a ser visto como argumento ou na saida padrao. MANLESS Se $MANLESS estiver definida, o seu valor sera usado como cadeia de prompt predefinida do paginador less, como se fosse passada como opcao -r (quaisquer ocorrencias de $MAN_PN serao expandidas da mesma forma). Por exemplo, se quiser definir a cadeia de prompt incondicionalmente para "minha cadeia de prompt", defina $MANLESS para `-Psminha cadeia de prompt'. Usar a opcao -r sobrepoe-se a esta variavel de ambiente. BROWSER Se $BROWSER estiver definida, o seu valor e uma lista de comandos separados por dois-pontos, cada um dos quais e usado a vez para tentar iniciar um navegador web para o man --html. Em cada comando, %s e substituido por um nome de ficheiro contendo a saida HTML do groff, %% e substituido por um unico sinal de percentagem (%) e %c e substituido por dois-pontos (:). SYSTEM Se $SYSTEM estiver definido, tera o mesmo efeito como se fosse especificado como argumento da opcao -m. MANOPT Se $MANOPT estiver definida, sera analisada antes da linha de comandos do man e e esperado que tenha um formato similar. Como todas as outras variaveis de ambiente especificas do man podem ser expressadas como opcoes de linha de comandos, sendo assim candidatas a serem incluidas em $MANOPT, espera-se que se tornem obsoletas. Nota: todos os espacos que devam ser interpretados como parte do argumento da linha de comandos, tem de ser escapados. MANWIDTH Se $MANWIDTH estiver definida, o seu valor e usado como tamanho da linha para o qual as paginas do manual devem ser formatadas. Senao, serao formatadas com um tamanho apropriado ao terminal actual (usando o valor de $COLUMNS, e ioctl(2) se disponivel, ou retornando a 80 caracteres se nenhuma estiver disponivel). As paginas cat so serao gravadas quando se puder usar o formato predefinido, ou seja, quando o tamanho da linha do terminal esteja entre 66 e 80 caracteres. MAN_KEEP_FORMATTING Normalmente, quando a saida nao e direccionada para um terminal (vai para um ficheiro ou um tunel), os caracteres de formatacao sao descartados para simplificar a leitura do resultado sem ferramentas especiais. Contudo, se $MAN_KEEP_FORMATTING estiver definida para qualquer coisa diferente de um valor vazio, estes caracteres sao mantidos. Pode ser util para programas acima do man que possam interpretar caracteres de formatacao. MAN_KEEP_STDERR Normalmente, quando a saida e direccionada para um terminal (habitualmente um paginador), qualquer erro de saida do comando usado para produzir versoes formatadas de paginas do manual, e descartado para evitar interferencias com o paginador. Programas como o groff produzem frequentemente mensagens de erro relativamente insignificantes sobre problemas tipograficos, tais como mau alinhamento, que sao invisiveis e geralmente causam confusao ao serem mostradas junto a pagina do manual. Contudo, alguns utilizadores querem ve-las mesmo assim, pelo que se $MAN_KEEP_STDERR tiver um valor nao-vazio, o erro de saida sera sempre mostrado. MAN_DISABLE_SECCOMP On Linux, man normally confines subprocesses that handle untrusted data using a seccomp(2) sandbox. This makes it safer to run complex parsing code over arbitrary manual pages. If this goes wrong for some reason unrelated to the content of the page being displayed, you can set $MAN_DISABLE_SECCOMP to any non-empty value to disable the sandbox. PIPELINE_DEBUG If the $PIPELINE_DEBUG environment variable is set to "1", then man will print debugging messages to standard error describing each subprocess it runs. LANG, LC_MESSAGES Dependendo do sistema e da implementacao, ou uma ou ambas $LANG e $LC_MESSAGES serao interrogadas sobre o idioma da mensagem actual. O man mostrara as suas mensagens nesse idioma (se disponivel). Veja setlocale(3) para detalhes precisos. FICHEIROS /etc/man_db.conf ficheiro de configuracao do man-db. /usr/share/man Uma hierarquia global de paginas do manual. STANDARDS POSIX.1-2001, POSIX.1-2008, POSIX.1-2017. VEJA TAMBEM apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8) A documentacao para alguns pacotes pode estar disponivel noutros formatos, tais como info(1) ou HTML. HISTORICO 1990, 1991 - Originalmente escrito por John W. Eaton (jwe@che.utexas.edu). Dec 23 1992: Rik Faith (faith@cs.unc.edu) aplicou reparacoes de erros fornecidas por Willem Kasdorp (wkasdo@nikhefk.nikef.nl). 30 de Abril de 1994 - 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 individuos dedicados. 30 de Outubro de 1996 - 30 de Marco de 2001: Fabrizio Polacco manteve e melhorou este pacote para o projecto Debian, com a ajuda de toda a comunidade. 31 de Marco de 2001 - hoje em dia: Colin Watson mantem e desenvolve o pacote man-db. ERROS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MAN(1)