manlifter - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

manlifter - Massenkonvertierungsskript und Testkabel für doclifter

ZUSAMMENFASSUNG

Menschenheber [-D zu erhalten] [-e] [-f Listendatei] [-Hi mandir] [-m] [-M] [-o draußen]
[-P Patch-Verzeichnis] [-P] [-q] [-v] [-s Abschnitt] [-X ausschließen] Name...

Menschenheber [-S]

BESCHREIBUNG

Menschenheber ist ein Skript, das sequenziert Doclifter(1) um einen ganzen Handbuchseitenbaum in umzuwandeln
XML-Docbook, optional auch HTML aus dem XML generieren. Eine andere Verwendung ist als a
Foltertestwerkzeug für Doclifter; es protokolliert Fehler in der Standardausgabe und sammelt Zeitangaben.

Ohne Dateiargumente aufgerufen, versucht manlifter, alle geeigneten Manpages zu konvertieren
auf dem System installiert und die resultierenden XML-Dateien unter xmlman im aktuellen
Verzeichnis. Jede erfolgreich übersetzte Seite foo.N wird nach manN/foo.xml unter dem . kopiert
Ausgabeverzeichnis, unabhängig davon, aus welchem ​​Quellverzeichnis es stammt.

Eine Handbuchseite gilt als nicht für die Stapelkonvertierung geeignet, wenn sie Text enthält, der angibt
es wurde von DocBook-Mastern oder von Doxygen generiert.

Für jede untersuchte Quelldatei, wenn die Zieldatei existiert und neuer ist als die
Quelle, die Konvertierung wird übersprungen; also inkrementelle Läufe von Menschenheber am wenigsten arbeiten
erforderlich, um den Ziel-XML-Baum auf dem neuesten Stand zu halten. Ebenso sind im -h-Modus abgeleitete HTML-Dateien
nur bei Bedarf gemacht.

Stub-Seiten, die einfach sind .so Umleitungen werden in entsprechende Symlinks von XML übersetzt
Dateien (und mit -h HTML-Dateien).

Menschenheber kann auch mit einem einzigen Dateiargument aufgerufen werden, das als Stamm interpretiert wird
Name einer möglichen Handbuchseite. Menschenheber durchsucht dann alle ausgewählten manuellen Abschnitte nach
eine passende Seite und versucht, sie zu konvertieren. In diesem Fall eine Kopie der Manpage und der
konvertierte Version werden sofort über dem Ausgabeverzeichnis mit den Namen abgelegt
foobar.man bzw. foobar.man.xml. Dieser Modus ist normalerweise nur von Interesse
zu Doclifter Entwickler für das Debuggen dieses Programms.

In jedem der oben genannten Fälle, Menschenheber wird die Datei dekomprimieren, wenn sie eine .gz, .bz2 oder hat
.Z-Suffix im Namen.

Folgende Optionen stehen zur Verfügung:

-d
Übergeben Sie das String-Argument als Optionen an jeden doclifter-Aufruf. Jedes durch Leerzeichen getrennte Token
in der Zeichenfolge wird im Aufruf zu einem separaten Argument.

-e
Im Log-Filter-Modus ausführen (hauptsächlich von Interesse für Doclifter Entwickler). In diesem Modus
Menschenheber liest ein Testprotokoll aus der Standardeingabe und filtert es in Abhängigkeit von
die Optionen -f und -q. Wenn keines von beiden angegeben ist, werden Meldungen von erfolgreichen Läufen
entfernt und nur Fehler an die Standardausgabe weitergegeben.

-f
Führen Sie normalerweise doclifter für die Dateien aus, die von jeder Zeile in der Argumentdatei genannt werden. In
Fehlerfiltermodus das Argument wird stattdessen als Filterregelwert interpretiert
Ausdruck.

-h
Generieren Sie auch HTML-Übersetzungen in das Ausgabeverzeichnis. DocBook-Citerefentry-Markup
in Hyperlinks im Verzeichnis umgewandelt, und eine Inhaltsliste wird generiert, um
index.html.

