man(1-ucb) (BSD Compatibility Package) man(1-ucb)
NAME
man - Handbuchseiten anzeigen; Handbuchseiten mit Schlüsselwort suchen
SYNTAX
/usr/ucb/man [-] [-t] [-M path] [-T macro-package] [[section] title ...]
title ...
/usr/ucb/man [-M path] -k keyword ...
/usr/ucb/man [-M path] -f filename ...
BESCHREIBUNG
Das Kommando man zeigt Informationen eines Referenzhandbuchs an. Es
kann vollständige Seiten (Manual Pages) anzeigen, die Sie mit dem
Titel title ausgewählt haben, oder einzeilige Zusammenfassungen, die
Sie entweder mit dem Schlüsselwort keyword (-k) oder mit dem Namen
einer zugeordneten Datei (-f) ausgewählt haben.
Ein Abschnitt section, falls angegeben, bezieht sich auf die Titel
titles, die ihm in der Kommandozeile folgen (bis zum nächsten section,
falls vorhanden). man sucht im angegebenen Abschnitt des Referenzhand-
buchs nach den Titeln title. section ist eine Ziffer (eventuell
gefolgt von einem einzelnen Buchstaben, der den Handbuchseitentyp
angibt). Wenn section übergangen wird, durchsucht man alle Handbuchab-
schnitte (Kommandos haben hierbei Vorrang vor Funktionen) und gibt die
erste Handbuchseite aus, die gefunden wird. Wenn keine Handbuchseite
gefunden wird, gibt man eine Fehlermeldung aus.
Die Quellen der Referenzhandbuchseiten befinden sich normalerweise in
den Verzeichnissen /usr/share/man/man?. Da diese Verzeichnisse optio-
nal installiert sind, sind sie unter Umständen nicht auf Ihrem Host
installiert. Möglicherweise müssen Sie /usr/share/man von einem Host
einhängen, auf dem sie installiert sind. Wenn es vorformatierte aktu-
elle Versionen in den Verzeichnissen /usr/share/man/cat? oder
/usr/share/man/fmt? gibt, zeigt man nur diese Versionen an. Wenn die
jeweilige vorformatierte Version nicht mehr aktuell ist oder fehlt,
formatiert man die Handbuchseiten neu, bevor sie angezeigt werden.
Wenn keine Verzeichnisse für die vorformatierte Version vorhanden
sind, formatiert man eine Seite neu, wenn dies erforderlich ist. Der
formatierte Text wird während der Anzeige in einer temporären Datei
gespeichert.
Erfolgt die Standardausgabe nicht auf einem Terminal oder ist die
Option - gesetzt, stellt man seine Ausgabe mit cat in eine Pipe.
Andernfalls stellt man seine Ausgabe mit more in eine Pipe, um die
bildschirmweise Anzeige des Handbuchtextes sowie Unterstreichungen auf
dem Bildschirm zu bearbeiten.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
man(1-ucb) (BSD Compatibility Package) man(1-ucb)
OPTIONEN
-t man sorgt dafür, daß die angegebenen Handbuchseiten mit troff
als geeignete Rasterausgabe formatiert werden [siehe
troff(1M)]. Wenn die beiden Optionen - und -t gesetzt sind,
aktualisiert man die mit troff bearbeiteten Versionen aller
angegebenen Titel title (falls erforderlich), zeigt sie
jedoch nicht an.
-M path Den Suchpfad für alle Handbuchseiten ändern. Bei dem Pfad
path handelt es sich um eine Liste von mit Doppelpunkten
getrennten Verzeichnissen, die Unterverzeichnisse mit Hand-
buchseiten enthalten. Wenn er mit den Optionen -k oder -f
verwendet wird, muß zuerst die Option -M stehen. Es wird
angenommen, daß jedes Verzeichnis im Pfad path Unterverzeich-
nisse in der Form man[1-8] enthält (siehe auch die Umgebungs-
variable MANPATH unten).
-T macro-package
man verwendet zur Formatierung das Makropaket macro-package
anstelle der standardmäßigen -man-Makros, die in
/usr/lib/tmac/tmac.an definiert sind.
-k keyword ...
man gibt einzeilige Zusammenfassungen der Datenbank whatis
aus (Inhaltsverzeichnis), die ein angegebenes Schlüsselwort
keyword enthalten.
-f filename ...
man versucht die Handbuchseiten zu finden, die zu einem der
angegebenen Dateinamen filenames gehören. Es entfernt die
führenden Komponenten des Pfadnamens von jedem Dateinamen
filename und gibt dann einzeilige Zusammenfassungen aus, die
den bzw. die verbleibenden Basisnamen enthalten.
HANDBUCHSEITEN
Bei Handbuchseiten (Manual Pages) handelt es sich um troff- oder
nroff-Quelldateien, die mit dem -man-Makropaket formatiert werden.
Beim Formatieren einer Handbuchseite prüft man die erste Zeile, um
festzustellen, ob eine spezielle Verarbeitung erforderlich ist.
Handbuchseiten vorbearbeiten
Wenn die erste Zeile eine Zeichenkette in der folgenden Form ist, lei-
tet man seine Eingabe über die entsprechenden Präprozessoren an troff
oder nroff weiter.
'\" X
Dabei wird X durch ein einzelnes Leerzeichen von " getrennt und
besteht aus einer beliebigen Kombination von Zeichen in der folgenden
Liste.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
man(1-ucb) (BSD Compatibility Package) man(1-ucb)
e eqn oder neqn für nroff
r refer
t tbl und col für nroff
Wenn eqn oder neqn aufgerufen werden, wird automatisch die Datei
/usr/ucblib/pub/eqnchar gelesen [siehe eqnchar(5)].
UMGEBUNGSVARIABLEN
MANPATH Wenn diese Umgebungsvariable gesetzt wird, überschreibt
ihr Wert den Standardsuchpfad /usr/share/man. Die
Option -M wiederum überschreibt diesen Wert.
PAGER Ein Programm zur interaktiven Bildschirmausgabe von
man. Wenn diese Umgebungsvariable nicht gesetzt wird,
wird "more -s" [siehe more(1)] verwendet.
TCAT Der Name des Programms, das zum Anzeigen der von troff
bearbeiteten Handbuchseiten verwendet werden soll. Wenn
diese Umgebungsvariable nicht gesetzt wird, wird "lp
-Ttroff" [siehe lp(1)] verwendet.
TROFF Der Name des Formatierprogramms, das verwendet werden
soll, wenn die Option -t angegeben wird. Wenn die
Option nicht gesetzt wird, wird troff verwendet.
HINWEISE
Die Handbuchseiten können auf einem Fotosatzgerät oder auf einem
ASCII-Terminal angezeigt werden. Auf einem Terminal gehen jedoch
einige Informationen (zum Beispiel alle troff-Befehle) verloren.
Einige nicht-intelligente Terminals können vom Präprozessor-Flag e
[eqn(1M)] erzeugte vertikale Bewegungen nicht verarbeiten. Wenn Sie e
verwenden und eine nichtbrauchbare Ausgabe auf diesen Terminals ver-
meiden möchten, verwenden Sie zusätzlich zu e auch t, um col(1) impli-
zit aufzurufen. Diese Vorgehensweise hat jedoch den Nachteil, daß
hochgestellte Zeichen und Subskripts auch auf den Terminals entfernt
werden, die diese Zeichen anzeigen können. CTRL-Q löscht die Anzeige
eines Terminals, das die Ausgabe von eqn(1M) nicht versteht.
WARNUNG
Das Kommando /usr/ucb/man zeigt keine Reliant UNIX Handbuchseiten an.
Es ist für Benutzer gedacht, denen BSD-Handbuchseiten zur Verfügung
stehen.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
man(1-ucb) (BSD Compatibility Package) man(1-ucb)
DATEIEN
/usr/share/man
Hauptverzeichnis des Online-Dokumentationssystems
/usr/share/man/man?/*
Unformatierte Handbuchseiten
/usr/share/man/cat?/*
Mit nroff bearbeitete Handbuchseiten
/usr/share/man/fmt?/*
Mit troff bearbeitete Handbuchseiten
/usr/share/man/whatis
Datenbank mit Inhaltsverzeichnis und Schlüsselwörtern
/usr/ucblib/makewhatis
Kommando-Skript zum Erstellen der Datenbank whatis(1)
/usr/lib/tmac/tmac.an
Standardmäßiges -man-Makropaket
/usr/ucblib/pub/eqnchar
Definitionen von Sonderzeichen für eqn und neqn
SIEHE AUCH
apropos(1), cat(1), col(1), lp(1), more(1), refer(1), whatis(1),
catman(1M-ucb), eqn(1M), neqn(1M), nroff(1M), tbl(1M), troff(1M),
eqnchar(5).
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98