manlifter - Online na nuvem

PROGRAMA:

NOME

manlifter - script de conversão em massa e equipamento de teste para doclifter

SINOPSE

levantador de homens [-d opção] [-e] [-f arquivo de listagem] [-Oi mandir] [-m] [-M] [-o ultrapassar]
[-p patch-diretório] [-P] [-q] [-v] [-s seção] [-X excluir] nome...

levantador de homens [-S]

DESCRIÇÃO

levantador de homens é um script que sequencia levantador de documentos(1) para converter uma árvore de página de manual inteira para
XML-Docbook, opcionalmente também gerando HTML a partir do XML. Outro uso é como um
ferramenta de teste de tortura para doclifter; ele registra os erros na saída padrão e coleta as temporizações.

Chamado sem nenhum argumento de arquivo, o manlifter tenta converter todas as páginas de manual elegíveis
instalado no sistema, colocando os arquivos xml resultantes em xmlman no atual
diretório. Cada página foo.N traduzida com sucesso é copiada para manN / foo.xml abaixo do
diretório de saída, independentemente de qual diretório de origem ele veio.

Uma página manual é considerada inelegível para conversão em lote se contiver texto indicando
foi gerado a partir de masters DocBook de Doxygen.

Para cada arquivo de origem examinado, se o arquivo de destino existe e é mais recente que o
fonte, a conversão é ignorada; assim, execuções incrementais de levantador de homens faça o mínimo de trabalho
necessário para manter a árvore XML de destino atualizada. Da mesma forma, os arquivos HTML derivados no modo -h são
feito apenas quando necessário.

Páginas de stub que são apenas .assim redirecionamentos são traduzidos para links simbólicos correspondentes de XML
arquivos (e, com -h, arquivos HTML).

levantador de homens também pode ser chamado com um único argumento de arquivo, que é interpretado como o radical
nome de uma página de manual potencial. levantador de homens em seguida, pesquisa todas as seções do manual selecionadas para
uma página correspondente e tenta convertê-la. Neste caso, uma cópia da página de manual e o
a versão convertida é descartada imediatamente abaixo do diretório de saída, com os nomes
foobar.man e foobar.man.xml, respectivamente. Este modo é normalmente apenas de interesse
para levantador de documentos desenvolvedores para depurar esse programa.

Em qualquer um dos casos acima, levantador de homens irá descompactar o arquivo se ele tiver um .gz, .bz2 ou
.Z sufixo no nome.

As opções são as seguintes:

-d
Passe o argumento da string para cada chamada do doclifter como opções. Cada token separado por espaço
na string torna-se um argumento separado na chamada.

-e
Executar no modo de filtro de registro (principalmente de interesse para levantador de documentos desenvolvedores). Neste modo,
levantador de homens lê um registro de teste da entrada padrão e o filtra de uma forma dependente de
as opções -f e -q. Se nenhum desses for fornecido, as mensagens de execuções bem-sucedidas são
eliminado e apenas os erros passados ​​para a saída padrão.

-f
Normalmente, execute doclifter nos arquivos nomeados por cada linha no arquivo de argumento. No
modo de filtro de erro, o argumento é interpretado como um filtro regular
expressão.

-h
Também gere traduções HTML no diretório de saída. Marcação citerefentry do DocBook
é transformado em hiperlinks no diretório, e uma lista de conteúdo é gerada para
index.html.

-I
Especifique a raiz da árvore da página do manual. Por padrão, é / usr / share / man.

-m
Faça um patch para corrigir a última página obtida. É copiado, um editor é chamado
a cópia (usando a variável de ambiente $ EDITOR), e depois diff(1) é chamado a cair
o patch no diretório prepatch. Falha com um erro se tal patch já estiver
presente.

-M
Levante os arquivos especificados e faça o equivalente à opção -m.

-o
Defina o diretório de saída no qual as traduções XML-DocBook serão descartadas. Por
padrão, este é xmlman no diretório atual em modo de lote, ou o atual
diretório caso contrário.

-p
Interprete o argumento como o nome de um diretório de patch (o nome padrão é prepatch
sob o diretório atual). Cada arquivo denominado foo.N.patch é interpretado como um patch para
ser aplicado à página de manual foo (N) antes que o doclifter o traduza.

-P
Habilite a criação de perfil usando o módulo Python hotshot; isso só é útil para ajuste
doclifter para que funcione mais rápido. Os dados brutos são gravados em manlifter.prof e um digerido
o relatório é anexado à saída padrão do logon. Aviso: os arquivos de dados brutos podem
tornam-se enormes, e o pós-processamento para geração de relatórios pode levar tanto tempo quanto
processamento real (ou mais!).

-q
Normalmente, passe a opção -q (silencioso) para cada chamada doclifter. No modo de filtro de erro,
retornar uma lista de arquivos em que a tradução falhou.

-v
Passe a opção -v (detalhado) para cada chamada doclifter. Esta opção pode ser repetida para
aumentar o nível de verbosidade.

-s
Especifique uma seção para digitalizar. Use isso com um argumento; não deveria ser necessário quando
fazendo uma conversão de toda a árvore.

-S
Compilar estatísticas de erro de um levantador de homens arquivo de log apresentado na entrada padrão. Esse
opção será de interesse principalmente para levantador de documentos desenvolvedores.

-X
No modo batch, exclua as páginas listadas no arquivo de argumento. Deve ser usado para páginas
que são conhecidos e demoram muito para levantar, a fim de reduzir o
hora de um teste. (A maioria das páginas sobe em menos de meio segundo, mas algumas podem demorar
15 minutos ou mais.)

levantador de homens emite um arquivo de log para a saída padrão. O arquivo começa com uma linha de carimbo de data / hora e um
linha em branco e termina com uma linha que fornece o tempo de execução e várias estatísticas interessantes.
Entre elas estão as estrofes, separadas por linhas em branco, uma para cada arquivo em que levantador de documentos
foi executado.

A primeira linha de cada estrofe começa com "!", Seguida pelo nome do caminho da fonte
pager manual, seguido por "=" e o status de retorno do doclifter executado naquele arquivo.
A seguir está um espaço e levantador de documentostempo de execução de em segundos.

Esta linha inicial pode ser seguida por mensagens de informação e a saída de erro do
corrida doclifter.

levantador de homens deve encontrar uma cópia de levantador de documentos no diretório atual ou em um dos
diretórios de comando em seu PATH para funcionar.

Use manlifter online usando serviços onworks.net