manlifter - Online în cloud

PROGRAM:

NUME

manlifter - script de conversie în masă și ham de testare pentru doclifter

REZUMAT

ridicător de oameni [-d opțiune] [-e] [-f listfile] [-Salut Mandir] [-m] [-M] [-o outdir]
[-p patch-director] [-P] [-q] [-v] [-s secțiune] [-X exclude] nume...

ridicător de oameni [-S]

DESCRIERE

ridicător de oameni este un script care secvențiază doclifter(1) pentru a converti un întreg arbore de pagină manuală în
XML-Docbook, opțional generând și HTML din XML. O altă utilizare este ca a
instrument de testare a torturii pentru doclifter; înregistrează erorile la ieșirea standard și colectează timpii.

Apelat fără niciun argument de fișier, manlifter încearcă să convertească toate paginile de manual eligibile
instalat pe sistem, plasând fișierele xml rezultate sub xmlman în curent
director. Fiecare pagină tradusă cu succes foo.N este copiată în manN/foo.xml sub
directorul de ieșire, indiferent de directorul sursă din care provine.

O pagină manuală este considerată neeligibilă pentru conversie în lot dacă conține text care indică
a fost generat de la maeștri DocBook de la Doxygen.

Pentru fiecare fișier sursă examinat, dacă fișierul destinație există și este mai nou decât fișierul
sursă, conversia este omisă; astfel, rulări incrementale de ridicător de oameni face cel mai putin lucru
necesare pentru a menține actualizat arborele XML țintă. De asemenea, în modul -h fișierele HTML derivate sunt
făcute doar atunci când este necesar.

Pagini stub care sunt doar .asa de redirecționările sunt traduse în legăturile simbolice corespunzătoare ale XML
fișiere (și, cu -h, fișiere HTML).

ridicător de oameni poate fi apelat și cu un singur argument de fișier, care este interpretat ca tulpină
numele unei posibile pagini de manual. ridicător de oameni apoi caută în toate secțiunile manuale selectate
o pagină care se potrivește și încearcă să o convertească. În acest caz, o copie a paginii de manual și a
versiunile convertite sunt aruncate imediat sub directorul de ieșire, cu numele
foobar.man și, respectiv, foobar.man.xml. În mod normal, acest mod este doar de interes
la doclifter dezvoltatori pentru depanarea programului respectiv.

În oricare dintre cazurile de mai sus, ridicător de oameni va decomprima fișierul dacă are .gz, .bz2 sau
.Z sufix pe nume.

Opțiunile sunt următoarele:

-d
Treceți argumentul șir la fiecare apel doclifter ca opțiuni. Fiecare jeton separat de spațiu
în șir devine un argument separat în apel.

-e
Rulați în modul de filtrare a jurnalelor (de interes în principal pentru doclifter dezvoltatori). În acest mod,
ridicător de oameni citește un jurnal de testare din intrarea standard și îl filtrează într-un mod dependent de
opțiunile -f și -q. Dacă niciunul dintre acestea nu este dat, mesajele de la rulări reușite sunt
eliminate și numai erorile au trecut la ieșirea standard.

-f
În mod normal, rulați doclifter pe fișierele numite de fiecare linie din fișierul argument. În
modul de filtrare a erorilor, argumentul este interpretat ca un obișnuit de filtrare
expresie.

-h
Generați, de asemenea, traduceri HTML în directorul de ieșire. Markup Citerefentry DocBook
este transformată în hyperlinkuri în director și este generată o listă de conținut
index.html.

-I
Specificați rădăcina arborelui paginilor manuale. În mod implicit, acesta este /usr/share/man.

-m
Faceți un patch pentru a corecta ultima pagină preluată. Este copiat, se apelează la un editor
copia (folosind variabila de mediu $ EDITOR), și apoi dif(1) este chemat să renunțe
patch-ul din directorul de prepatch. Eșuează cu o eroare dacă un astfel de patch este deja
prezent.

-M
Ridicați fișierele specificate, apoi faceți echivalentul opțiunii -m.

-o
Setați directorul de ieșire în care vor fi plasate traducerile XML-DocBook. De
implicit, acesta este xmlman sub directorul curent în modul lot, sau curentul
director altfel.

-p
Interpretați argumentul ca numele unui director de corecție (numele implicit este prepatch
sub directorul curent). Fiecare fișier numit foo.N.patch este interpretat ca un patch pentru
să fie aplicată la pagina de manual foo(N) înainte ca doclifter să o traducă.

-P
Activați profilarea utilizând modulul Python hotshot; acest lucru este util doar pentru reglare
doclifter, astfel încât să ruleze mai repede. Datele brute sunt scrise pe manlifter.prof și sunt digerate
raportul este atașat la jurnalul de ieșire standard. Atenție: fișierele de date brute pot
devin imense, iar postprocesarea pentru generarea rapoartelor poate dura atât timp cât
procesare efectivă (sau mai lungă!).

-q
În mod normal, transmiteți opțiunea -q (liniștită) la fiecare apel de doclifter. În modul de filtrare a erorilor,
returnează o listă de fișiere în care traducerea a eșuat.

-v
Transmiteți opțiunea -v (verboză) la fiecare apel de doclifter. Această opțiune poate fi repetată la
crește nivelul de verbozitate.

-s
Specificați o secțiune de scanat. Folosește asta cu un argument; nu ar trebui să fie necesar când
făcând o conversie a întregului arbore.

-S
Compilați statistici de eroare de la a ridicător de oameni fișier jurnal prezentat la intrarea standard. Acest
opțiunea va fi de interes în principal pentru doclifter dezvoltatori.

-X
În modul lot, excludeți paginile listate în fișierul cu argumente. Menit să fie folosit pentru pagini
care sunt cunoscute bine și durează extrem de mult să se ridice, pentru a reduce
timpul pentru o rulare de probă. (Majoritatea paginilor se ridică în mai puțin de o jumătate de secundă, dar câteva pot dura
15 minute sau mai mult.)

ridicător de oameni emite un fișier jurnal la ieșirea standard. Fișierul începe cu o linie de marcaj temporal și a
linie goală și se termină cu o linie care oferă timpul de rulare și diverse statistici interesante.
Între acestea sunt strofe, separate prin rânduri goale, câte una pentru fiecare fișier pe care doclifter
a fost condus.

Primul rând al fiecărei strofe începe cu „!”, urmat de calea sursei
paginatorul manual, urmat de „=" și starea de returnare a doclifter rulează pe acel fișier.
Urmează un spațiu și doclifterdurata de rulare a lui în secunde.

Această linie inițială poate fi urmată de mesaje de informații și de ieșirea de eroare a
doclifter alerga.

ridicător de oameni trebuie să găsească o copie a doclifter fie în directorul curent, fie în unul dintre
directoarele de comenzi din dvs PATH pentru a alerga.

Utilizați Manlifter online folosind serviciile onworks.net