Dies ist der Befehl docbook2man-spec.pl, der beim kostenlosen Hosting-Anbieter OnWorks mit einer unserer zahlreichen kostenlosen Online-Workstations wie Ubuntu Online, Fedora Online, dem Windows-Online-Emulator oder dem MAC OS-Online-Emulator ausgeführt werden kann
PROGRAMM:
NAME/FUNKTION
docbook2man-spec.pl – DocBook RefEntries in Manpages konvertieren
ZUSAMMENFASSUNG
sgmlspl docbook2man-spec.pl
nsgmls [ sgml Dokument ]| sgmlspl docbook2man-spec.pl
BESCHREIBUNG
docbook2man ist eine sgmlspl-Spezifikationsdatei, aus der Manpages (unter Verwendung der -man-Makros) erstellt wurden
DocBook RefEntry-Markup.
Das Programm liest von nsgmls (oder anderen SGML-Parsern) erstellte ESIS aus der Standardeingabe.
Markup, das nicht in RefEntry gefunden wurde, wird verworfen.
Seine Ausgabe, die konvertierten Manpages, werden in das aktuelle Verzeichnis geschrieben. Wenn RefMeta
Wenn in einem RefEntry keine Informationen angegeben sind, wird die Manpage standardmäßig geschrieben
Ausgabe.
Die Datei manpage.links Außerdem wird eine Datei erstellt, die alle Aliase der Manpages enthält
generiert. Diese Datei hat das folgende Format:
<Mann Seite> <Alias
Manpage>
Das manpage.refs Die Datei verfolgt die XRef-Referenzen. Beachten Sie, dass das Eingabedokument vorhanden ist
dann irgendwelche Vorwärtsverweise docbook2man Möglicherweise muss es zweimal aufgerufen werden (das erste Mal).
Aktualisierung manpage.refs), um sie zu lösen.
VORAUSSETZUNGEN
Das SGMLSpm-Paket von CPAN. Dieses Paket enthält auch das sgmlspl-Skript
Installation!
EINSCHRÄNKUNGEN
Der Versuch, docbook2man auf nicht DocBook oder nicht konformem SGML führt zu undefiniertem Verhalten.
:-)
Dieses Programm ist ein langsames, zwielichtiges Perl-Skript.
Dieses Programm unterstützt nicht annähernd alle möglichen Markups in DocBook und kann dies auch tun
In einigen Fällen kann es bei unterstütztem Markup zu einer falschen Ausgabe kommen.
TO DO
Offensichtliches Zeug:
· Korrigieren docbook2man Insbesondere wurden Brüche in den Prüfunterlagen festgestellt seltsam.sgml.
· Fügen Sie eine neue Elementbehandlung hinzu und korrigieren Sie die vorhandene Handhabung. Seien Sie robust.
· Erzeugen Sie eine möglichst saubere, lesbare Ausgabe (im Gegensatz zu einigen anderen Konvertern).
Folgen Sie Linux Mann(7) Konvention. Da die Konvertierung in Manpages normalerweise nicht sehr erfolgt
Oft ist es besser, langsamer/komplizierter zu sein, als eine falsche Ausgabe zu erzeugen. Auch wenn
Jemand möchte aus irgendeinem Grund auf die Nutzung von DocBook verzichten, den zuletzt konvertierten Manpages
können dann manuell gepflegt werden.
· Mach es schneller. Ich denke, die meisten Geschwindigkeitsprobleme liegen bisher beim Parsen von ESIS. Umschreiben
SGMLS.pm mit C und/oder erhalten Sie Eingaben direkt von SP.
· Unterstützen Sie andere (menschliche) Sprachen. Aber was tun mit Nicht-ASCII-Zeichensätzen? SGMLSpm
meldet sie nicht und ab grokt sie nicht. [Kommentar: Text nach beigefügten Listen
(und SS-Blöcke) werden docbook2man zerstören] Wenn wir dies tun, können mehr Leute DocBook verwenden.
COPYRIGHT
Copyright (C) 1998-1999 Steve Cheng[E-Mail geschützt] >
Dieses Programm ist freie Software; Sie können es unter den Bedingungen von . weitergeben und/oder ändern
die GNU General Public License, wie von der Free Software Foundation veröffentlicht; entweder
Version 2 oder (nach Ihrer Wahl) eine spätere Version.
Zusammen mit diesem Programm sollten Sie eine Kopie der GNU General Public License erhalten haben;
siehe die Datei KOPIEREN. Wenn nicht, schreiben Sie bitte an die Free Software Foundation, 675 Mass Ave,
Cambridge, MA 02139, USA.
29. Oktober 2012 DOCBOOK2MAN-SPEC.PL(1)
Nutzen Sie docbook2man-spec.pl online über die Dienste von onworks.net
