groffer - Online na nuvem

PROGRAMA:

NOME

groffer - exibe arquivos groff e páginas de manual no X e tty

SINOPSE

grofer [--] [especificação de arquivo ....]

grofer [modo-opção ....] [opções de groff ....] [opções de homem ....] [X-opções ....]
[--] [especificação de arquivo ....]

grofer -h | --Socorro

grofer -v | --versão

DESCRIÇÃO

A grofer programa é a maneira mais fácil de usar Groff(1). Ele pode exibir
documentos escritos no Groff linguagem, veja Groff(7), ou outro roff línguas, veja
roff(7), que são compatíveis com o original troff língua. Ele encontra e executa todos
necessário Groff pré-processadores, como chem.

A grofer programa também inclui muitos dos recursos para encontrar e exibir o Unix
páginas de manual (homem páginas), de modo que possa ser usado como um substituto para um homem(1) programa.
Além disso, arquivos compactados que podem ser manipulados por gzip(1) ou bzip2(1) são descomprimidos em-
o voo.

O uso normal é bastante simples, fornecendo um nome de arquivo ou o nome de um homem página sem
mais opções. Mas o tratamento de opções tem muitas possibilidades para a criação de
comportamentos. Isso pode ser feito em arquivos de configuração, com o ambiente de shell
variável $ GROFFER_OPT, ou na linha de comando.

