man(1) Handbuchseite man(1)
Bezeichnung:
man – Formatieren und Anzeigen von Seiten des Online-Handbuches (man pages)
manpath – Anzeigen des Benutzer-eigenen Suchpfades für Seiten des Online-Handbuches (man pages)
Syntax:
man [-adfhktw] [-m system] [-p string] [-C config_file]
[-M path] [-P pager] [-S section_list] [section] name …
Beschreibung:
man formatiert Seiten aus dem Online-Handbuch und zeigt diese an. Diese Version unterstützt die MANPATH und (MAN)PAGER Umgebungsvariablen, so daß Sie ihre eigenen man pages verwenden können und selbst wählen können, welches Programm die formatierten Seiten anzeigen soll. Wenn der Parameter section angegeben wird, so sucht man nur in dieser Sektion des Handbuchs. Sie können auch mit Hilfe von Kommando-Zeilen-Optionen oder Umgebungsvariablen die Reihenfolge angeben, in der die Sektionen nach Einträgen durchsucht werden und welche zusätzlichen Programme die Quelltexte bearbeiten sollen. Wenn der Parameter name das Zeichen / enthält, dann wird zunächst versucht, diese Datei zu bearbeiten. Damit können Sie z.B. man ./foo.5 oder auch man /cd/foo/bar.1.gz eingeben.
Optionen:
-C config_file
bestimmt welche man.config-Datei als Steuerdatei verwendet wird.
-M path
bestimmt eine Liste von Verzeichnissen, die nach Handbuch-Seiten durchsucht werden. Wenn diese Option nicht angegeben ist, so wird die Umgebungsvariable MANPATH benutzt. Ist diese Variable nicht gesetzt, so wird diese Liste aus der Datei man.config erstellt.
-P pager
bestimmt welches Programm zur Anzeige der Handbuch-Seiten benutzt wird. Als default benutzt man /usr/bin/less -is Diese Option überschreibt die Umgebungsvariable PAGER
-S section_list
section-list ist eine durch Doppelpunkte getrennte Liste von Handbuch-Sektionen, die nach Handbuch-Seiten durchsucht werden soll. Diese Option überschreibt die Umgebungsvariable MANSECT
-a
Als Default wird man beendet, nachdem es die erste Handbuchseite angezeigt hat, die gefunden wurde. Diese Option weist man an, alle Handbuch-Seiten anzuzeigen, die zu name, passen, nicht nur die erste.
-d
zeigt nicht die Handbuch-Seiten an, sondern gibt etliche Informationen zur Fehlersuche aus.
-f
ist äquivalent zu whatis
-h
gibt eine (einzeilige) Hilfe aus und beendet man.
-k
ist äquivalent zu apropos
-m system
bestimmt eine andere Menge von Handbuch-Seiten, die aufgrund des angegebenen System-Namen durchsucht werden sollen.
-p string
bestimmt die Abfolge von Präprozessoren, die vor nroff oder troff gestartet werden sollen. Nicht alle Installationen verfügen über alle Präprozessoren. Einige der Präprozessoren und die dafür verwendeten Buchstaben sind: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Diese Option überschreibt die Umgebungsvariable MANROFFSEQ
-t
benutzt /usr/bin/groff -Tps -mandoc um die Handbuch-Seite zu formatieren und leitet die Ausgabe weiter nach stdout. Die Ausgabe von /usr/bin/groff muß möglicherweise durch einen Filter weiterbearbeitet werden, bevor sie gedruckt werden kann.
-w
die Handbuchseiten werden nicht angezeigt, sondern die Fundorte der Seiten, die formatiert oder angezeigt würden. Wenn kein Argument angegeben wurde, wird die Liste der Verzeichnisse ausgegeben, die von man nach Handbuch-Seiten durchsucht werden. Wenn manpath ein Link zu man ist, dann ist „manpath“ äquivalent zu „man -w“.
Quelle: Linux-Anwenderhandbuch
