homem

man (1) homem (1)



NOME

       man pages - formatar e apresentar o manual on-line


SINOPSE

       homem [acdfFhkKtwW-] [caminho -] [sistema-m] [string-p] [-config_file C]
       [PathList-M] [pager P] [-section_list S] seção [] nome ...


DESCRIÇÃO

       formatos homem e exibe a linha em páginas de manual. Se você especificar sec -
       ção, o homem só olha nessa seção do manual. nome é normalmente
       o nome da página de manual, que normalmente é o nome de um comando,
       função, ou arquivo. No entanto, se nome contém uma barra (/ homem), então
       interpreta como uma especificação de arquivo, de modo que você pode fazer o homem ./foo.5
       ou mesmo homem / cd/foo/bar.1.gz.

       Veja abaixo uma descrição de onde o homem olha para a página do manual
       arquivos.



OPÇÕES

       Config_file-C
              Especifique o arquivo de configuração para usar, o padrão é
              / etc man.config /. (Veja man.config (5).)

       Caminho-M
              Especificar a lista de diretórios para procurar por páginas do manual. Sepa -
              a taxa de diretórios com dois pontos. Uma lista vazia é a mesma
              não especificando-M em tudo. Veja busca de caminho para páginas de manual.

       P-pager
              Especifique quais pager para uso. Esta opção substitui a MANPAGER
              variável de ambiente, que por sua vez substitui a variável PAGER -
              capaz. Por padrão, o homem usa / usr / bin / less-is.

       Section_list-S
              Lista é uma lista de pontos das seções separadas para busca manual.
              Esta opção substitui a variável de ambiente MANSECT.

       -uma Por padrão, o homem vai sair depois de exibir a primeira página de instruções
              ele encontra. Usando esta opção o homem forças para mostrar todo o homem -
              ual páginas que não encontraram o nome, apenas o primeiro.

       -c Reformatar a página de origem, mesmo quando um up-to-date de gato
              existe. Isto pode ser significativo se a página do gato foi formatado
              para uma tela com um número diferente de colunas, ou se o pré -
              página formatada é corrompido.

       -D na verdade, não mostrar as páginas do homem, mas não gobs de impressão
              informações de depuração.

       -D exibir tanto e informações de depuração de impressão.

       Equivalente a-f whatis.

       -F ou - preformat
              Único formato - não mostrar.

       -Print h a uma mensagem de ajuda em linha e saída.

       -k Equivalente a propósito.

       Procura-K para a seqüência especificada em todas as páginas * * homem. Atenção:
              Este é provavelmente muito lento! Ela ajuda a especificar uma seção.
              (Só para dar uma idéia aproximada, em minha máquina isso leva cerca de uma
              minutos por cada 500 páginas man.)

       sistema m
              Especificar um conjunto alternativo de páginas homem para pesquisa com base na
              nome dado sistema.

       cordas p
              Especificar a seqüência de pré-processadores para executar antes ou nroff
              troff. Nem todas as instalações terão um conjunto completo de preproces -
              sors. Alguns dos pré-processadores e as letras usadas para desig -
              Nate elas estão: a Equação (E), grap (g), PIC (p), tbl (t), vgrind (v),
              referem-se (r). Esta opção substitui o ambiente MANROFFSEQ
              variável.

       Use-t / usr / bin / groff-Tps-mandoc formato para a página do manual, passe -
              ing a saída para stdout. A saída de / usr / bin / groff-Tps
              -mandoc pode ser necessário passar por algum filtro ou outro
              antes de ser impresso.

       -w - ou caminho
              Na verdade, não mostrar as páginas do homem, mas não imprime o loca -
              mento (s) dos arquivos que deve ser formatado ou exibidos. Se não
              argumento é dado: display (na saída) a lista de diretórios
              que é pesquisado pelo homem para homem páginas. Se MANPATH é um link para
              homem, então MANPATH "é equivalente a" um homem - o caminho ".

       Like-W-w, mas o nome de um ficheiro de impressão por linha, sem adicional
              informação. Isso é útil em comandos de shell como o homem-homem aW
              | Xargs ls-l


