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
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