manlifter - Online in de cloud

PROGRAMMA:

NAAM

manlifter - massa-conversiescript en testharnas voor doclifter

KORTE INHOUD

manlifter [-NS optie] [-e] [-f lijstbestand] [-Hoi mandir] [-m] [-M] [-o buiten de deur]
[-P patch-map] [-P] [-q] [-v] [-s sectie] [-X uitsluiten] naam...

manlifter [-S]

PRODUCTBESCHRIJVING

manlifter is een script dat een reeks volgt doklifter(1) om een ​​volledige man-paginaboom te converteren naar
XML-Docbook, optioneel ook HTML genereren uit de XML. Een ander gebruik is als een
marteltesttool voor doclifter; het registreert fouten naar standaarduitvoer en verzamelt timings.

Aangeroepen zonder enige bestandsargumenten, probeert manlifter alle in aanmerking komende man-pagina's te converteren
geïnstalleerd op het systeem, waarbij de resulterende xml-bestanden onder xmlman in de huidige
map. Elke succesvol vertaalde pagina foo.N wordt gekopieerd naar manN/foo.xml onder de
output directory, ongeacht uit welke brondirectory het kwam.

Een handmatige pagina komt niet in aanmerking voor batchconversie als deze tekst bevat die aangeeft:
het is gegenereerd uit DocBook-masters of uit Doxygen.

Voor elk onderzocht bronbestand, als het doelbestand bestaat en nieuwer is dan de
source, de conversie wordt overgeslagen; dus incrementele runs van manlifter doe het minste werk
nodig om de doel-XML-structuur up-to-date te houden. Evenzo zijn in -h-modus afgeleide HTML-bestanden:
alleen gemaakt als dat nodig is.

Stub-pagina's die gewoon zijn .zo omleidingen worden vertaald naar overeenkomstige symbolische links van XML
bestanden (en, met -h, HTML-bestanden).

manlifter kan ook worden aangeroepen met een enkel bestandargument, dat wordt geïnterpreteerd als de stam
naam van een mogelijke handmatige pagina. manlifter zoekt vervolgens in alle geselecteerde handmatige secties naar
een overeenkomende pagina en probeert deze te converteren. In dit geval een kopie van de man-pagina en de
geconverteerde versie worden onmiddellijk onder de uitvoermap verwijderd, met de namen
respectievelijk foobar.man en foobar.man.xml. Deze modus is normaal gesproken alleen van belang
naar doklifter ontwikkelaars voor het debuggen van dat programma.

In elk van de bovenstaande gevallen, manlifter zal het bestand decomprimeren als het een .gz, .bz2 of . heeft
.Z achtervoegsel op de naam.

De opties zijn als volgt:

-d
Geef het stringargument door aan elke doclifter-aanroep als opties. Elke door spatie gescheiden token
in de string wordt een apart argument in de aanroep.

-e
Uitvoeren in log-filter-modus (voornamelijk van belang voor) doklifter ontwikkelaars). In deze modus,
manlifter leest een testlogboek van standaardinvoer en filtert het op een manier die afhankelijk is van
de -f en -q opties. Als geen van beide wordt gegeven, zijn berichten van succesvolle runs:
uitgekleed en alleen fouten doorgegeven aan standaarduitvoer.

-f
Voer normaal gesproken doclifter uit op de bestanden die door elke regel in het argumentbestand worden genoemd. In
error-filter mode het argument wordt in plaats daarvan geïnterpreteerd als een filter regelmatig
expressie.

-h
Genereer ook HTML-vertalingen in de uitvoermap. DocBook citerefentry markup
wordt omgezet in hyperlinks in de directory en er wordt een inhoudslijst gegenereerd om
index.html.

-I
Specificeer de root van de man-page tree. Standaard is dit /usr/share/man.

-m
Maak een patch om de laatst opgehaalde pagina te corrigeren. Het wordt gekopieerd, een editor wordt ingeschakeld
de kopie (met behulp van de omgevingsvariabele) $ EDITOR), en dan diff(1) wordt geroepen om te laten vallen
de patch in de prepatch-directory. Mislukt met een fout als zo'n patch al is
aanwezig is.

-M
Til de opgegeven bestanden op en voer vervolgens het equivalent van de optie -m uit.

-o
Stel de uitvoermap in waarin XML-DocBook-vertalingen worden neergezet. Door
standaard is dit xmlman onder de huidige map in batchmodus, of de huidige
directory anders.

-p
Interpreteer het argument als de naam van een patchdirectory (de standaardnaam is prepatch
onder de huidige directory). Elk bestand met de naam foo.N.patch wordt geïnterpreteerd als een patch om
worden toegepast op de man-pagina foo(N) voordat doclifter deze vertaalt.

-P
Activeer profilering met behulp van de Python hotshot-module; dit is alleen nuttig voor het afstemmen
doclifter zodat het sneller werkt. Ruwe gegevens worden naar manlifter.prof geschreven en een verteerd
rapport wordt toegevoegd aan de log op standaarduitvoer. Waarschuwing: de bestanden met onbewerkte gegevens kunnen
enorm worden, en de nabewerking voor het genereren van rapporten kan zo lang duren als de
daadwerkelijke verwerking (of langer!).

-q
Geef normaal gesproken de -q (stil) optie door aan elke doclifter-aanroep. In de foutfiltermodus,
een lijst met bestanden retourneren waarvan de vertaling is mislukt.

-v
Geef de -v (uitgebreide) optie door aan elke doclifter-aanroep. Deze optie kan worden herhaald om
het breedsprakigheidsniveau verhogen.

-s
Geef een sectie op om te scannen. Gebruik dit met een argument; het zou niet nodig moeten zijn wanneer
het doen van een conversie van de hele boom.

-S
Compileer foutstatistieken van a manlifter logbestand gepresenteerd op standaard invoer. Dit
optie zal vooral interessant zijn voor doklifter ontwikkelaars.

-X
Sluit in batchmodus pagina's uit die in het argumentbestand staan. Bedoeld om te worden gebruikt voor pagina's
die goed bekend zijn en extreem lang duren om op te tillen, om de
tijd voor een proefrit. (De meeste pagina's komen in minder dan een halve seconde omhoog, maar een paar kan duren
15 minuten of langer.)

manlifter zendt een logbestand uit naar standaarduitvoer. Het bestand begint met een tijdstempelregel en a
lege regel, en eindigt met een regel die runtime en verschillende interessante statistieken geeft.
Hiertussen bevinden zich strofen, gescheiden door lege regels, één voor elk bestand waarop: doklifter
werd uitgevoerd.

De eerste regel van elke strofe begint met "! ", gevolgd door de padnaam van de bron
handmatige pager, gevolgd door "=" en de retourstatus van doclifter wordt uitgevoerd op dat bestand.
Daarna volgt een spatie en doklifterlooptijd in seconden.

Deze eerste regel kan worden gevolgd door informatieberichten en de foutuitvoer van de
doclifter lopen.

manlifter moet een kopie vinden van doklifter in ofwel de huidige map of een van de
opdrachtmappen in uw PATH om te rennen.

Gebruik manlifter online met onworks.net-services