CAT PÁGINAS

       Homem vai tentar salvar as páginas do manual formatadas, a fim de salvar-format
       ting tempo da próxima vez que essas páginas são necessários. Tradicionalmente, o formato
       Ted versões de páginas na DIR / Manx são guardados na DIR / catX, mas outro mapa -
       pings de homem para dir dir gato pode ser especificado em / etc man.config /. Não
       páginas de gato são salvos quando o diretório gato necessária não existe. Não
       páginas do gato são salvos quando eles são formatados para um comprimento de linha diferente
       de 80. Nenhuma página gato são salvos quando man.config contém a linha
       Nocache.

       É possível fazer o homem suid para um homem do usuário. Então, se um diretório de gato
       o homem tem dono eo modo de 0755 (gravável apenas pelo homem), e os arquivos do gato
       homem tem dono e modo 0644 ou 0444 (gravável apenas pelo homem, ou não
       escrita em todos), nenhum usuário comum pode alterar as páginas de gato ou colocar
       outros arquivos no diretório do gato. Se o homem não é feito suid, então um gato
       diretório deve ter o modo 0777, se todos os usuários devem ser capazes de deixar
       páginas gato lá.

       A opção-c forças reformatar uma página, mesmo se uma página gato recentes
       existe.




Caminho de pesquisa para páginas de manual

       homem usa um método sofisticado de localizar arquivos de página manual, com base em
       as opções de invocação e variáveis de ambiente, / etc / man.config
       arquivo de configuração, e alguns construído em convenções e heurística.

       Primeiro de tudo, quando o argumento o nome do homem que contém uma barra (/) o homem,
       assume que é uma especificação de arquivo em si, e não há nenhuma pesquisa
       envolvidos.

       Mas, no caso normal, onde o nome não contém uma barra, o homem procura
       uma variedade de diretórios para um arquivo que poderia ser uma página de manual para o
       tópico citado.

       Se você especificar a opção-pathList M, pathList é de dois pontos separados
       lista dos diretórios que procura o homem.

       Se você não especificar-M, mas definir a variável de ambiente MANPATH, o
       valor dessa variável é a lista dos diretórios que o homem
       pesquisas.

       Se você não especificar um caminho explícito lista com-M ou MANPATH, o homem
       desenvolve o seu próprio caminho lista com base no conteúdo da configuração
       arquivo / etc man.config /. As declarações MANPATH no arquivo de configuração
       identificar os diretórios especial para incluir no caminho da pesquisa.

       Além disso, as declarações MANPATH_MAP adicionar ao caminho da pesquisa dependentes -
       ção no seu caminho de procura de comando (ou seja, sua variável de ambiente PATH).
       Para cada diretório que pode estar no caminho de procura de comando, um homem
       PATH_MAP declaração especifica um diretório que deve ser adicionado ao
       caminho de pesquisa para arquivos de página manual. homem olha para a variável PATH e
       adiciona os diretórios correspondente ao manual do caminho de pesquisa de arquivo.
       Assim, com a utilização adequada dos MANPATH_MAP, quando você emitir o comando
       xyz homem, você começa uma página de manual para o programa que iria se
       xyz emitiu o comando.

       Além disso, para cada diretório no caminho de procura de comando (que chamaremos
       é um diretório "comando") para os quais você não tem uma MANPATH_MAP
       declaração, o homem procura automaticamente um diretório de página manual "próximos"
       ou seja, como um subdiretório no diretório do próprio comando ou no par -
       ent diretório do diretório de comando.

       Você pode desativar o automático "próximo" buscas, incluindo uma NOAU -
       TOPATH declaração no arquivo / etc man.config /.

       Em cada diretório no caminho de busca, como descrito acima, procura homem
       para um arquivo chamado topic.section, com um sufixo opcional na seção
       número e, possivelmente, um sufixo de compressão. Se não encontrar um tal
       arquivo, então ele procura em todas as subpastas nomeado Mann ou CATN onde N é
       o número da seção manual. Se o arquivo estiver em um subdiretório CATN, o homem
       assume que é um arquivo de página formatada manual (de gato). Caso contrário, o homem
       assume que é formatado. Em ambos os casos, se o nome do arquivo tem um conhecido
       sufixo de compressão (como. gz), o homem assume que é compactado.

       Se você quiser ver onde (ou se) o homem poderia encontrar a página do manual para uma
       tópico específico, use o caminho - (-w) opção.



