Ich würde gerne Handbuchseiten ausdrucken, bzw. als Textdatei formatieren. Die Seiten liegen aber in einem abstrusen Format vor. Wie kann ich es anstellen, diese Dinger in Textformat zu bringen?
Handbuchseiten liegen in einem Format vor, das für ein Textsatzprogramm mit Namen groff gedacht ist. Dieses Textsatzprogramm kann verschiedene Ausgabeformate unterstützen, z.B. ASCII, Postscript, dvi, …
Zusätzlich ist die Handbuchseite in der Regel mit gzip komprimiert. Bevor sie mit groff bearbeitet werden kann, muß sie dekomprimiert werden. Dazu dient uns hier das Programm zcat, das komprimierte Dateien dekomprimiert auf die Standard-Ausgabe schreibt.
Der Befehl zur manuellen Formatierung einer Handbuchseite ist grundsätzlich also
zcat Handbuchseitendatei.gz | groff -Tformat -mandoc
Dabei können als Format z.B. ascii für reinen Text, ps für Postscript oder html gewählt werden. Das Ergebnis wird wieder auf die Standard-Ausgabe geschrieben und kann so entweder an ein entsprechendes Programm weitergepiped werden oder in eine Datei gespeichert werden.
Um also die Handbuchseite des Befehls cp(1) manuell in Postscript zu verwandeln und sie dann in die Datei cp.ps abzulegen, schreiben Sie
zcat /usr/share/man/man1/cp.1.gz | groff -Tps -mandoc > cp.ps
Hätten wir sie in eine Textdatei oder in eine Webseite (HTML) verwandeln wollen, hätten wir schreiben müssen
zcat /usr/share/man/man1/cp.1.gz | groff -Tascii -mandoc > cp.txt zcat /usr/share/man/man1/cp.1.gz | groff -Thtml -mandoc > cp.html
Speziell für die Umwandlung von Handbuchseiten in verschiedene Formate gibt es auch noch das Programm rman, das Handbuchseiten verschiedenster Formate bearbeiten kann, und Ausgabeformate wie HTML, RTF, ASCII und LaTeX erstellt.
zcat /usr/share/man/man1/cp.1.gz | rman -f ascii > cp.txt zcat /usr/share/man/man1/cp.1.gz | rman -f rtf > cp.rtf zcat /usr/share/man/man1/cp.1.gz | rman -f html > cp.html
würde also aus der Handbuchseite von cp eine Textdatei, eine RTF-Datei und eine Webseite produzieren.