groff-Befehle: GNU-Textsatz in der Praxis

groff (GNU troff) ist die freie, erweiterte Neuimplementierung des klassischen Unix-Formatters troff. Es liest dieselben Textdateien mit Formatierkommandos und erzeugt daraus PostScript, PDF, HTML, DVI oder Terminal-Ausgabe.

Herkunft

James Clark startete das Projekt Ende der 1980er-Jahre; die erste Veröffentlichung (Version 0.3.1) erschien im Juni 1990. groff ersetzt sowohl das klassische troff als auch nroff und enthält die Präprozessoren eqn, tbl und pic als Teile des Pakets.

Kommandozeile

groff -Tpdf -man manpage.1 > manpage.pdf
groff -Tutf8 -mandoc manpage.1   " Terminal-Ausgabe
groff -Tps -ms dokument.ms -P-a4

Wichtige Optionen

  • -T: Ausgabegerät (ps, pdf, html, utf8, ascii, dvi, lj4)
  • -man/-mandoc/-ms/-mm/-me: Makro-Paket wählen
  • -e: eqn (Formeln), -t: tbl (Tabellen), -p: pic (Diagramme), -R: refer (Literatur)
  • -K: Eingabe-Encoding, -d: Papierformat setzen

Das man-Kommando jeder Linux-Distribution nutzt groff im Hintergrund, um die Manpages zu rendern — ohne groff gäbe es keine lesbaren Handbuchseiten im Terminal.

Verwandte Themen: TeX, LaTeX und die moderne Alternative Typst; für einfache Auszeichnung reicht oft Markdown.