man

Der Shell-Befehl man dient als Browser zur Anzeige der Handbücher (manpages).

Das Befehlsverhalten wird wesentlich durch folgende Bash-Variablen bestimmt.

Variable	Beschreibung
LANG	Allgemeine Umgebungsvariable, mit der nicht nur die gewünschte Sprache für Handbücher eingestellt werden kann. Liegen keine Seiten in der eingestellten Sprache vor, so wird auf die englischen Ausgaben zurückgegriffen.
MANOPT	Standardoptionen.
MANPATH	Liste der nach Handbüchern zu durchsuchenden Verzeichnisse.
MANSECT	Liste der zu durchsuchenden Abschnitte.
PAGER	Programm (meist "less"), mit dem die Handbuchseiten dargestellt werden.

Der Suchpfad für man ist in den Dateien "/etc/man.config" oder "/etc/manpath.config" festgelegt.

Verwendung

Anzeige des ersten Handbuchs zum Thema "cp" (anhand der in der Datei "/etc/manpath.config" unter "SECTION" angegebenen Reihenfolge).

$ man cp

Anzeige des in Abschnitt 5 (Dateiformate und Konventionen) abgelegten Handbuchs zum Thema "passwd".

$ man 5 passwd

Anzeige aller Handbücher zum Thema "passwd".

$ man -a passwd

Anzeige aller Kurzbeschreibungen der Handbücher zum Thema "passwd".

$ man -f passwd
$ whatis passwd

Anzeige aller Kurzbeschreibungen der Handbücher, die die Zeichenfolge "passwd" enthalten.

$ man -k passwd

Anzeige der Anzahl Handbücher, die die Zeichenfolge "socket" enthalten.

$ man -k socket 2>/dev/null | wc -l

Auswahl von Hilfedateien mittels Maus (im Hintergrund starten).

$ xman &

Ausdrucken von Handbüchern

Schreiben des Handbuchs zu "ls" im ASCII-Format ohne Steuerzeichen in die Datei "ls.txt".

$ man ls | col -bx > ls.txt

Umwandlung eines Handbuchs in Postscript.

$ man -t bash > bash.ps
oder
$ zcat /usr/share/man/man1/bash.1.gz | groff -man > ~/bash.1.ps

Umwandlung des Handbuchs zu "ls" ins Postscript-Format und Ausdruck auf den Standarddrucker.

man -t ls | lpr

Schreiben des Handbuchs zu "ls" mit zwei Seiten auf einem Blatt in die Datei "ls.ps".

$ man ls | a2ps ls.ps

Schreiben des Handbuchs zu "ls" im .html-Format in die Datei "ls.html".

$ man ls | man2html -title ls > ls.html

Schreiben des Handbuchs zu "ls" in die Datei "ls.dvi". Je nach gewünschtem Ergebnis bzw. zur Verfügung stehendem Ausgabegerät und installiertem groff sind verschiedene Werte möglich.

$ man -Tdvi ls > ls.dvi
$ man -Thtml ls > ls.html
$ man -Tlatin1 ls > ls.latin1
$ man -Tlj4 ls > ls.lj4
$ man -Tps ls > ls.ps

Im Falle der folgenden Fehlermeldung muss die Datei "windex" vom Systemverwalter erstellt werden.

/usr/openwin/share/man/windex: No such file or directory