-I
Geben Sie den Stamm des Handbuchseitenbaums an. Standardmäßig ist dies /usr/share/man.

-m
Erstellen Sie einen Patch, um die zuletzt abgerufene Seite zu korrigieren. Es wird kopiert, ein Editor wird aufgerufen
die Kopie (unter Verwendung der Umgebungsvariablen $ EDITOR), und dann diff(1) heißt fallen
den Patch im Prepatch-Verzeichnis. Schlägt mit einem Fehler fehl, wenn ein solcher Patch bereits vorhanden ist
Geschenk.

-M
Heben Sie die angegebenen Dateien an, und führen Sie dann das Äquivalent der Option -m aus.

-o
Legen Sie das Ausgabeverzeichnis fest, in das XML-DocBook-Übersetzungen abgelegt werden. Von
Standardmäßig ist dies xmlman unter dem aktuellen Verzeichnis im Batch-Modus oder das aktuelle
Verzeichnis sonst.

-p
Interpretieren Sie das Argument als den Namen eines Patch-Verzeichnisses (der Standardname ist prepatch
unter dem aktuellen Verzeichnis). Jede Datei namens foo.N.patch wird als Patch zu . interpretiert
auf die Handbuchseite foo(N) angewendet werden, bevor doclifter sie übersetzt.

-P
Aktivieren Sie die Profilerstellung mit dem Python-Hotshot-Modul; das ist nur zum abstimmen sinnvoll
doclifter, damit es schneller läuft. Rohdaten werden in manlifter.prof geschrieben und ein verdautes
Der Bericht wird bei der Standardausgabe an das Protokoll angehängt. Achtung: Die Rohdatendateien können
groß werden, und die Nachbearbeitung für die Berichterstellung kann so lange dauern, wie die
tatsächliche Verarbeitung (oder länger!).

-q
Normalerweise übergeben Sie die Option -q (quiet) an jeden doclifter-Aufruf. Im Fehlerfiltermodus,
eine Liste der Dateien zurückgeben, deren Übersetzung fehlgeschlagen ist.

-v
Übergeben Sie die Option -v (ausführlich) an jeden doclifter-Aufruf. Diese Option kann wiederholt werden, um
die Ausführlichkeitsstufe erhöhen.

-s
Geben Sie einen zu scannenden Abschnitt an. Verwenden Sie dies mit einem Argument; es sollte nicht notwendig sein, wenn
eine Konvertierung des gesamten Baumes durchführen.

-S
Fehlerstatistik aus a . zusammenstellen Menschenheber logfile, das auf der Standardeingabe angezeigt wird. Dies
Option wird vor allem interessant sein für Doclifter Entwickler.

-X
Schließen Sie im Stapelmodus Seiten aus, die in der Argumentdatei aufgeführt sind. Soll für Seiten verwendet werden
die bekanntermaßen gut sind und extrem lange zu heben brauchen, um die
Zeit für einen Probelauf. (Die meisten Seiten werden in weniger als einer halben Sekunde angehoben, aber einige können dauern
15 Minuten oder länger.)

Menschenheber gibt eine Protokolldatei an die Standardausgabe aus. Die Datei beginnt mit einer Zeitstempelzeile und a
Leerzeile und endet mit einer Zeile, die die Laufzeit und verschiedene interessante Statistiken angibt.
Dazwischen befinden sich durch Leerzeilen getrennte Strophen, eine für jede Datei, auf der Doclifter
gelaufen wurde.

Die erste Zeile jeder Strophe beginnt mit "! ", gefolgt vom Pfadnamen der Quelle
Manual Pager, gefolgt von "=" und dem Rückgabestatus von doclifter laufen auf dieser Datei.
Darauf folgt ein Leerzeichen und Doclifter's Laufzeit in Sekunden.

Auf diese Anfangszeile können Informationsmeldungen und die Fehlerausgabe des
doclifter laufen.

Menschenheber muss eine Kopie von finden Doclifter entweder im aktuellen Verzeichnis oder in einem der
Befehlsverzeichnisse in Ihrem PATH um zu laufen.

Verwenden Sie manlifter online mit den onworks.net-Diensten