A saída pode ser gerada e visualizada de várias maneiras diferentes disponíveis para Groff.
Isso inclui o Groff visualizador X Window nativo gxditview(1 cada Pós-escrito, pdfou Dvi
programa de exibição, um navegador da web gerando html in www modo, ou vários texto modos in
terminais de texto.

A maioria das opções que devem ser nomeadas durante a execução Groff são determinados diretamente
automaticamente para grofer, devido ao uso interno do Grog(1) programa. Mas todos
as partes também podem ser controladas manualmente por argumentos.

Vários nomes de arquivo podem ser especificados nos argumentos da linha de comando. Eles são transformados
em um único documento da maneira normal de Groff.

O tratamento de opções é feito no estilo GNU. As opções e os nomes dos arquivos podem ser misturados livremente. O
opção `--'fecha o tratamento de opções, todos os argumentos a seguir são tratados como nomes de arquivo.
As opções longas podem ser abreviadas de várias maneiras.

OPÇÃO VISÃO GERAL

quebra opções

[-h | --Socorro] [-v | --versão]

grofer modo opções

[--auto] [--predefinição] [- modos padrão modo1, modo2, ....] [--dvi] [--groff]
[--html] [--latin1] [--modo modo de exibição] [--pdf] [--pdf2] [--ps] [--fonte]
[--texto] [--to-stdout] [--tty] [--utf8] [--visualizador prog] [--www] [--x | --X]

opções relacionado para Groff

[-T | --dispositivo dispositivo] [-Z | --saída intermediária | --ditroff]

Tudo mais longe Groff opções curtas são aceitas.

opções for homem páginas

[--a propósito] [--a propósito-data] [--a propósito-devel] [--a propósito-progs] [--cara]
[--nenhum homem] [--Nada especial] [--o que é]

longo opções tomado Acima de da GNU homem

[--tudo] [--ascii] [--ditroff] [--extensão sufixo] [--localidade língua]
[--arquivo local] [--localização | --Onde] [--manpath dir1: dir2: ....] [--sem localização]
[--pager programa] [--Seções sec1: sec2: ....] [--sistemas sys1, sys2, ....]
[--troff-dispositivo dispositivo]

Outras opções longas de GNU homem são aceitos também.

X Janela Kit de ferramentas opções

[--bd | --Cor da borda pixels] [--bg | --fundo cor]
[--bw | --largura da borda pixels] [--exibição Exibição X] [--fg | --primeiro plano cor]
[--fn | --ft | --Fonte nome_fonte] [--geometria tamanho_pos] [--resolução valor] [--rv]
[--título corda] [--xrm Recurso X]

opções for desenvolvimento

[--depurar] [--debug-nomes de arquivos] [--debug-grog] [--debug-keep] [--debug-params]
[--debug-tmpdir] [--fazer nada] [--imprimir texto] [-V]

especificação de arquivo argumentos

A especificação de arquivo parâmetros são todos os argumentos que não são uma opção nem uma opção
argumento. Eles geralmente significam um nome de arquivo ou um homem página esquema de pesquisa.

A seguir, o termo seção_extensão é usado. Significa uma palavra que
consiste numa homem seção que é opcionalmente seguido por um extensão. O nome de
a homem seção é um único personagem de [1-9on], extensão é alguma palavra. O
extensão está faltando principalmente.

Não especificação de arquivo parâmetros significa entrada padrão.

- significa entrada padrão (pode ocorrer várias vezes).

nome do arquivo o nome do caminho de um arquivo existente.

homem:nome(seção_extensão)
homem:nome.seção_extensão
nome(seção_extensão)
nome.seção_extensão
seção_extensão nome
procure a página de manual nome na seção com extensão opcional
seção_extensão.

homem:nome página do manual na parte inferior homem seção que possui nome.

nome if nome não é uma pesquisa de arquivo existente para a página de manual nome no
seção inferior do homem.

OPÇÃO DETALHES

A grofer o programa geralmente pode ser executado com muito poucas opções. Mas para propósitos especiais,
ele suporta muitas opções. Estes podem ser classificados em 5 classes de opções.

Todas as opções curtas de grofer são compatíveis com as opções curtas de Groff(1). Muito tempo
opções de grofer são compatíveis com as opções longas de homem(1).

Os argumentos para nomes de opções longos podem ser abreviados de várias maneiras. Primeiro, o argumento
é verificado se pode ser prolongado como está. Além disso, cada sinal de menos - is
considerada como ponto de partida para uma nova abreviatura. Isso leva a um conjunto de múltiplos
abreviações para um único argumento. Por exemplo, --de-nf pode ser usado como uma abreviatura
for --debug-não-func, mas --de-n funciona bem. Se a abreviatura do argumento conduzir
para várias opções resultantes, um erro é gerado.

Essas abreviações só são permitidas na variável de ambiente $ GROFFER_OPT, mas não em
os arquivos de configuração. Na configuração, todas as opções longas devem ser exatas.

grofer quebra Opções
Assim que uma dessas opções for encontrada na linha de comando, ela é executada, impressa em
saída padrão, e o funcionamento grofer é encerrado depois disso. Todos os outros argumentos
são ignorados.

-h | --Socorro
Imprima informações de ajuda com uma breve explicação das opções de saída padrão.

-v | --versão
Imprima as informações da versão na saída padrão.

grofer Moda Opções
O modo de exibição e os programas visualizadores são determinados por essas opções. Se nenhum de
este modo e opções do visualizador são especificados grofer tenta encontrar um modo de exibição adequado
automaticamente. Os modos padrão são modo pdf, modo ps, modo html, modo x e modo Dvi
no X Window com diferentes visualizadores e modo tty com dispositivo utf8 para menos em um terminal;
outros modos são testados se os programas para o modo padrão principal não existirem.

No X Window, muitos programas criam sua própria janela quando chamados. grofer pode executar estes
telespectadores como um programa independente em segundo plano. Como isso não funciona em modo de texto
em um terminal (tty) deve haver uma maneira de saber quais visualizadores são gráficos do X Window
programas. o grofer script tem um pequeno conjunto de informações sobre alguns nomes de visualizadores. Se um
o argumento do visualizador da linha de comando escolhe um elemento que é mantido como um programa X Window em
esta lista é tratada como um visualizador que pode ser executado em segundo plano. Todos os outros, desconhecidos
as chamadas do visualizador não são executadas em segundo plano.

Para cada modo, você é livre para escolher o visualizador que desejar. Isso não precisa ser algum
visualizador gráfico adequado para este modo. Existe uma chance de visualizar a fonte de saída; por
exemplo, a combinação das opções --mode = ps e --viewer = menos mostra o conteúdo de
da PostScript saída, o código-fonte, com o pager menos.

--auto Equivalente a --mode = auto.

--predefinição
Redefina todas as configurações das opções de linha de comando processadas anteriormente para o
valores padrão. Isso é útil para eliminar todas as opções anteriores do
configuração, em $ GROFFER_OPTe reinicie o processamento de opções usando apenas o restante
da linha de comando.

- modos padrão modo1, modo2, ....
Defina a sequência de modos para auto modo à lista separada por vírgulas fornecida no
argumento. Ver --modo para obter detalhes sobre os modos. Exibir da maneira padrão;
na verdade, isso significa tentar os modos x, ps e tty nesta sequência.

--dvi Equivalente a --mode = dvi.
--visualizador prog
Escolha um programa de visualização para Dvi modo. Pode ser um nome de arquivo ou um programa a ser
procurou em $ PATH. Janela X conhecida Dvi visualizadores incluem xdvi(1) e dvilx(1) Dentro
cada caso, os argumentos podem ser fornecidos adicionalmente.

--groff
Equivalente a --mode = groff.

--html Equivalente a --mode = html.
--visualizador
Escolha um programa de navegador da web para visualizar em html modo. Pode ser o nome do caminho de
um arquivo executável ou um programa em $ PATH. Em cada caso, os argumentos podem ser fornecidos
Além disso.

--modo valor
Defina o modo de exibição. Os seguintes valores de modo são reconhecidos:

auto Selecione a determinação automática do modo de exibição. A sequência de
modos que são experimentados podem ser definidos com o - modos padrão opção. Útil para
restaurando o omissão modo quando um modo diferente foi especificado antes.

Dvi Exibir entrada formatada em um Dvi programa visualizador. Por padrão, o formatado
entrada é exibida com o xdvi(1) programa.

Groff Após a determinação do arquivo, mude grofer para processar a entrada como
Groff(1) faria. Isso desativa o grofer recursos de visualização.

html Traduzir a entrada para o formato html e exibir o resultado em um navegador da web
programa. Por padrão, a existência de uma sequência de navegadores padrão
é testado, começando com conquistador(1) e Mozilla(1). O visualizador de texto html
is lince(1).

pdf Transformar roff entrada arquivos em uma PDF lima usando o Groff (1) dispositivo
-Tpdf. Este é o padrão PDF gerador. O gerado PDF lima is
exibido com programas visualizadores adequados, como okulate(1).

pdf2 Este é o tradicional pdf modo. Às vezes, este modo produz mais correto
saída do que o padrão PDF modo. Por padrão, a entrada é formatada por
Groff usando o dispositivo Postscript, então é transformado no arquivo PDF
formato usando gs(1) ou ps2pdf(1). Se isso não for possível, o PostScript
modo (ps) é usado em seu lugar. Finalmente, ele é exibido usando um visualizador diferente
programas.

ps Exibe a entrada formatada em um programa visualizador de Postscript. Por padrão, o
a entrada formatada é exibida em um dos vários programas do visualizador.

texto Formato em um Groff texto modo e escrever o resultado na saída padrão sem
um programa de pager ou visualizador. O dispositivo de texto, latin1 por padrão, pode ser
escolhido com opção -T.

tty Formato em um Groff texto modo e escrever o resultado na saída padrão usando um
programa de paginação de texto, mesmo quando no X Window.

www Equivalente a --mode = html.

x Exibir a entrada formatada em um nativo roff visualizador. Por padrão, o
a entrada formatada é exibida com o gxditview(1) programa sendo distribuído
Juntamente com Groff. Mas a ferramenta padrão do X Window xditview(1) também pode ser
escolhido com a opção --visualizador. A resolução padrão é 75dpi, mas
100dpi também são possíveis. O padrão Groff dispositivo para a resolução de
75dpi is X75-12, Por 100dpi isto é X100. O correspondente Groff
intermediário saída para o dispositivo real é gerado e o resultado é
exibido. Para uma resolução de 100dpi, a largura padrão da geometria de
o programa de exibição é escolhido para 850dpi.

X Equivalente a --mode = x.

Os modos a seguir não usam o grofer recursos de visualização. Eles são apenas
interessante para aplicações avançadas.

Groff Gerar saída de dispositivo com Groff sem usar a visualização especial
características de grofer. Se nenhum dispositivo foi especificado por opção -T da Groff
omissão ps é assumido.

fonte Produza o código-fonte roff dos arquivos de entrada sem processamento adicional.

--pdf Equivalente a --mode = pdf.
--pdf2 Equivalente a --mode = pdf2.
--visualizador prog
Escolha um programa de visualização para pdf modo. Pode ser um nome de arquivo ou um programa a ser
procurou em $ PATH; argumentos podem ser fornecidos adicionalmente.

--ps Equivalente a --mode = ps.
--visualizador prog
Escolha um programa de visualização para ps modo. Pode ser um nome de arquivo ou um programa a ser
procurou em $ PATH. Os visualizadores de Postscript comuns incluem okulate(1) evidenciar(1) gv(1)
vista fantasma(1), e gs(1), Em cada caso, os argumentos podem ser fornecidos adicionalmente.

--fonte
Equivalente a --mode = source.

--texto Equivalente a --mode = texto.

--to-stdout
O arquivo para o modo escolhido é gerado e seu conteúdo é impresso de acordo com o padrão
saída. Não será exibido no modo gráfico.

--tty Equivalente a --mode = tty.
--visualizador prog
Escolha um pager de texto para o modo tty. O pager padrão é menos(1). Esta opção é
equivalente a homem opção --pager =prog. O argumento da opção pode ser um nome de arquivo ou um
programa a ser pesquisado em $ PATH; argumentos podem ser fornecidos adicionalmente.

--www Equivalente a --mode = html.
--visualizador
prog.

--X | --x
Equivalente a --mode = x.
--visualizador prog
Escolha um programa de visualização para x modo. Programas visualizadores adequados são gxditview(1)
qual é o padrão e xditview(1). O argumento pode ser qualquer arquivo executável ou um
programa em $ PATH; argumentos podem ser fornecidos adicionalmente.

-- Sinaliza o fim do processamento de opções; todos os argumentos restantes são interpretados como
especificação de arquivo parâmetros.

Além disso, grofer aceita todas as opções curtas que são válidas para o Groff(1) programa.
Todos nãogrofer as opções são enviadas sem modificações via Grog para Groff. Então, pós-processadores, macro
pacotes, compatibilidade com clássico troff, e muito mais pode ser especificado manualmente.

Opções relacionado para Groff
Todas as opções curtas de grofer são compatíveis com as opções curtas de Groff(1) o
seguindo de Groff opções têm um significado especial adicional dentro grofer or
faz sentido para uso normal.

Por causa do comportamento de saída especial do Groff opção -Z grofer foi projetado para
ser mudado para Groff modo; O grofer recursos de visualização estão desabilitados lá. O outro
Groff as opções não mudam o modo, mas permitem personalizar o processo de formatação.

--uma Isso gera uma aproximação ascii de saída no texto modos. Isso poderia ser
importante quando o pager de texto tem problemas com sequências de controle em tty modo.

- m lima
Adicionar lima como um Groff arquivo macro. Isso é útil caso não possa ser reconhecido
automaticamente.

--P opt_or_arg
Envie o argumento opt_or_arg como uma opção ou argumento de opção para o real Groff
pós-processador.

--T nome do desenvolvedor | --dispositivo nome do desenvolvedor
Esta opção determina Groffdispositivo de saída de. Os dispositivos mais importantes são os
dispositivos de saída de texto para referência aos diferentes conjuntos de caracteres, como ascii,
utf8, latin1, utf8, e outros. Cada um desses argumentos muda grofer em uma
texto modo usando este dispositivo, para modo tty se o modo real não é um texto modo.
Os seguintes nome do desenvolvedor argumentos são mapeados para o correspondente grofer
--mode =nome do desenvolvedor opção: Dvi, html e ps. Todos X* argumentos são mapeados para modo x.
Entre si nome do desenvolvedor argumento muda para modo Groff usando este dispositivo.

--X é equivalente a Groff -X. Ele exibe o Groff intermediário saída com
gxditview. Como a qualidade é relativamente ruim, essa opção foi descontinuada; usar --X
ao invés porque o x modo usa um X* dispositivo para uma melhor visualização.

-Z | --saída intermediária | --ditroff
Mudar para Groff modo e formate a entrada com o Groff intermediário saída
sem pós-processamento; Vejo groff_out(5). Isso é equivalente à opção --ditroff
of homem, que também pode ser usado.

Todos os outros Groff opções são suportadas por grofer, mas eles são apenas transparentes
transferido para Groff sem qualquer intervenção. As opções que não são explicitamente
manipulado por grofer são passados ​​de forma transparente para Groff. Portanto, essas opções transparentes
não estão documentados aqui, mas em Groff(1). Devido ao automatismo em grofer, nenhum desses
Groff devem ser necessárias opções, exceto para uso avançado.

Opções for homem páginas
--a propósito
Comece o a propósito(1) comando ou facilidade de homem(1) para pesquisar o especificação de arquivo
argumentos dentro de todos homem página descrições. Cada especificação de arquivo argumento é tomado por
pesquisar como está; seção peças específicas não são tratadas, de modo que 7 Groff pesquisas
pelos dois argumentos 7 e Groff, com um grande resultado; para o especificação de arquivo groff.7
nada será encontrado. O língua localidade é tratada apenas quando a chamada
os programas suportam isso; o GNU a propósito e homem -k não. A exibição é diferente
do a propósito programa pelos seguintes conceitos:

* Construir um Groff quadro semelhante a um homem página para a saída de a propósito,

* cada especificação de arquivo argumento é pesquisado por conta própria.

* A restrição por --Seções é tratado também,

* Os caracteres curinga são permitidos e tratados sem outra opção.

--a propósito-data
Mostrar apenas o a propósito descrições para documentos de dados, estes são os homem(7)
seções 4, 5 e 7. Direto seção declarações são ignoradas, curingas são
aceito.

--a propósito-devel
Mostrar apenas o a propósito descrições para documentos de desenvolvimento, estes são os homem(7)
seções 2, 3 e 9. Direto seção declarações são ignoradas, curingas são
aceito.

--a propósito-progs
Mostrar apenas o a propósito descrições de documentos em programas, estes são os homem(7)
seções 1, 6 e 8. Direto seção declarações são ignoradas, curingas são
aceito.

--o que é
Para cada especificação de arquivo argumento pesquisar tudo homem páginas e exibir sua descrição - ou
diga que não é um homem página. Isto foi escrito de novo, por isso difere de homem's
o que é saída pelos seguintes conceitos

* cada nome de arquivo recuperado é adicionado,

* arquivos locais também são tratados,

* a língua e . localidade é suportada,

* a tela é enquadrada por um Groff formato de saída semelhante a um homem página,

* caracteres curinga são permitidos sem outra opção.

As seguintes opções foram adicionadas a grofer para escolher se os argumentos do nome do arquivo
são interpretados como nomes de arquivos locais ou como um padrão de pesquisa para homem páginas. O
o padrão é procurar arquivos locais.

--cara Verifique os argumentos de linha de comando não opcionais (especificações de arquivo) primeiro em ser homem páginas,
em seguida, se eles representam um arquivo existente. Por padrão, um especificação de arquivo é primeiro
testado se é um arquivo existente.

--nenhum homem | --arquivo local
Não verifique homem páginas. --arquivo local é o correspondente homem opção.

--Nada especial
Desativar chamadas anteriores de --tudo, --apropos * e --o que é.

longo opções tomado Acima de da GNU homem
As longas opções de grofer foram sincronizados com as opções longas do GNU homem. Muito tempo
opções de GNU homem são reconhecidas, mas nem todas essas opções são importantes para grofer,
então a maioria deles é simplesmente ignorada. Estes ignorados homem opções são --homem gato, --troff e
--atualizar.

A seguir, o homem opções que têm um significado especial para grofer são documentados.

Se o seu sistema tem GNU homem instalou o conjunto completo de opções longas e curtas do GNU homem
programa pode ser passado através da variável de ambiente $ MANOPT; Vejo homem(1).

--tudo Em busca homem páginas, recupere todos os documentos adequados em vez de apenas um.

-7 | --ascii
In texto modos, exibir a tradução ASCII de caracteres especiais para
ambiente. Isso é equivalente a Groff -mtty_char; Vejo groff_tmac(5).

--ditroff
Produzir Groff intermediário saída. Isso é equivalente a grofer -Z.

--extensão sufixo
restringir homem página procure nomes de arquivo que tenham sufixo anexado à sua seção
elemento. Por exemplo, no nome do arquivo /usr/share/man/man3/terminfo.3ncurses.gz
da homem página extensão é maldições.

--localidade língua
Defina o idioma para homem páginas. Isso tem o mesmo efeito, mas sobrescreve $ LANG.

--localização
Imprima a localização dos arquivos recuperados com o erro padrão.

--sem localização
Não exibe a localização dos arquivos recuperados; isso redefine uma chamada anterior para
--localização. Isto foi adicionado por grofer.

--manpath 'dir1: dir2: ....'
Use o caminho de pesquisa especificado para recuperar homem páginas em vez do programa
padrões. Se o argumento for definido com a string vazia "", a pesquisa por homem página is
Desativado.

--pager
Defina o programa de pager em tty modo; padrão é menos. Isso pode ser definido com --visualizador.

--Seções sec1: sec2: ....
Restringir a pesquisa por homem páginas para o dado seções, uma lista separada por dois pontos.

--sistemas sys1, sys2, ....
Procurar por homem páginas para os sistemas operacionais fornecidos; o argumento sistemas é um
lista separada por vírgulas.

--Onde
Equivalente a --localização.

X Janela Kit de ferramentas Opções
As seguintes opções longas foram adaptadas das opções correspondentes do X Window Toolkit.
grofer irá passá-los para o programa visualizador real se for um programa X Window.
Caso contrário, essas opções serão ignoradas.

Infelizmente, essas opções usam o estilo antigo de um único menos para opções longas. Por
grofer que foi alterado para o padrão com o uso de um duplo menos para opções longas, para
exemplo, grofer usa a opção --Fonte para a opção X Window -Fonte.

See X(7) e a documentação sobre as opções do X Window Toolkit para obter mais detalhes sobre estes
opções e seus argumentos.

--fundo cor
Defina a cor de fundo da janela do visualizador.

--bd pixels
Isso é equivalente a --Cor da borda.

--bg cor
Isso é equivalente a --fundo.

--bw pixels
Isso é equivalente a --largura da borda.

--Cor da borda pixels
Especifica a cor da borda ao redor da janela do visualizador.

--largura da borda pixels
Especifica a largura em pixels da borda ao redor da janela do visualizador.

--exibição Exibição X
Defina a exibição da janela X em que o programa visualizador deve ser iniciado, consulte o
Documentação do X Window para a sintaxe do argumento.

--primeiro plano cor
Defina a cor de primeiro plano da janela do visualizador.

--fg cor
Isso é equivalente a --primeiro plano.

--fn nome_fonte
Isso é equivalente a --Fonte.

--Fonte nome_fonte
Defina a fonte usada pela janela do visualizador. O argumento é um nome de fonte do X Window.

--ft nome_fonte
Isso é equivalente a --Fonte.

--geometria tamanho_pos
Defina a geometria da janela de exibição, ou seja, seu tamanho e início
posição. Ver X(7) para a sintaxe do argumento.

--resolução valor
Defina a resolução da janela X em dpi (pontos por polegada) em alguns programas visualizadores. O único
os valores de dpi suportados são 75 e 100. Na verdade, a resolução padrão para grofer
está definido para 75dpi. A resolução também define o dispositivo padrão em modo x.

--rv Inverta a cor do primeiro plano e do plano de fundo da janela do visualizador.

--título 'algum texto'
Defina o título da janela do visualizador.

--xrm 'recurso'
Defina o recurso X Window.

Opções for Desenvolvimento
--depurar
Habilite todas as opções de depuração --depurar-tipo. Os arquivos temporários são mantidos e não
excluído, o Grog saída é impressa, o nome do diretório temporário é
impressos, os nomes dos arquivos exibidos são impressos e os parâmetros são impressos.

--debug-nomes de arquivos
Imprima os nomes dos arquivos e homem páginas que são exibidos por grofer.

--debug-grog
Imprima a saída de todos Grog comandos.

--debug-keep
Habilite duas informações de depuração. Imprima o nome do diretório temporário e
mantenha os arquivos temporários, não os exclua durante a execução do grofer.

--debug-params
Imprima os parâmetros, conforme obtidos a partir dos arquivos de configuração, de GROFFER_OPT,
e os argumentos da linha de comando.

--debug-tmpdir
Imprima o nome do diretório temporário.

--fazer nada
Isto é como --versão, mas sem a saída; nenhum visualizador é iniciado. Isto faz
único sentido no desenvolvimento.

--print =texto
Basta imprimir o argumento para erro padrão. Isso é bom para verificação de parâmetro.

-V Esta é uma opção avançada apenas para depuração. Em vez de exibir o formatado
entrada, muito grofer informações específicas são impressas na saída padrão:

* o nome do arquivo de saída no diretório temporário,

* o modo de exibição do real grofer executar,

* o programa de exibição para visualizar a saída com seus argumentos,

* os parâmetros ativos dos arquivos de configuração, os argumentos em $ GROFFER_OPT e
os argumentos da linha de comando,

* o pipeline que seria executado pelo Groff programa, mas sem executá-lo.

Outras opções de depuração úteis são o Groff opção -Z e --mode = groff.

Especificação de arquivo Argumentos
A especificação de arquivo parâmetro é um argumento que não é uma opção ou argumento de opção. Dentro grofer,
especificação de arquivo parâmetros são um nome de arquivo ou um modelo para pesquisa homem páginas. Essas entradas
fontes são coletadas e compostas em um único arquivo de saída, como Groff faz.

O estranho comportamento POSIX de considerar todos os argumentos por trás do primeiro argumento de não opção como
especificação de arquivo argumentos é ignorado. O comportamento GNU para reconhecer opções, mesmo quando misturado com
especificação de arquivo argumentos é usado em todo. Mas, como de costume, o argumento duplo menos -- termina
a opção que trata e interpreta todos os seguintes argumentos como especificação de arquivo argumentos; então o
O comportamento POSIX pode ser facilmente adotado.

As opções --apropos * tem um tratamento especial de especificação de arquivo argumentos. Cada argumento é
considerado como um esquema de pesquisa próprio. Além disso, uma regexp (expressão regular) pode ser usada em
o filespec. Por exemplo, grofer --a propósito '^ gro.f $' pesquisas Groff no homem página
nome, enquanto grofer --a propósito Groff pesquisas Groff em algum lugar no nome ou descrição de
da homem páginas.

Todas as outras partes de grofer, como a exibição normal ou a saída com --o que é têm um
esquema diferente para especificações de arquivo. Nenhuma expressão regular é usada para os argumentos. O
especificação de arquivo os argumentos são tratados pelo seguinte esquema.

É preciso saber que em cada sistema o homem páginas são classificados de acordo com seus
conteúdo em várias seções. O clássico homem seções têm um nome de um único caractere,
ou um dígito de 1 para 9 ou um dos personagens n or o.

Opcionalmente, pode ser seguido por uma string, a chamada extensão. O extensão
permite armazenar vários homem páginas com o mesmo nome no mesmo seção. Mas o
extensão raramente é usado, geralmente é omitido. Então o extensões são pesquisados
automaticamente por alfabeto.

A seguir, usamos o nome seção_extensão para uma palavra que consiste em um único
personagem seção nome ou um seção caractere que é seguido por um extensão. Cada
especificação de arquivo parâmetro pode ter uma das seguintes formas em sequência decrescente.

* Não especificação de arquivo parâmetros significa que grofer aguarda a entrada padrão. A opção menos -
sempre significa entrada padrão; pode ocorrer várias vezes. Se você quiser procurar um
homem página chamado - use o argumento cara:-.

* Próximo a especificação de arquivo é testado se é o nome do caminho de um arquivo existente. Caso contrário isto
é considerado um padrão de busca por um homem página.

* homem:nome(seção_extensão), homem:nome.seção_extensão, nome(seção_extensão), or
nome.seção_extensão procure a página de manual nome na seção de homem e possivelmente extensão de
seção_extensão.

* Agora homem:nome procura por um homem página no mais baixo homem seção que tem um documento
chamado nome.

* seção_extensão nome é um padrão de 2 argumentos que se origina de um estranho
análise de argumento do homem programa. Novamente, isso pesquisa a página do manual nome com
seção_extensão, uma combinação de um seção caractere opcionalmente seguido por um
extensão.

* Ficamos com o argumento nome que não é um arquivo existente. Então, isso procura por
da homem página chamado nome no mais baixo homem seção que tem um documento para este nome.

Vários argumentos de nome de arquivo podem ser fornecidos. Eles são misturados por Groff em um único
documento. Observe que o conjunto de argumentos de opção deve caber em todos esses argumentos de arquivo.
Portanto, eles devem ter pelo menos o mesmo estilo de Groff língua.

SAÍDA MODOS

Por padrão, o grofer programa coleta todas as entradas em um único arquivo, formata-o com o
Groff programa para um determinado dispositivo e, em seguida, escolhe um programa visualizador adequado. O
dispositivo e processo do visualizador em grofer é chamado de modo. O modo e visualizador de uma corrida
grofer programa é selecionado automaticamente, mas o usuário também pode escolhê-lo com opções.
Os modos são selecionados por opção dos argumentos de --mode =qualquer modo. Além disso, cada um dos
este argumento pode ser especificado como uma opção própria, como qualquer modo. A maioria destes
modos têm um programa de visualização, que pode ser escolhido pela opção --visualizador.

Vários modos diferentes são oferecidos, modos gráficos para X Window, texto modos, e alguns
diretamente Groff modos para depuração e desenvolvimento.

Por padrão, o grofer primeiro tenta se x modo é possível então ps modo, e finalmente
tty modo. Esta sequência de teste de modo para auto modo pode ser alterado especificando uma vírgula
lista separada de modos com a opção - modos padrão.

A procura de homem páginas e a descompressão da entrada estão ativas em todos os modos.

Gráfico Ecrã Modos
Os modos de exibição gráfica funcionam principalmente no ambiente X Window (ou similar
implementações em outros ambientes de janelas). A variável de ambiente $ DISPLAY
e a opção --exibição são usados ​​para especificar a exibição da janela X a ser usada. Se este
variável de ambiente está vazia grofer assume que nenhum X Window está rodando e muda para um
texto modo. Você pode alterar este comportamento automático com a opção - modos padrão.

Visualizadores conhecidos pelos modos de exibição gráfica e seus programas de visualização padrão do X Window
e guarante que os mesmos estão

* em um visualizador de PDF (pdf modo)

* em um navegador da web (html or www modo)

* em um visualizador PostScript (ps modo)

* Janela X roff visualizadores como gxditview(1) ou xditview(1) (em x modo)

* em um programa visualizador de dvi (Dvi modo)

A pdf modo tem uma grande vantagem - é o único modo de exibição gráfica que permite
pesquisa por texto dentro do visualizador; isso pode ser um recurso muito importante. Infelizmente,
leva algum tempo para transformar a entrada no formato PDF, por isso não foi escolhido como o
modo principal.

Esses visualizadores gráficos podem ser personalizados por opções do X Window Toolkit. Mas o
grofer as opções usam um sinal de menos duplo à esquerda em vez do sinal de menos usado pelo
Conjunto de ferramentas do X Window.

Texto modos
Existem dois modos de saída de texto, modo texto para saída simples sem pager e
modo tty para uma saída de texto em um terminal de texto usando algum programa de pager.

Se a variável $ DISPLAY não está definido ou vazio, grofer assume que deve usar tty modo.

Na implementação real, o Groff dispositivo de saída latin1 é escolhido para texto modos.
Isso pode ser alterado especificando a opção -T or --dispositivo.

O pager a ser usado pode ser especificado por uma das opções --pager e --visualizador, Ou por
a variável de ambiente $ PAGER. Se tudo isso não for usado, o menos(1) programar com o
opção -r para exibir corretamente as sequências de controle é usado como o pager padrão.

Destaque Modos for depuração e Desenvolvimento
Esses modos usam o grofer determinação e descompressão de arquivos. Isso é combinado em um
único arquivo de entrada que é alimentado diretamente no Groff com estratégia diferente sem o
grofer instalações de visualização. Esses modos são considerados avançados, eles são úteis para
para fins de depuração e desenvolvimento.

A fonte modo com opção --fonte apenas exibe a entrada descompactada.

Opção --to-stdout não é exibido em modo gráfico. Ele apenas gera o arquivo para
o modo escolhido e, a seguir, imprime seu conteúdo na saída padrão.

A Groff modo passa a entrada para Groff usando apenas algumas opções adequadas fornecidas para
grofer. Isso permite ao usuário salvar a saída gerada em um arquivo ou canalizá-la para
outro programa.

In Groff modo, a opção -Z desativa o pós-processamento, produzindo assim o Groff
intermediário saída. Nesse modo, a entrada é formatada, mas não pós-processada; Vejo
groff_out(5) para obter detalhes.

Todos Groff opções curtas são suportadas por grofer.

MAN PAGE PROCURANDO

O comportamento padrão de grofer é primeiro testar se um parâmetro de arquivo representa um
arquivo local; se não for um nome de arquivo existente, presume-se que representa o nome de um
homem página. As seguintes opções podem ser usadas para determinar se os argumentos devem ser
tratado como nome de arquivo ou homem página argumentos.

--cara força a interpretar todos os parâmetros do arquivo como especificações de arquivo para procurar homem páginas.

--nenhum homem
--arquivo local
desabilite o homem procurando; portanto, apenas os arquivos locais são exibidos.

Se nem um arquivo local nem um homem página foi recuperado para algum parâmetro de arquivo, um aviso é
emitido no erro padrão, mas o processamento é continuado.

Pesquisar Algoritmo
Vamos agora assumir que um homem página deve ser pesquisado. O grofer programa fornece um
facilidade de pesquisa para homem páginas. Todas as opções longas, todas as variáveis ​​de ambiente e a maioria dos
a funcionalidade do GNU homem(1) programa foram implementados. O algoritmo de busca deve
determinar qual arquivo é exibido para um determinado homem página. O processo pode ser modificado por
opções e variáveis ​​de ambiente.

A única homem ação que é omitida em grofer são os pré-formatados homem páginas, também chamada
gato páginas. Com o excelente desempenho dos computadores atuais, o pré-formatado
homem páginas não são mais necessários. Adicionalmente, grofer é um roff programa; quer
ler roff arquivos de origem e formatá-los.

O algoritmo para recuperar o arquivo para um homem página precisa primeiro de um conjunto de diretórios.
Este conjunto começa com o chamado homem caminho que é modificado posteriormente, adicionando nomes de
operando . e língua. Este conjunto resultante é usado para adicionar a seção
diretórios que contêm o homem página arquivos.

A homem caminho é uma lista de diretórios separados por dois pontos. É gerado pelo
métodos a seguir.

* A variável de ambiente $ MANPATH Pode ser configurado.

* Pode ser lido a partir dos argumentos da variável de ambiente $ MANOPT.

* O homem caminho pode ser especificado manualmente usando a opção --manpath. Um argumento vazio
desativa o homem página procurando.

* Quando não homem caminho foi definido o caminho de homem(1) programa é tentado para determinar um.

* Se isso não funcionar, um caminho padrão razoável de $ PATH está determinado.

Agora temos um conjunto inicial de diretórios. A primeira maneira de alterar este conjunto é adicionando
nomes de operando sistemas. Isso pressupõe que homem páginas por vários operando sistemas e guarante que os mesmos estão
instalado. Isto não é sempre verdade. Os nomes de tais operando sistemas pode ser fornecido
por 3 métodos.

* A variável de ambiente $ SYSTEM tem a precedência mais baixa.

* Isso pode ser substituído por uma opção em $ MANOPT.

* Isso novamente é sobrescrito pela opção de linha de comando --sistemas.

Vários nomes de operando sistemas pode ser dado anexando seus nomes, separados por um
vírgula.

A homem caminho é alterado anexando cada . nome como subdiretório no final de cada
diretório do conjunto. Nenhum diretório do homem caminho conjunto é mantido. Mas se não . nome é
especificou o homem caminho é deixado inalterado.

Depois disso, o conjunto real de diretórios pode ser alterado por língua em formação. Isto
assume que existe homem páginas em diferentes idiomas. O Procurado língua pode ser
escolhido por vários métodos.

* Variável de ambiente $ LANG.

* Isso é substituído por $ LC_MESSAGES.

* Isso é substituído por $ LC_ALL.

* Isso pode ser substituído fornecendo uma opção em $ MANOPT.

* Todas essas variáveis ​​de ambiente são substituídas pela opção de linha de comando --localidade.

A omissão língua pode ser especificado especificando um dos parâmetros da pseudo-linguagem
C ou POSIX. É como excluir um dado anteriormente língua em formação. O homem páginas
no omissão língua são geralmente em inglês.

Naturalmente, o língua nome é determinado por homem. Em GNU homem, é especificado no
Formato baseado em POSIX 1003.1:

[_[.[,]]],

mas o código de duas letras em é suficiente para a maioria dos propósitos. Se por um
complicado língua formulação não homem páginas são encontrados grofer procura a parte do país
consistindo nesses dois primeiros caracteres também.

O diretório real definido é copiado três vezes. O língua nome é anexado como subdiretório
para cada diretório na primeira cópia do conjunto de diretórios real (isso só é feito quando um
informações sobre o idioma são fornecidas). Em seguida, a abreviatura de 2 letras do língua nome é
anexado como subdiretórios à segunda cópia do conjunto de diretórios (isso só é feito quando
o nome do idioma fornecido tem mais de 2 letras). A terceira cópia do conjunto de diretórios é
mantido inalterado (se não língua informações são fornecidas, este é o conjunto de diretórios mantido).
Essas no máximo 3 cópias são acrescentadas para obter o novo conjunto de diretórios.

Agora temos um conjunto completo de diretórios com os quais trabalhar. Em cada um desses diretórios, o
homem os arquivos são separados em seções. O nome de um seção é representado por um único
caractere, um dígito entre 1 e 9, ou o personagem o or n, nesta ordem.

Para cada disponível seção, um subdiretório homem existe contendo tudo homem arquivos
para esta seção, Onde é um único caractere conforme descrito antes. Cada homem
arquivo em um seção diretório tem a forma
homem/.[ ] [.], Onde e
são opcionais. é o nome do homem página que também é especificado como
argumento filespec na linha de comando.

A extensão é uma adição à seção. Este postfix atua como uma subseção. Um
extensão ocorre apenas no nome do arquivo, não no nome do seção subdiretório. Pode
ser especificado na linha de comando.

Por outro lado, o no mundo é apenas uma informação sobre como o arquivo é compactado.
Isso não é importante para o usuário, de modo que não pode ser especificado na linha de comando.

Existem 4 métodos para especificar um seção na linha de comando:

* Variável de ambiente $ MANSECT

* Opção de linha de comando --Seções

* Apêndice ao nome argumento na forma .

* Preargumento antes do nome argumento na forma

Também é possível especificar vários seções anexando os caracteres únicos
separados por dois pontos. Pode-se imaginar que isso significa restringir o homem página pesquisar para
apenas alguns seções. O múltiplo seções só são possíveis para $ MANSECT e --Seções.

Se nenhum seção é especificado tudo seções são pesquisados ​​um após o outro no dado
ordem, começando com seção 1, até que um arquivo adequado seja encontrado.

Existem 4 métodos para especificar um extensão na linha de comando. Mas isso não é necessário
para fornecer o nome de extensão completo, algumas abreviações são suficientes na maioria dos casos.

* Variável de ambiente $ EXTENSION

* Opção de linha de comando --extensão

* Apêndice ao . argumento na forma .

* Preargumento antes do nome argumento na forma

Para mais detalhes sobre homem página procurando, veja homem(1).

Exemplos of homem arquivos
/usr/share/man/man1/groff.1
Este é um arquivo descompactado para o homem página groff em seção 1. Pode ser chamado
by
sh # Groffer Groff
Não seção é especificado aqui, então todos seções deve ser pesquisado, mas como seção 1
é pesquisado primeiro, este arquivo será encontrado primeiro. O nome do arquivo é composto por
os seguintes componentes. / usr / share / man / deve ser parte do homem caminho; O
subdiretório man1 / e a parte .1 representar o seção; Groff é o nome do
homem página.

/usr/local/share/man/man7/groff.7.gz
O nome do arquivo é composto pelos seguintes componentes. / usr / local / share / man devo
ser parte do homem caminho; o subdiretório man7 / e a parte .7 representar o
seção; Groff é o nome do homem página; a parte final .gz representa um
compressão com gzip(1). Enquanto o seção não é o primeiro deve ser especificado
também. Isso pode ser feito por um dos seguintes comandos.
sh # Groffer Groff.7
sh # groffer 7 groffer
sh # groffer - seções = 7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Aqui você encontra / usr / local / man deve estar em homem caminho; o subdiretório man1 / e o nome do arquivo
parte .1 significa seção 1; o nome do homem página is ctags; a seção tem um
extensão emacs21; e o arquivo é compactado como . Bz2 com bzip2(1). O arquivo pode
ser visto com um dos seguintes comandos
sh # grffer ctags.1e
sh # groffer 1e ctags
sh # groffer --extension = e --sections = 1 ctags
onde e funciona como uma abreviatura para a extensão emacs21.

/usr/man/linux/de/man7/man.7.Z
O diretório / usr / man agora faz parte do homem caminho; então há um subdiretório
para um operando . nome linux /; a seguir vem um subdiretório de / para o alemão
língua; O seção nomes man7 e .7 são conhecidos até agora; homem é o nome do
homem página; e .Z significa a compressão que pode ser tratada por gzip(1). Nós queremos
agora mostra como fornecer vários valores para algumas opções. Isso é possível para
seções e operando . nomes. Então, usamos como seções 5 e 7 e quanto .
nomes linux e aix. O comando é então

sh # groffer --locale = des - seções = 5: 7 --systems = linux, aix man
sh # LANG = de MANSECT = 5: 7 SYSTEM = linux, aix groffer man

DESCOMPRESSÃO

O programa possui uma facilidade de descompressão. Se a entrada padrão ou um arquivo que foi recuperado
dos parâmetros da linha de comando é compactado com um formato que é compatível com qualquer
gzip(1) ou bzip2(1) é descomprimido em tempo real. Isso inclui o GNU .gz, . Bz2 e
o tradicional .Z compressão. O programa exibe a concatenação de todos
entrada descompactada na sequência especificada na linha de comando.

MEIO AMBIENTE

A grofer programa suporta muitas variáveis ​​de sistema, a maioria delas por cortesia de outros
programas. Todas as variáveis ​​de ambiente de Groff(1) e GNU homem(1) e algum sistema padrão
variáveis ​​são respeitadas.

Nativo grofer Variáveis
$ GROFFER_OPT
Opções da loja para uma corrida de grofer. As opções especificadas nesta variável são
substituído pelas opções fornecidas na linha de comando. O conteúdo desta variável
é executado através do shell embutido em `eval '; então, argumentos contendo espaço em branco ou
os caracteres especiais do shell devem ser citados. Não se esqueça de exportar esta variável,
caso contrário, não existe durante a execução de grofer.

System Variáveis
As seguintes variáveis ​​têm um significado especial para grofer.

$ DISPLAY
Se esta variável for definida, isso indica que o sistema X Window está em execução.
O teste dessa variável decide se a saída gráfica ou de texto é gerada.
Esta variável não deve ser alterada pelo usuário descuidadamente, mas pode ser usada para
comece o gráfico grofer em um terminal X Window remoto. Por exemplo, dependendo
em seu sistema, grofer pode ser iniciado no segundo monitor pelo comando

sh # DISPLAY =: 0.1 groffer what.ever &

$ LC_ALL
$ LC_MESSAGES
$ LANG Se uma dessas variáveis ​​for definida (na sequência acima), seu conteúdo é
interpretado como a localidade, o idioma a ser usado, especialmente ao recuperar
homem páginas. Um nome de localidade normalmente tem o formato
língua[_território[.conjunto de códigos[@mudança]]], Onde língua é um idioma ISO 639
código, território é um código de país ISO 3166 e conjunto de códigos é um conjunto de caracteres ou
identificador de codificação como ISO-8859-1 ou UTF-8; Vejo definir local(3). Os valores de localidade
C e POSIX representam o padrão, ou seja, o homem página diretórios sem linguagem
prefixo. Este é o mesmo comportamento de quando todas as 3 variáveis ​​não estão definidas.

$ PAGER Esta variável pode ser usada para definir o pager para a saída tty. Por exemplo, para
desative o uso de um pager, defina completamente esta variável para o gato(1) programa

sh # PAGER = gato groffer qualquer coisa

$ PATH Todos os programas dentro do grofer script são chamados sem um caminho fixo. Portanto, este
variável de ambiente determina o conjunto de programas usados ​​na execução de grofer.

Groff Variáveis
A grofer programa chamadas internamente Groff, então todas as variáveis ​​de ambiente documentadas em
Groff(1) são usados ​​internamente em grofer também. A seguinte variável tem um direto
significado para o grofer .

$ GROFF_TMPDIR
Se o valor desta variável for um diretório gravável existente, grofer usa isso
para armazenar seus arquivos temporários, assim como Groff faz. Veja o Groff(1) página de manual para
mais detalhes sobre a localização dos arquivos temporários.

Homem Variáveis
Partes da funcionalidade do homem programa foi implementado em grofer; suporte para todos
variáveis ​​de ambiente documentadas em homem(1) foi adicionado a grofer, mas o significado era
ligeiramente modificado devido à abordagem diferente em grofer; mas a interface do usuário é o
mesmo. O homem variáveis ​​de ambiente podem ser substituídas por opções fornecidas com $ MANOPT,
que por sua vez é sobrescrito pela linha de comando.

$ EXTENSION
Restringir a busca por homem páginas para arquivos com esta extensão. Isto é
substituído por opção --extensão; veja lá para detalhes.

$ MANOPT
Esta variável contém opções como uma predefinição para homem(1). Como nem todos esses são
Relevante para grofer apenas as partes essenciais de seu valor são extraídas. O
opções especificadas nesta variável sobrescrevem os valores do outro ambiente
variáveis ​​que são específicas para homem. Todas as opções especificadas nesta variável são
substituído pelas opções fornecidas na linha de comando.

$ MANPATH
Se definida, esta variável contém os diretórios nos quais o homem página árvores são
armazenado. Isso é substituído por opção --manpath.

$ MANSECT
Se esta for uma lista separada por dois pontos de nomes de seção, a pesquisa por homem páginas is
restrito a essas seções do manual nessa ordem. Isso é substituído por opção
--Seções.

$ SYSTEM
Se for definido como uma lista de nomes separados por vírgulas, eles serão interpretados como homem página
árvores para diferentes sistemas operacionais. Esta variável pode ser substituída por opção
--sistemas; veja lá para detalhes.

A variável de ambiente $ MANROFFSEQ é ignorado por grofer porque o necessário
os pré-processadores são determinados automaticamente.

CONFIGURAÇÃO ARQUIVOS

A grofer programa pode ser pré-configurado por dois arquivos de configuração.

/etc/groff/groffer.conf
Arquivo de configuração de todo o sistema para grofer.

$ HOME / .groff / groffer.conf
Arquivo de configuração específico do usuário para grofer, Onde $ HOME denota a casa do usuário
diretório. Este arquivo é chamado após o arquivo de configuração de todo o sistema para habilitar
substituindo pelo usuário.

Ambos os arquivos são tratados para a configuração, mas o arquivo de configuração em / Etc vem
primeiro; ele é sobrescrito pelo arquivo de configuração no diretório inicial; Ambas
arquivos de configuração são sobrescritos pela variável de ambiente $ GROFFER_OPT; tudo
é sobrescrito pelos argumentos da linha de comando.

Os arquivos de configuração contêm opções que devem ser chamadas como padrão para cada grofer
corre. Essas opções são escritas em linhas de forma que cada uma contenha uma opção longa, um
opção curta ou um cluster de opção curta; cada um com ou sem um argumento. Então, cada linha
com informações de configuração começa com um caractere menos `-'; uma linha com um longo
opção começa com dois caracteres negativos `--', uma linha com uma opção curta ou opção curta
cluster começa com um único menos `-'.

Os nomes das opções nos arquivos de configuração não podem ser abreviados, eles devem ser exatos.

O argumento para uma opção longa pode ser separado do nome da opção por um igual
sinal `='ou por espaço em branco, ou seja, um ou vários espaços ou caracteres de tabulação. Um argumento para um
short option ou short option cluster pode ser anexado diretamente ao nome da opção ou
separados por espaços em branco. O fim de um argumento é o fim da linha. Não é
tem permissão para usar uma variável de ambiente shell em um nome de opção ou argumento.

Não é necessário usar aspas em uma opção ou argumento, exceto para argumentos vazios.
Um argumento vazio pode ser fornecido anexando um par de aspas ao ponto de separação
sinal ou espaço em branco; com uma opção curta, o separador também pode ser omitido. Por um longo
opção com um sinal de igual de separação `=', o par de aspas pode ser omitido, terminando assim
a linha com o sinal de igual de separação. Todos os outros caracteres de citação são cancelados
internamente.

Nos arquivos de configuração, espaços em branco arbitrários são permitidos no início de cada linha,
é simplesmente ignorado. Cada espaço em branco dentro de uma linha é substituído por um único caractere de espaço
`'internamente.

Todas as linhas das linhas de configuração que não começam com um caractere menos são ignoradas,
de modo que comentários começando com `#' e possivel. Portanto, não há comandos de shell no
arquivos de configuração.

Como exemplo, considere o seguinte arquivo de configuração que pode ser usado em
/etc/groff/groffer.conf or ~ / .groff / groffer.conf .

# arquivo de configuração groffer
#
# opções groffer que são usadas em cada chamada de groffer
--foreground = DarkBlue
- resolução = 100
--viewer = gxditview -geometry 900x1200
--visualizador xpdf -Z 150

As linhas começando com # são simplesmente ignorados, por isso atuam como linhas de comando. Isto
configuração define quatro grofer opções (as linhas começando com `-'). Este tem o
seguintes efeitos:

* Use uma cor de texto de Azul escuro em todos os visualizadores que apoiam isso, como gxditview.

* Use uma resolução de 100dpi em todos os visualizadores que apoiam isso, como gxditview. Por
este, o dispositivo padrão em x modo está definido para X100.

* Força gxditview(1) como o modo x visualizador usando a opção de geometria para definir a largura
para 900px e a altura para 1200px. Esta geometria é adequada para uma resolução de
100dpi.

* Usar xpdf(1) como o modo pdf visualizador com o argumento -Z 150.

EXEMPLOS

O uso de grofer é muito fácil. Normalmente, é apenas chamado com um nome de arquivo ou
homem página. Os exemplos a seguir, no entanto, mostram que grofer tem muito mais fantasia
capacidades.

sh # groffer /usr/local/share/doc/groff/meintro.ms.gz

Descompacte, formate e exiba o arquivo compactado meintro.ms.gz no diretório
/ usr / local / share / doc / groff, usando o visualizador padrão gxditview como visualizador gráfico quando
no X Window, ou o menos(1) programa de pager quando não estiver no X Window.

sh # Groffer Groff

Se o arquivo ./groff existe use-o como entrada. Caso contrário, interprete o argumento como uma pesquisa
para o homem página nomeado Groff no menor possível homem seção, sendo a seção 1 neste
caso.

sh # groffer man: groff

procure o homem página of Groff mesmo quando o arquivo ./groff existe.

sh # Groffer Groff.7
sh # groffer 7 groffer

Procure o homem página of Groff in homem seção 7. Esta pesquisa de seção funciona apenas para um dígito
ou um único personagem de um pequeno conjunto.

sh # Groffer fb.modes

Se o arquivo ./fb.modos não existe, interprete isso como uma busca pelo homem página of
fb.modes. Como a extensão modos não é um único personagem no estilo clássico da seção
argumento não é dividido em uma busca por fb.

sh # groffer groff 'troff(1) 'homem: roff

Os argumentos que não são arquivos existentes são pesquisados ​​como os seguintes homem páginas: Groff
(pesquisa automática, deve ser encontrada em homem seção 1), troff (na seção 1), e roff (em
a secção com o número mais baixo, sendo 7 neste caso). As citações ao redor ,troff(1) '
são necessários porque os parênteses são caracteres especiais de shell; escapando deles com um
personagem barra invertida \( e \) seria possível também. Os arquivos formatados são
concatenado e exibido em uma peça.

sh # LANG = de groffer --man --viewer = galeon ls

Recuperar o alemão homem página (língua de) para o ls programa, descompacte-o, formate-o para
html formato (www modo) e ver o resultado no navegador da web galeão. A opção --cara
garante que o homem página é recuperado, mesmo quando um arquivo local ls existe no real
diretório.

sh # groffer --source 'man:roff(7) '

Obter o homem página chamado roff in homem seção 7, descompacte-o e imprima-o não formatado
conteúdo, seu código-fonte.

sh # groffer --de-p --in --ap

Este é um conjunto de argumentos abreviados, é determinado como

sh # groffer --debug-params --saída intermediária --a propósito

sh # cat arquivo.gz | groffer -Z -mfoo

O arquivo arquivo.gz é enviado para a entrada padrão, é descomprimido e, em seguida, é
transportado para o Groff intermediário saída modo sem pós-processamento (Groff opção
-Z), usando pacote de macro Foo (Groff opção -m).

sh # echo '\ f [CB] WOW!' |
> groffer --x --bg vermelho --fg amarelo --geometria 200x100 -

Mostra a palavra WOW! em uma pequena janela em fonte em negrito de largura constante, usando a cor amarela
fundo vermelho.

COMPATIBILIDADE

A grofer programa é escrito em Perl, a versão Perl durante a escrita era v5.8.8.

grofer fornece seu próprio analisador para argumentos de linha de comando que é compatível com ambos
POSIX obter opções(1) e GNU obteropt(1). Ele pode lidar com argumentos de opções e nomes de arquivos
contendo espaço em branco e um grande conjunto de caracteres especiais. O seguinte padrão
tipos de opções são suportados.

* A opção que consiste em um único sinal de menos - refere-se à entrada padrão.

* Um único menos seguido por caracteres se refere a uma opção de um único caractere ou um
combinação dos mesmos; por exemplo, o grofer combinação de opção curta -Qmfoo is
equivalente a -Q -m Foo.

* Opções longas são opções com nomes com mais de um caractere; eles são sempre precedidos
por um duplo menos. Um argumento de opção pode ir para o próximo argumento da linha de comando
ou ser anexado com um sinal de igual ao argumento; por exemplo, --long = arg é equivalente
para --grande arg.

* Um argumento de -- termina a análise de opções; todos os outros argumentos de linha de comando são
interpretado como especificação de arquivo parâmetros, ou seja, nomes de arquivo ou construções para pesquisa
homem páginas).

* Todos os argumentos da linha de comando que não são opções nem argumentos de opção são interpretados
as especificação de arquivo parâmetros e armazenados até que a análise de opção seja concluída. Por exemplo, o
linha de comando

sh # groffer arquivo1 -a -o arg arquivo2

é equivalente a

sh # groffer -a -o arg - arquivo1 arquivo2

A mistura gratuita de opções e especificação de arquivo parâmetros segue o princípio GNU. Isso faz
não cumpre o comportamento de opção estranho de POSIX que termina o processamento de opção assim que
o primeiro argumento não opcional foi alcançado. O fim do processamento da opção pode ser
forçado pela opção `--' de qualquer forma.

Use groffer online usando serviços onworks.net