summaryrefslogtreecommitdiffstats
path: root/man/de/man.man
blob: 57681d135f87b55d5ff3537ffe383f07b3685853 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
.\" Man page for man (and the former manpath)
.\"
.\" Copyright (c) 1990, 1991, John W. Eaton.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the README file that comes with the man 1.0
.\" distribution.  
.\"
.\" John W. Eaton
.\" jwe@che.utexas.edu
.\" Department of Chemical Engineering
.\" The University of Texas at Austin
.\" Austin, Texas  78712
.\"
.\" Many changes - aeb
.\"
.\" Translated into german by Jochen Hein ( Hein@Student.TU-Clausthal.de )
.\" and Ralf W. Stephan ( ralf@franken.de ).
.\"
.TH man 1 "2. September 1995"
.LO 1
.SH NAME
man \- Formatieren und Anzeigen von Seiten des Online-Handbuches (man pages)
.br
manpath \- Anzeigen des Benutzer-eigenen Suchpfades für Seiten des Online-Handbuches (man pages)
.SH SYNTAX
man [\-acdfhktw] [\-m system] [\-p string] [\-C config_file] [\-M path]
[\-P pager] [\-S section_list] [section] name ...
.SH BESCHREIBUNG
.B man
formatiert Seiten aus dem Online-Handbuch und zeigt diese an.
Diese Version unterstützt die
.B MANPATH
und
.B (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
.I section
angegeben wird, so sucht 
.B 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
.I name
das Zeichen / enthält, dann wird zunächst versucht, diese Datei zu
bearbeiten. Damit können Sie z.B. 
.B "man ./foo.5"
oder auch
.B "man /cd/foo/bar.1.gz"
eingeben.
.SH OPTIONEN
.TP
.B \-\^C " config_file"
bestimmt welche man.conf-Datei als Steuerdatei verwendet wird.
.TP
.B \-\^M " path"
bestimmt eine Liste von Verzeichnissen, die nach Handbuch-Seiten durchsucht 
werden. Wenn diese Option nicht angegeben ist, so wird die Umgebungsvariable
.B MANPATH
benutzt. Ist diese Variable nicht gesetzt, so wird diese Liste aus der
Datei man.conf erstellt.
.TP
.B \-\^P " pager"
bestimmt welches Programm zur Anzeige der Handbuch-Seiten benutzt wird.
Als default benutzt man
.B @pager@
Diese Option überschreibt die Umgebungsvariable
.B PAGER
.TP
.B \-\^S " section_list"
ist eine durch Doppelpunkte getrennte Liste von Handbuch-Sektionen, die
nach Handbuch-Seiten durchsucht werden soll.
Diese Option überschreibt die Umgebungsvariable
.B MANSECT
.TP
.B \-\^a
Als Default wird
.B man
beendet, nachdem es die erste Handbuchseite angezeigt
hat, die gefunden wurde. Diese Option weist 
.B man 
an, alle Handbuch-Seiten anzuzeigen, die zu
.B name, 
passen, nicht nur die erste.
.TP
.B \-\^d
zeigt nicht die Handbuch-Seiten an, sondern gibt etliche Informationen
zur Fehlersuche aus.
.TP
.B \-\^f
ist äquivalent zu
.BR whatis .
.TP
.B \-\^h
gibt eine (einzeilige) Hilfe aus und beendet
.BR man .
.TP
.B \-\^k
ist äquivalent zu
.BR apropos .
.TP
.B \-\^K
Suche in *allen* Manualseiten nach dem angegebenen Schlüsselwort. Achtung:
Die Suche dauert möglicherweise sehr lange! Die Angabe der Sektion
beschleunigt die Suche. (Als groben Richtwert für die Suche kann man
ca. eine Minute für 500 Manualseiten ansetzen.)
.TP
.B \-\^m " system"
bestimmt eine andere Menge von Handbuch-Seiten, die aufgrund des 
angegebenen System-Namen durchsucht werden sollen.
.TP
.B \-\^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
.B MANROFFSEQ
.TP
.B \-\^t
benutzt
.B @troff@
um die Handbuch-Seite zu formatieren und leitet die Ausgabe weiter nach
.B stdout.
Die Ausgabe von
.B @troff@
muß möglicherweise durch einen Filter weiterbearbeitet werden, bevor
sie gedruckt werden kann.
.TP
.B \-\^w \fRor\fP \-\-path
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 
.B man
nach Handbuch-Seiten durchsucht werden. Wenn
.B manpath
ein Link zu man ist, dann ist "manpath" äquivalent zu "man --path".

.SH ENVIRONMENT
.TP
.B MANPATH
Wenn die Umgebungsvariable
.B MANPATH
gesetzt ist, dann wird dieser Wert als Suchpfad für Handbuch-Seiten
verwendet.
.TP
.B MANROFFSEQ
Wenn die Umgebungsvariable
.B MANROFFSEQ
gesetzt ist, dann wird dieser Wert benutzt um die Präprozessoren zu bestimmen,
die aufgerufen werden sollen, bevor die Handbuch-Seite mit nroff oder troff
bearbeitet wird. Standardmäßig werden Handbuch-Seiten durch den Tabellen
Präprozessor bearbeitet bevor nroff gestartet wird.
.TP
.B MANSECT
Wenn die Umgebungsvariable
.B MANSECT
gesetzt ist, dann bestimmt dieser Wert welche Handbuch-Sektionen durchsucht
werden sollen.
.TP
.B MANWIDTH
Wenn die Umgebungsvariable
.B MANWIDTH
gesetzt ist, dann beschreibt deren Wert die Breite auf der die
Handbuch-Seite angezeigt werden soll. Ansonsten wird die Seite u.U.
über die gesamte Breite des Bildschirmes gezogen.
.TP
.B PAGER
Wenn die Umgebungsvariable
.B PAGER
gesetzt ist, so wird dieser Wert als Name des Programms benutzt, mit dem
die Handbuch-Seiten angezeigt werden sollen. Standardmäßig wird
.B @pager@
verwendet.
.TP
.B LANG
Wenn die Umgebungsvariable
.B LANG
gesetzt ist, gibt ihr Inhalt den Namen des Unterverzeichnisses 
an, wo zuerst nach der Handbuch-Seite gesucht werden soll.  
So zB bewirkt der Shell-Befehl `LANG=dk man 1 foo', daß 
.B man
zuerst in ...dk/man1/foo.1 nach der Handbuchseite für 'foo' sucht, und
wenn es dort nicht fündig wird, dann in ...man1/foo.1, wobei '...'
ein Verzeichnis aus dem Suchpfad bedeutet.
.TP
.B "NLSPATH, LC_MESSAGES, LANG"
Die Umgebungsvariablen
.B NLSPATH
und
.B LC_MESSAGES
(oder
.B LANG
falls erstere nicht existiert) spielen bei der Suche nach dem Message
Katalog eine Rolle (englische Messages sind fest einkompiliert, daher
ist auch kein Katalog für sie notwendig).  Beachten Sie, daß auch
Programme wie
.B col(1),
das von
.B man
aufgerufen wird, noch zusätzliche Variablen wie LC_CTYPE benutzen.
.TP
.B PATH
.B PATH
wird bei der Konstruktion des vorgegebenen Suchpfades für Handbuchseiten
verwendet.
.TP
.B SYSTEM
.B SYSTEM
wird verwendet, um einen alternativen Systemnamen herauszufinden
(sinnvoll zusammen mit der
.B \-m 
Option).
.SH "SIEHE AUCH"
apropos(1), whatis(1), less(1), groff(1).
.SH BUGS
Die
.B \-t
Option kann nur auf System verwendet werden, auf denen ein troff-Programm
installiert ist.