manlifter - Online nel cloud

PROGRAMMA:

NOME

manlifter - script di conversione di massa e cablaggio di prova per doclifter

SINOSSI

sollevatore di uomini [-D opzione] [-e] [-f listfile] [-Ciao mandir] [-m] [-M] [-o fuori di testa]
[-P directory-patch] [-P] [-q] [-v] [-s pagina] [-X escludere] Nome...

sollevatore di uomini [-S]

DESCRIZIONE

sollevatore di uomini è uno script che sequenzia sollevatore di documenti(1) per convertire un intero albero di pagine di manuale in
XML-Docbook, facoltativamente anche generando HTML dall'XML. Un altro uso è come a
strumento di tortura per doclifter; registra gli errori nell'output standard e raccoglie i tempi.

Chiamato senza alcun argomento file, manlifter tenta di convertire tutte le pagine man idonee
installato sul sistema, posizionando i file xml risultanti sotto xmlman nella corrente
directory. Ogni pagina tradotta con successo foo.N viene copiata in manN/foo.xml sotto il
directory di output, indipendentemente dalla directory di origine da cui proviene.

Una pagina di manuale è considerata non idonea per la conversione batch se contiene testo che indica
è stato generato da master DocBook o da Doxygen.

Per ogni file sorgente esaminato, se il file di destinazione esiste ed è più recente del
source, la conversione viene saltata; quindi, corse incrementali di sollevatore di uomini fare il minimo lavoro
necessario per mantenere aggiornato l'albero XML di destinazione. Allo stesso modo, in modalità -h i file HTML derivati ​​sono
fatto solo quando necessario.

Stub pagine che sono solo .così i reindirizzamenti sono tradotti nei corrispondenti collegamenti simbolici di XML
file (e, con -h, file HTML).

sollevatore di uomini può anche essere chiamato con un singolo argomento file, che viene interpretato come la radice
nome di una potenziale pagina di manuale. sollevatore di uomini quindi cerca tutte le sezioni manuali selezionate per
una pagina corrispondente e tenta di convertirla. In questo caso, una copia della pagina man e del
la versione convertita viene rilasciata immediatamente sotto la directory di output, con i nomi
foobar.man e foobar.man.xml, rispettivamente. Questa modalità è normalmente solo di interesse
a sollevatore di documenti sviluppatori per il debug di quel programma.

In uno dei casi precedenti, sollevatore di uomini decomprimerà il file se ha .gz, .bz2 o
Suffisso .Z sul nome.

Le opzioni sono le seguenti:

-d
Passa l'argomento stringa a ogni chiamata doclifter come opzioni. Ogni token separato da spazi
nella stringa diventa un argomento separato nella chiamata.

-e
Esegui in modalità filtro di registro (principalmente di interesse per sollevatore di documenti sviluppatori). In questa modalità,
sollevatore di uomini legge un registro di prova dallo standard input e lo filtra in un modo dipendente da
le opzioni -f e -q. Se nessuno di questi viene fornito, i messaggi delle esecuzioni riuscite sono
eliminati e solo gli errori passati all'output standard.

-f
Normalmente, esegui doclifter sui file nominati da ogni riga nel file degli argomenti. In
modalità di filtro degli errori l'argomento viene invece interpretato come un filtro regolare
espressione.

-h
Genera anche traduzioni HTML nella directory di output. DocBook citerefentry markup
viene trasformato in collegamenti ipertestuali nella directory e viene generato un elenco di contenuti per
indice.html.

-I
Specificare la radice dell'albero delle pagine di manuale. Di default questo è /usr/share/man.

-m
Crea una patch per correggere l'ultima pagina recuperata. Viene copiato, viene chiamato un editore
la copia (usando la variabile d'ambiente $ EDITOR), e poi diff(1) è chiamato a cadere
la patch nella directory prepatch. Fallisce con un errore se tale patch è già presente
presente.

-M
Solleva i file specificati, quindi esegui l'equivalente dell'opzione -m.

-o
Imposta la directory di output in cui verranno rilasciate le traduzioni XML-DocBook. Di
predefinito questo è xmlman nella directory corrente in modalità batch o corrente
directory in caso contrario.

-p
Interpreta l'argomento come il nome di una directory di patch (il nome predefinito è prepatch
nella directory corrente). Ogni file chiamato foo.N.patch viene interpretato come una patch per
essere applicato alla pagina di manuale foo(N) prima che doclifter lo traduca.

-P
Abilita la profilazione utilizzando il modulo hotshot di Python; questo è utile solo per l'accordatura
doclifter in modo che funzioni più velocemente. I dati grezzi vengono scritti su manlifter.prof e un digest
report viene allegato al log sullo standard output. Attenzione: i file di dati grezzi possono
diventare enorme e la post-elaborazione per la generazione di report può richiedere tutto il tempo
elaborazione effettiva (o più lunga!).

-q
Normalmente, passa l'opzione -q (quiet) a ogni chiamata doclifter. In modalità filtro errori,
restituisce un elenco di file in cui la traduzione non è riuscita.

-v
Passa l'opzione -v (verbose) a ogni chiamata doclifter. Questa opzione può essere ripetuta a
aumentare il livello di verbosità.

-s
Specificare una sezione da scansionare. Usa questo con un argomento; non dovrebbe essere necessario quando
effettuando una conversione dell'intero albero.

-S
Compila statistiche di errore da a sollevatore di uomini file di log presentato sullo standard input. Questo
opzione sarà di interesse principalmente per sollevatore di documenti sviluppatori.

-X
In modalità batch esclude le pagine elencate nel file degli argomenti. Pensato per essere usato per le pagine
che sono noti bene e richiedono molto tempo per essere sollevati, al fine di ridurre il
tempo per una prova. (La maggior parte delle pagine si solleva in meno di mezzo secondo, ma alcune possono richiedere
15 minuti o più.)

sollevatore di uomini emette un file di registro sullo standard output. Il file inizia con una linea di timestamp e a
riga vuota e termina con una riga che fornisce il tempo di esecuzione e varie statistiche interessanti.
Tra queste ci sono strofe, separate da righe vuote, una per ogni file su cui sollevatore di documenti
è stato eseguito.

La prima riga di ogni strofa inizia con "!", seguita dal percorso della fonte
pager manuale, seguito da "=" e lo stato di ritorno di doclifter eseguito su quel file.
A seguire c'è uno spazio e sollevatore di documenti's runtime in secondi.

Questa riga iniziale può essere seguita da messaggi informativi e dall'output di errore del
corsa doclifter.

sollevatore di uomini deve trovare una copia di sollevatore di documenti nella directory corrente o in una delle
directory dei comandi nel tuo PERCORSO per correre.

Usa manlifter online utilizzando i servizi onworks.net