MEIO AMBIENTE

       MANPATH
              Se MANPATH é definida, o homem usa-o como o caminho para a busca de instruções
              arquivos página. Ela substitui o arquivo de configuração e auto -
              caminho de pesquisa matic, mas é substituída pela invocação-M
              opção. Veja busca de caminho para páginas de manual.

       MANPL Se MANPL é definida, seu valor é usado como o comprimento de mostrar.
              Caso contrário, a página vai ocupar todo o homem um (longo) página.

       MANROFFSEQ
              Se MANROFFSEQ é definida, seu valor é usado para determinar o conjunto de
              preprocessors executado antes de executar ou nroff troff. Por padrão,
              páginas são passadas para o pré-processamento antes tbl nroff.

       MANSECT
              Se MANSECT é definida, seu valor é usado para determinar qual o manual
              seções para pesquisa.

       MANWIDTH
              Se MANWIDTH é definida, seu valor é usado como a largura manpages
              deve ser exibido. Caso contrário, as páginas podem ser exibidas ao longo do
              toda a largura da tela.

       MANPAGER
              Se MANPAGER é definida, seu valor é usado como o nome do programa
              usar para exibir a página man. Se não, então PAGER é usado. Se
              que não tem qualquer valor, / usr / bin / less-is é usado.

       Se LANG LANG estiver definido, o seu valor define o nome do subdiretório
              onde o primeiro homem olha para as páginas man. Assim, o comando LANG '= dk
              1 homem foo 'fará com que o homem a procurar a página man foo em
              .../dk/man1/foo.1, e se não puder encontrar um arquivo, clique em
              .../man1/foo.1, onde ... é um diretório no caminho da pesquisa.

       NLSPATH, LC_MESSAGES, LANG
              As variáveis de ambiente e NLSPATH LC_MESSAGES (ou quando LANG
              esta não existe) desempenham um papel na localização da mensagem
              catálogo. (Mas as mensagens são compilados em Inglês, e para
              Inglês catálogo não é necessário.) Observe que programas como o col (1)
              chamado pelo homem também usar por exemplo LC_CTYPE.

       PATH ajuda a determinar o caminho de pesquisa para arquivos de página manual. Ver
              Procura o caminho para páginas de manual.

       Sistema Sistema é usado para obter o nome padrão do sistema alternativo (para uso
              com a opção-m).


VEJA TAMBÉM

       apropos (1), whatis (1), less (1), groff (1), man.config (5).


BUGS

       A opção-t só funciona se uma troff-como o programa está instalado.
       Se você ver piscar \ 255 ou ao invés de hífens, ponha 'MENOS
       CHARSET = latin1 'no seu ambiente.


DICAS

       Se você adicionar a linha

         (global-set-key [(F1)] (lambda () (interactive) (Manual-entrada (cur -
       alugar-palavra))))

       para o seu. emacs, depois de bater F1 vai lhe dar a man page para o
       chamada biblioteca na posição atual do cursor.

       Para obter uma versão em texto simples de uma página de homem, sem retrocessos e
       sublinhados, experimentar

         # Foo homem | col-b> foo.mantxt