.\"
.\"	Copyright 1993 Sebastian Hetze und der/die in der Sektion
.\"	AUTOR genannten Autor/Autoren
.\"
.\"	Dieser Text steht unter der GNU General Public License.
.\"	Er darf kopiert und verndert, korrigiert und verbessert werden.
.\"	Die Copyright und Lizenzbestimmung mssen allerdings erhalten
.\"	bleiben. Die Hinweise auf das LunetIX Linuxhandbuch, aus dem
.\"	dieser Text stammt, drfen nicht entfernt werden.
.\"
.TH GROFF 1 "1. Juli 1993" "LunetIX Linuxhandbuch" "Dienstprogramme fr Benutzer"
.SH BEZEICHNUNG 
groff \- formatiert Texte (z.B. Manualpages)
.SH SYNTAX 
.B groff
.RB [ \-tpeszaivhblCENRVZ ]
.RB [ \-w
.IR Name ]
.RB [ \-W
.IR Name ]
.RB [ \-H
.IR Datei ]
.RB [ \-m
.IR Makro ]
.RB [ \-F
.IR Verzeichnis ]
.RB [ \-T
.IR Format ]
.RB [ \-f
.IR Familie ]
.RB [ \-M
.IR Verzeichnis ]
.RB [ \-d
.IR cs ]
.RB [ \-r
.IR cn ]
.RB [ \-n
.IR Nummer ]
.RB [ \-o
.IR Liste ]
.RB [ \-P
.IR Argument ]
.RI [ Datei ...]
.SH BESCHREIBUNG
.B groff
ist der Kern eines Textformatiersystems.  Normalerweise startet
.B groff " das " gtroff
Kommando und leitet die Ausgabe durch einen Postprozessor fr ein
bestimmtes Ausgabegert.  Folgende Ausgabeformate stehen zur Verfgung:
.TP
.B ps
Postscript
.TP
.B dvi
(DeVice Independent) das TeX Ausgabeformat
.TP
.B X75
fr X-Windows Ausgabe mit 75dpi
.TP
.B X100
fr X-Windows Ausgabe mit 100dpi
.TP
.B ascii
fr einfache Druckerausgabe
.TP
.B latin1
fr Druckerausgabe mit ISO Latin-1 Zeichensatz
.PP
Das Standardformat ist ascii. 
.PP
Im
.B groff
System stehen auerdem die Prprozessoren
.BR gpic ", " geqn ", " gtbl ", " grefer " und " gsoelim
zur Verfgung.
.SH OPTIONEN
.TP
.B -h
gibt einen Hilfstext aus
.TP
.B -e
leitet die Eingabe durch den
.B geqn
Prprozessor
.TP
.B -t
leitet die Eingabe durch den
.B gtbl
Prprozessor
.TP
.B -p
leitet die Eingabe durch den
.B gpic
Prprozessor
.TP
.B -s
leitet die Eingabe durch den
.B gsoelim
Prprozessor
.TP
.B -R
leitet die Eingabe durch den
.B grefer
Prprozessor; die bergabe von Kommandozeilenargumenten an
.B grefer
wird nicht untersttzt
.TP
.B -v
die von
.B groff
aufgerufenen Programme geben ihre Versionsnummer aus
.TP
.B -V
gibt die von groff zusammengestellte Kommandozeile (Pipeline) auf der
Standardausgabe aus, anstatt sie auszufhren
.TP
.B -z
unterdrckt die Ausgabe von gtroff; nur Fehlermeldungen werden ausgegeben
.TP
.B -Z
unterdrckt den Postprozessor
.TP
.BI -P " Argument"
gibt das
.I Argument
an den Postprozessor weiter; jedes Argument sollte einzeln bergeben
werden; den Argumenten wird kein
.BR - " vorangestellt"
.TP
.BI -L " Argument"
gibt das
.I Argument
an den Spooler weiter
.TP
.BI -T " Format"
benutzt
.RI Ausgabe Format ;
Voreinstellung ist ascii
.TP
.B -N
bergibt die -N Option an geqn
.TP
.B -a
produziert reinen ascii Code, ohne Steuerzeichen
.TP
.B -b
gibt zustzliche Information bei Fehlermeldungen
.TP
.B -i
liest aus der Standardeingabe, nachdem alle Eingabedateien bearbeitet sind
.TP
.B -C
schaltet in den Kompatibilittsmodus (zu troff)
.TP
.B -E
unterdrckt alle Fehlermeldungen
.TP
.BI -w " Name"
erlaubt Warnung
.I Name
.TP
.BI -W " Name"
unterdrckt Warnung
.I Name
.TP
.BI -m " Makro"
die Datei
.BI tmac. Makro
wird gelesen und die darin definierten Makros zum Formatieren des
Dokuments benutzt
.TP
.BI -o " Liste"
gibt nur die Seiten aus
.I Liste
aus; die
.I Liste
ist eine durch Kommata getrennte Liste von Seitenbereichen
.TP
.BI -d " cs"
definiert das Register
.I c " mit " s ;
dabei ist
.I c
ein Buchstabe und
.I s
eine Zeichenkette
.TP
.BI -r " cn"
setzt Register
.IR c " auf " n .
Dabei ist
.I c
ein Buchstabe und
.I n
ein numerischer Ausdruck.
.TP
.BI -F " Verzeichnis"
sucht im
.I Verzeichnis
nach den Fonts
.TP
.BI -M " Verzeichnis"
sucht im
.I Verzeichnis
nach den Makros
.TP
.BI -H " Datei"
benutzt
.I Datei
nach der Trennmusterdatei
.TP
.BI -f " Familie"
benutzt
.I Familie
als Fontfamilie
.TP
.BI -n " Nummer"
setzt die Nummer der ersten Ausgabeseite auf
.I Nummer
.SS Umgebung:
Folgende Umgebungsvariablen werden untersttzt:
.TP
.B GROFF_TMAC_PATH
eine durch Doppelpunkte getrennte Liste von Verzeichnissen, in
denen nach Makrodateien gesucht wird
.TP
.B GROFF_TYPESETTER
das Standardausgabeformat
.TP
.B GROFF_FONT_PATH
eine durch Doppelpunkte getrennte Liste von Verzeichnissen, in
denen nach den Gertetreibern und den Zeichenstzen fr das
Ausgabeformat gesucht wird
.TP
.B GROFF_HYPHEN
eine Datei mit Mustern fr die automatische Trennung durch groff
.TP
.B GROFF_TMPDIR
ein Verzeichnis, in dem die temporren Dateien von groff angelegt
werden; wenn kein Verzeichnis angegeben ist, wird das Verzeichnis
/tmp benutzt
.SS Dateien:
Die folgenden Dateien werden vom
.B groff
System benutzt:
.TP
.B /usr/lib/groff/hyphen
die Standardtrennmusterdatei
.TP
.BI /usr/lib/groff/tmac/tmac. Name
die Makrodatei fr
.BI -m Name
.TP
.BI /usr/lib/groff/font/dev Name DESC
der Gertetreiber fr das Gert
.I Name
.TP
.BI /usr/lib/groff/font/dev Name F
die Fontdatei fr Font
.B F
von Gert
.I Name
.TP
.BI /usr/lib/groff/font/dev Name /eqnchar
die Definitionen von (g)eqn fr das Gert
.I Name
.SH SIEHE AUCH
.BR grog (1),
.BR gtroff (1),
.BR gtbl (1),
.BR gpic (1),
.BR geqn (1),
.BR gsoelim (1),
.BR grefer (1),
.BR grops (1),
.BR grodvi (1),
.BR grotty (1),
.BR groff_font (5),
.BR groff_out (5),
.BR groff_msr (7),
.BR groff_me (7)
und das LunetIX Linuxhandbuch
.SH AUTOR
James Clark