| blob | f6e68dd3b95d416f11718b2092547221d5586aff |
1 '\" t
2 .\" Man page generated from reStructuredText.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "MAN" 1 "2008-01-28" "2.5.1" "Manual Hilfsprogramme"
32 .SH NAME
33 man \- Programm zum Einsehen der Online-Manuale
34 .SH SYNTAX
35 .INDENT 0.0
36 .INDENT 3.5
37 man [\-acdhwutZV] [\-m System[,...]] [\-L locale] [\-p Zeichenkette] [\-M Pfad] [\-P Pager] [\-r Prompt] [\-T Format] [\-S Liste] [\-e Erweiterung] [[Abschnitt] Seite ...] ...
38 .sp
39 man \-l [\-tZ] [\-p Zeichenkette] [\-P Pager] [\-r Prompt] [\-T Format] Datei ...
40 .sp
41 man \-k Schluesselwort ...
42 .sp
43 man \-f Seite ...
44 .UNINDENT
45 .UNINDENT
46 .\" Problems:
47 .\"
48 .\" * how to format long syntax lines
49 .\" * how to typeset the command bold, italic, ..
50 .
51 .SH BESCHREIBUNG
52 .sp
53 man ist der Manualbrowser des Systems. Jedes Argument Seite ist normalerweise
54 der Name eines Programmes oder einer Funktion. Gefunden und
55 angezeigt wird die Manualseite, die auf alle Argumente passt. Wenn ein
56 Abschnitt angegeben wird, sucht man nur in diesem Abschnitt der Manualseiten.
57 Ohne Angabe eine explizite Angabe werden alle verfuegbaren
58 Abschnitte in einer vorher definierten Reihenfolge durchsucht. Wenn
59 die Seite in mehreren Abschnitten vorkommt, wird nur die jeweils erste
60 Seite angezeigt, die gefunden wird.
61 .sp
62 Die folgende Tabelle zeigt die Nummern der Abschnitte der Manualseiten
63 gefolgt vom Typ der dort zu findenden Seiten.
64 .INDENT 0.0
65 .INDENT 3.5
66 .TS
67 box center;
68 l|l.
69 T{
70 1
71 T} T{
72 Ausfuehrbare Programme oder Shellbefehle
73 T}
74 _
75 T{
76 2
77 T} T{
78 Systemaufrufe (Kernelfunktionen)
79 T}
80 _
81 T{
82 3
83 T} T{
84 Bibliotheksaufrufe (Funktionen in System\-Bibliotheken)
85 T}
86 _
87 T{
88 4
89 T} T{
90 Spezielle Dateien (gewoehnlich in /dev)
91 T}
92 _
93 T{
94 5
95 T} T{
96 Dateiformate und Konventionen, z. B. /etc/passwd
97 T}
98 _
99 T{
100 6
101 T} T{
102 Spiele
103 T}
104 _
105 T{
106 7
107 T} T{
108 Makropakete und Konventionen, z. B. man(7), groff(7)
109 T}
110 _
111 T{
112 8
113 T} T{
114 Systemadministrationsbefehle (in der Regel nur fuer root)
115 T}
116 _
117 T{
118 9
119 T} T{
120 Kernelroutinen [Nicht Standard]
121 T}
122 _
123 T{
124 n
125 T} T{
126 neu [veraltet]
127 T}
128 _
129 T{
130 l
131 T} T{
132 lokal [veraltet]
133 T}
134 _
135 T{
136 p
137 T} T{
138 oeffentlich [veraltet]
139 T}
140 _
141 T{
142 o
143 T} T{
144 alt [veraltet]
145 T}
146 .TE
147 .UNINDENT
148 .UNINDENT
149 .\" BUG: do not set as table
150 .
151 .sp
152 Eine Manualseite besteht aus mehreren Teilen. Die ueblichen Bezeichnungen
153 sind u. a. NAME, SYNTAX, BESCHREIBUNG, OPTIONEN, DATEIEN,
154 SIEHE AUCH, FEHLER, und AUTOR.
155 .sp
156 Die folgenden Konventionen gelten fuer den Abschnitt SYNTAX und koennen
157 fuer andere Abschnitte als Anleitung benutzt werden.
158 .INDENT 0.0
159 .INDENT 3.5
160 .INDENT 0.0
161 .TP
162 .B bold text
163 Literale Angaben wie in der Anzeige.
164 .TP
165 .B italic text
166 Ersetzen durch passendes Argument.
167 .TP
168 .B [\-abc]
169 Ein oder mehrere Argumente innerhalb der \fB[ ]\fP sind optional.
170 .TP
171 .B \-a|\-b
172 Optionen, die durch \fB|\fP abgegrenzt sind, koennen nicht zusammen
173 benutzt werden.
174 .TP
175 .B Argument ...
176 Argument kann wiederholt werden.
177 .TP
178 .B [Ausdruck] ...
179 gesamter Ausdruck innerhalb \fB[ ]\fP kann wiederholt werden.
180 .UNINDENT
181 .UNINDENT
182 .UNINDENT
183 .sp
184 Die Befehls\- oder Funktionsbeispiele sind Muster, die auf alle
185 moeglichen Aufrufe passen sollten. In manchen Faellen ist es ratsam,
186 die verschiedenen sich ausschliessenden Aufrufe zu illustrieren, wie es
187 im SYNTAX Abschnitt dieser Manualseite gezeigt ist.
188 .SH BEISPIELE
189 .INDENT 0.0
190 .TP
191 .B \fBman ls\fP
192 zeigt die Manualseite fuer das Programm ls an.
193 .TP
194 .B \fBman \-a intro\fP
195 zeigt alle vorhandenen intro Manualseiten an. Mit (q)uit ist es
196 moeglich, das aufeinanderfolgendende Anzeigen der Seiten
197 abzubrechen oder mit (s)kip eine Seite zu ueberspringen.
198 .TP
199 .B \fBman \-t alias | lpr \-Pps\fP
200 Formatiert die Manualseite, die sich auf alias bezieht, in das
201 Default troff oder groff Format und schickt es an den Drucker ps.
202 Die Defaultausgabe fuer groff ist Postscript. Das Default fuer
203 troff \- ditroff, benoetigt weitere Bearbeitung durch grops, bevor
204 es von einem Postscriptdrucker gedruckt werden kann. man \-\-help
205 sollte zu bestimmen helfen, welcher Prozessor an die \-t Option
206 gebunden ist.
207 .TP
208 .B \fBman \-l \-Tdvi ./foo.1x.gz > ./foo.1x.dvi\fP
209 Dieser Befehl formatiert die komprimierte nroff\-Manualseite
210 \&./foo.1x.gz in eine device independent (dvi) Datei. Diese Datei
211 wird zuerst dekomprimiert, bevor sie durch passende Filter und Pro\-
212 gramme bearbeitet wird. Die Umlenkung ist notwendig, da die \-T
213 Option die Ausgabe unformatiert an die Standardausgabe schickt. Die
214 Ausgabe kann mit einem Programm wie xdvi betrachtet oder mit einem
215 Programm wie dvips in Postscript weiterverarbeitet werden.
216 .TP
217 .B \fBman \-k printf\fP
218 Sucht die Kurzbeschreibungen und die Namen der Manualseiten zum
219 Schluesselwort printf und gibt alle Treffer aus.
220 .TP
221 .B \fBman \-f smail\fP
222 Sucht die Manualseiten, die sich auf smail beziehen und gibt alle
223 gefundenen Kurzbeschreibungen aus.
224 .UNINDENT
225 .SH UEBERSICHT
226 .sp
227 Um dem Benutzer eine groesstmoegliche Flexibilität zu bieten, sind in man viele
228 Optionen verfuegbar. Veraenderungen koennen am Suchpfad, in der Reihenfolge der
229 Abschnitte oder am Ausgabeprozessor vorgenommen werden. Andere
230 Verhaltensweisen und Operationen sind weiter unten beschrieben.
231 .sp
232 Um die Arbeitsweise von man zu bestimmen, werden verschiedene
233 Umgebungsvariablen benutzt. Mit dieser Version ist es moeglich, die Variable
234 \fB$MANOPT\fP auf einen Ausdruck im Kommandozeilenformat zu setzen. Es gibt
235 folgende Ausnahme: Da jede Option in \fB$MANOPT\fP von Leerzeichen
236 eingeschlossen ist, muessen Leerzeichen, die Teil eines Argumentes sind,
237 gequotet werden. man bearbeitet diese Variable vor der eigenen Kommandozeile.
238 Die Optionen, die ein Argument benoetigen, koennen durch die gleichen Optionen
239 in der Kommandozeile ueberschrieben werden. Um alle Optionen zurueckzusetzen,
240 die in \fB$MANOPT\fP gesetzt werden, kann \fB\-D\fP als initiale
241 Kommandozeilen\-Option angegeben werden. Dies erlaubt man alle Optionen zu
242 \fIueberschreiben\fP, die in \fB$MANOPT\fP gesetzt werden, obwohl diese
243 weiterhin gelten. Damit wird die groesstmoegliche Flexibilität fuer einen
244 Benutzer erzeugt, der man auf seine eigenen Beduerfnisse anpassen will,
245 ohne zahllose Optionen bei der Suche einer Manualseite einzugeben.
246 .sp
247 Die Hilfsprogramme, die im man\-db\-Paket zusammengefasst sind, machen
248 umfassenden Gebrauch von Indexdatenbanken. Diese Zwischenspeicher
249 enthalten Informationen ueber den Ort und die zugehoerige whatis Information
250 (einzeilige Kurzbeschreibung der Manualseite), sowie darüber, wo sich eine
251 Manualseite im Dateisystem befindet. Eine Aufgabe von man ist die
252 Konsistenzsicherung der Datenbank. Die Datenbanken verhindern die Notwendigkeit
253 einer manuellen Bearbeitung zur Aktualisierung der whatis\-Textdatenbank und
254 erlauben man schneller zu arbeiten, als bei der Suche nach der passenden
255 Manualseite im gesamten Dateisystem.
256 .sp
257 Wenn man keine von mandb erstellte Indexdatenbank zu einer speziellen
258 Manualhierarchie finden kann, wird dennoch nach der gewuenschten Manualseite
259 gesucht. In diesem Fall ist es jedoch wieder noetig, nach der alten Methode
260 alle in Frage kommenden Verzeichnisse zu durchsuchen (sog. globbing). Wenn
261 whatis oder apropos keine Indexdatenbank finden koennen, versucht es die
262 Information aus der whatis\-Datenbank zu beziehen. Auch anwenderspezifische
263 Manualhierarchien werden waehrend der Benutzung in Indexdatenbanken
264 zusammengefasst.
265 .sp
266 Die Hilfsprogramme unterstuetzen komprimierte nroff\-Quelldateien, die
267 normalerweise die Erweiterung .Z, .z oder .gz besitzen. Jede andere
268 Erweiterung kann unterstuetzt werden, wenn sie zur UEbersetzungszeit
269 bekannt ist. Als Default werden alle cat\-Seiten mit gzip komprimiert.
270 Jede globale Manualhierarchie wie /usr/man oder /usr/X11R6/man kann
271 jedes Verzeichnis als cat\-Seiten\-Hierarchie besitzen. UEblicherweise
272 werden cat\-Seiten unter der gleichen Hierarchie wie die Manualseiten
273 gespeichert. Allerdings kann es aus Gruenden, die im Linux File System
274 Standard (FSSTND) erlaeutert sind, besser sein, sie an anderer Stelle
275 zu speichern. Details, wann dies der Fall ist, beschreibt manpath(5).
276 Fuer Details, warum dies empfohlen wird, siehe den Linux File System
277 Standard (FSSTND).
278 .sp
279 Dieses Paket unterstuetzt internationale Anpassungen (sog. NLS\-Support,
280 Native Language Support). Durch den Gebrauch von locale Funktionen ist
281 es moeglich, Manualseiten der Landessprache zu verwalten, wenn sie auf
282 dem System vorhanden sind. Um diese Unterstuetzung zu aktivieren, muss
283 man entweder in $LC_MESSAGES, $LANG oder anderen systemabhaengigen
284 Umgebungsvariablen die gewuenschte Sprache einstellen. Die Sprache wird
285 normalerweise in dem durch POSIX 1003.1 definierten Format angegeben:
286 .INDENT 0.0
287 .INDENT 3.5
288 .sp
289 .EX
290 <Sprache>[_<Region>[.<Zeichensatz>[,<Version>]]]
291 .EE
292 .UNINDENT
293 .UNINDENT
294 .sp
295 Wenn die angeforderte Seite in der locale vorhanden ist, wird sie
296 anstelle der Standardseite (normalerweise in amerikanischem Englisch)
297 angezeigt. Darueber hinaus werden auch Sammlungen von landessprach\-
298 lichen Systemmeldungen unterstuetzt und auf dieselbe Weise aktiviert \-
299 ebenfalls unter der Vorraussetzung, dass die uebersetzten Meldungen
300 vorliegen. Wer diese Manualseiten und die Ausgaben der Hilfsprogramme
301 gerne in seiner Landessprache haette, aber diese nicht vorfindet, ist
302 aufgefordert, eine UEbersetzung anzufertigen und sie dem Autor
303 zuzusenden, damit spaetere Versionen davon profitieren koennen.
304 .sp
305 Die anderen Eigenschaften und Erweiterungen von man sind in den
306 beiliegenden Dokumenten beschrieben. Einen umfassenden Einblick in die
307 mandb zugrundeliegenden Konzepte sind in der Dokumentation man\-db\-2.3 \-
308 the database cached manual pager suite beschrieben. Die Dokumentation
309 sollte auf denselben Server wie das mandb\- Paket selbst zu finden sein.
310 .SH NORMALEINSTELLUNGEN
311 .sp
312 man sucht nach der gewueschten Manualseite in der Indexdatenbank. Wenn
313 die Suche fehlschlaegt, wird ein Konsistenztest durchgefuehrt, um die
314 korrekte Wiedergabe des Dateisystems zu sichern. Nachdem die Daten\-
315 banken erzeugt wurden, ist es i. A. nicht notwendig, mandb zu starten,
316 es sei denn, die Datenbank wurde verfaelscht.
317 .sp
318 Wenn eine Manualseite gefunden wurde, wird getestet, ob dazu bereits
319 eine vorformatierte cat\-Seite existiert und diese neuer als die nroff\-
320 Datei ist. In diesem Fall wird die vorformatierte Datei dekomprimiert
321 und mit einem Browser angezeigt. Die Auswahl des Browsers kann auf
322 unterschiedliche Weise erfolgen (fuer Details siehe \-P Option). Wenn
323 keine cat\-Seite gefunden wird oder wenn sie aelter als die nroff\-Datei
324 ist, wird die nroff\-Datei durch diverse Programme gefiltert und
325 entweder sofort angezeigt oder zuerst als komprimierte cat\-Datei gespe\-
326 ichert und dann angezeigt.
327 .sp
328 Eine cat\-Datei wird erzeugt, wenn ein relatives cat\-Verzeichnis
329 existiert und man dort das Schreibrecht hat.
330 .sp
331 Die Filter werden in mehreren Schritten zusammengestellt: Zuerst wird
332 die Kommandozeilen\-Option \-p oder die Umgebungsvariable $MANROFFSEQ
333 untersucht. Wenn \-p nicht benutzt wird und die Umgebungsvariable nicht
334 gesetzt ist, wird die Anfangszeile der nroff\-Datei nach einer Zeichen\-
335 kette fuer den Praeprozessor untersucht. Eine solche Praeprozessor\-
336 Zeichenkette muss folgendes Aussehen haben:
337 .INDENT 0.0
338 .INDENT 3.5
339 .sp
340 .EX
341 \(aq\e\(dq <Zeichenkette>
342 .EE
343 .UNINDENT
344 .UNINDENT
345 .sp
346 wobei Zeichenkette jede Kombination von Buchstaben sein kann, die unter
347 Option \-p weiter unten beschrieben sind.
348 .sp
349 Wenn keine der obigen Methoden eine Filter\-Information enthaelt, wird
350 tbl als Default verwendet.
351 .sp
352 Als primaerer Formatierer wird entweder nroff, troff oder groff ges\-
353 tartet.
354 .SH OPTIONEN
355 .sp
356 Eine Argumentoption, die entweder in der Kommandozeile, in \fB$MANOPT\fP oder in
357 beiden doppelt vorkommt , ist nicht schaedlich. Fuer Optionen, die ein
358 Argument benötigen, überschreibt jedes Duplikat den vorhergehenden Wert.
359 .INDENT 0.0
360 .TP
361 .B \-l\fP,\fB \-\-local\-file
362 Aktiviert den lokalen Modus. Formatiert und zeigt lokale Manualdateien
363 an, anstatt die System\-Manualsammlung zu durchsuchen.
364 Jedes Manualseiten\-Argument wird als nroff\-Quelle im richtigen
365 Format interpretiert. Komprimierte nroff\-Quelldateien mit einer
366 unterstuetzten Kompressions\-Erweiterung werden von man dekom\-
367 primiert, bevor sie ueber den ueblichen Filter angezeigt werden.
368 Es wird keine cat\-Datei erzeugt. Wenn eines der Argumente \fB\-\fP
369 ist, wird die Eingabe von der Standardeingabe uebernommen.
370 .TP
371 .BI \-L \ locale\fR,\fB \ \-\-locale\fB= locale
372 Normalerweise bestimmt man die aktuelle locale durch einen
373 Aufruf der C Funktion setlocale (3), die diverse Umgebungsvari\-
374 ablen, darunter u. U. $LC_MESSAGES und $LANG untersucht. Diese
375 Funktion kann dazu verwendet werden, kurzzeitig den so gefunde\-
376 nen Wert zu ueberschreiben. Dazu kann diese Option mit einer
377 Zeichenkette, die die temporaere locale enthaelt, angegeben wer\-
378 den. Man beachte, dass dieser Effekt erst beim konkreten Suchen
379 der Seite in Erscheinung tritt. Daher werden Ausgaben wie die
380 Hilfeseite immer in der urspruenglichen Sprache ausgegeben.
381 .TP
382 .B \-D\fP,\fB \-\-default
383 Diese Option wird normalerweise nur als allererste angegeben und
384 setzt das Verhalten von man in allen Belangen wieder zum Nor\-
385 malverhalten zurueck. Der Zweck dieser Option ist es, Optionen
386 wieder rueckgaengig zu machen, die bereits in der Umgebungsvari\-
387 able $MANOPT gesetzt sind. Alle Optionen, die \-D folgen, haben
388 wieder ihren gewohnten Effekt.
389 .TP
390 .BI \-M \ Pfad\fR,\fB \ \-\-manpath\fB= Pfad
391 Ermoeglicht es, einen alternativen Manualpfad anzugeben.
392 Normalerweise verwendet man dieselben Methoden wie in manpath, um
393 den Suchpfad zu ermitteln. Diese Option ueberschreibt die
394 Umgebungsvariable \fB$MANPATH\fP\&.
395 .TP
396 .BI \-P \ Pager\fR,\fB \ \-\-pager\fB= Pager
397 Gibt an, welcher Pager verwendet wird. Die Normaleinstellung ist
398 pager\-s. Diese Option ueberschreibt die Umgebungsvariable
399 \fB$PAGER\fP und wird nicht in Zusammenhang mit \-f oder \-k verwendet.
400 .TP
401 .BI \-r \ Prompt\fR,\fB \ \-\-prompt\fB= Prompt
402 Wenn eine hinreichend neue Version von less als Pager verwendet
403 wird, versucht man dort einige sinnvolle Optionen zu setzen. Die
404 Eingabeaufforderung in der letzten Zeile sieht in dem Fall so
405 aus:
406 .INDENT 7.0
407 .INDENT 3.5
408 Manual page name(sec) line x,
409 .UNINDENT
410 .UNINDENT
411 .sp
412 wobei name die Manualseite bezeichnet, die gerade angezeigt
413 wird, sec der Abschnitt ist, in dem sie gefunden wurde, und x
414 die aktuelle Zeilennummer ist. Diese Anzeige wird durch
415 Verwendung der Umgebungsvariable \fB$LESS\fP erreicht.
416 Man beachte, dass einzelne Bezeichnungen sich bei der Verwendung
417 von landessprachlichen Meldungen ändern koennen. Die Option
418 \fB\-r\fP ermöglicht es, durch Angabe einer
419 Formatierungszeichenkette, das Ausgabeformat selbst zu bestimmen.
420 Wenn diese Zeichenkette \fB$MAN_PN\fP enthält, wird dieser Text
421 durch den Namen der Manualseite gefolgt von der Abschnittsnummer
422 in runden Klammern ersetzt. Die Zeichenkette, die im Normalfall
423 verwendet wird ist:
424 .INDENT 7.0
425 .INDENT 3.5
426 .sp
427 .EX
428 \e Manual\e page\e \e$MAN_PN\e ?ltline\e %lt?L/%L.:
429 byte\e %bB?s/%s..?\e (END):?pB %pB\e\e%..
430 .EE
431 .UNINDENT
432 .UNINDENT
433 .sp
434 Die zweizeilige Darstellung wurde nur der besseren Lesbarkeit
435 wegen gewählt. Nähere Informationen liefert less(1). Da die
436 Zeichenkette zuerst vom Kommandointerpreter ausgewertet wird,
437 muessen entsprechende Zeichen durch einen Backslash geschützt
438 werden. Weitere Optionen für less koennen nach einem
439 geschützten \fB$\fP am Ende der Zeichenkette hinzugefügt werden.
440 Der Default ist hier \fB\-ix8\fP\&.
441 .TP
442 .BI \-S \ Liste\fR,\fB \ \-\-sections\fB= Liste
443 Eine durch Doppelpunkte getrennte Liste von Abschnitten
444 definiert bei Benutzung dieser Option die Reihenfolge, in der
445 die Abschnitte durchsucht werden. Diese Option ueberschreibt die
446 Umgebungsvariable $MANSECT.
447 .TP
448 .B \-a\fP,\fB \-\-all
449 Wird eine Manualseite in einem Abschnitt gefunden, so terminiert
450 man nach Anzeige dieser Seite. Wird jedoch diese Option
451 angegeben, so werden alle passenden Manualseiten nacheinander
452 angezeigt.
453 .TP
454 .B \-c\fP,\fB \-\-catman
455 Diese Option ueberprueft nur, ob die zur angegebenen Manualseite
456 passende cat\-Seite aktuell ist und erzeugt ggf. eine neue. Es
457 wird dabei nichts angezeigt.
458 .TP
459 .B \-d\fP,\fB \-\-debug
460 Bei dieser Option werden keine Manualseiten angezeigt, sondern
461 nur eine Menge von Diagnoseinformation.
462 .TP
463 .BI \-e \ Erweiterung\fR,\fB \ \-\-extension\fB= Erweiterung
464 Einige Systeme enthalten grosse Pakete an Manualseiten, wie
465 z.B. in dem Tcl Paket, die in die normalen Manualabschnitte
466 integriert werden. Um beispielsweise das Problem zweier
467 unterschiedlicher Manualseiten mit gleichem Namen, wie exit(3),
468 zu lösen, wurden früher alle Tcl Seiten dem Abschnitt l
469 zugeordnet. Dieses erwies sich als keine gute Lösung. Bei
470 dieser Version von man ist es möglich, die Seiten in die richtigen
471 Abschnitte einzuordnen und ihrem Seitennamen eine spezifische
472 Erweiterung, hier z. B. exit(3tcl) anzuhängen. Unter normalen
473 Umständen zeigt man bevorzugt exit(3) gegenüber exit(3tcl) an.
474 Um dieses Verhalten umzukehren, ist man die Zeichenkette
475 Erweiterung zu übergeben, die angibt, in welchem Paket die
476 Manualseite zu finden ist. Im obigen Fall beschränkt man seine
477 Suche auf Seiten mit der Erweiterung \fB*tcl\fP, wenn es mit
478 \fB\-e tcl\fP aufgerufen wurde. Die Suche wird dabei in allen
479 Abschnitten durchgeführt.
480 .TP
481 .B \-f\fP,\fB \-\-whatis
482 Diese Option ist das AEquivalent zu whatis. Es wird eine
483 Kurzbeschreibung der gewuenschten Manualseite angezeigt, wenn
484 sie gefunden wurde. Zu Details siehe whatis(1). Mit dieser
485 Option ist nur eine Standardsuche moeglich. Verbesserte Such\-
486 moeglichkeiten bieten die Optionen von whatis.
487 .TP
488 .B \-k\fP,\fB \-\-apropos
489 Diese Option ist das AEquivalent zu apropos. Es werden die
490 Kurzbeschreibungen zu allen Manualseiten nach dem angegebenen
491 Stichwort durchsucht. Zu Details siehe apropos(1). Mit dieser
492 Option ist nur eine Standardsuche moeglich. Verbesserte Such\-
493 moeglichkeiten bieten die Optionen von apropos.
494 .UNINDENT
495 .INDENT 0.0
496 .TP
497 .B \-m System[,...], \-\-systems=System[,...]
498 Wenn auch Manualseiten von einem anderen Betriebssystem instal\-
499 liert sind, so kann auf sie mit dieser Option zugegriffen wer\-
500 den. Um beispielsweise die Manualseiten von NewOS zu durch\-
501 suchen, muss \-m NewOS angegeben werden.
502 .sp
503 Das angegebene System kann eine durch Kommata abgetrennte Aufza\-
504 ehlung von Betriebssystemnamen sein. Die normalen Seiten werden
505 durch den Betriebssystemnamen man angesprochen. Diese Option
506 ueberschreibt die Umgebungsvariable $SYSTEM.
507 .UNINDENT
508 .INDENT 0.0
509 .TP
510 .BI \-p \ Zeichenkette\fR,\fB \ \-\-preprocessor\fB= Zeichenkette
511 Diese Option gibt die Reihenfolge an, in der die Praeprozessoren
512 vor nroff oder troff/groff abgearbeitet werden. Nicht alle
513 Installationen haben notwendigerweise alle Praeprozessoren.
514 Einige der Praeprozessoren und die Zeichen, um sie zu repraesen\-
515 tieren, sind: eqn (e), grap (g), pic (p), tbl (t), vgrind (v),
516 refer (r). Diese Option ueberschreibt die Umgebungsvariable
517 $MANROFFSEQ. Der Praeprozessor zsoelim wird immer als erster
518 gestartet.
519 .TP
520 .B \-u\fP,\fB \-\-update
521 Die Indexdatenbanken werden immer waehrend des laufenden
522 Betriebes auf neuestem Stand gehalten, was insbesondere
523 bedeutet, dass mandb nicht benoetigt wird, um sie konsistent zu
524 halten. Wenn die ausgewaehlte Manualseite nicht im Index gefun\-
525 den wurde oder die \-a Option verwendet wurde, macht man einen
526 Konsistenztest auf Verzeichnisebene, um sicherzustellen, dass
527 der Index immer noch eine gueltige Repraesentation der Manual\-
528 seiten im Dateisystem darstellt. Wenn dieser Test auf Inode\-
529 Ebene durchgefuehrt werden soll, muss man die Option \-u
530 benutzen.
531 .TP
532 .B \-t\fP,\fB \-\-troff
533 Mit dieser Option wird groff \-mandoc verwendet, um die Manual\-
534 seite zu formatieren und an die Standardausgabe zu liefern. Im
535 Zusammenhang mit \-T oder \-Z ist diese Option nicht noetig.
536 .UNINDENT
537 .INDENT 0.0
538 .TP
539 .B \-T Format, \-\-troff\-device [=Format]
540 Diese Option wird dazu verwendet, um das Ausgabeformat von groff
541 (oder moeglicherweise troff) zu aendern. Diese Option impliziert
542 die Angabe von \-t. Verfuegbare Ausgabeformate (von Groff\-1.17)
543 beinhalten dvi, latin1, ps, utf8, X75 und X100.
544 .UNINDENT
545 .INDENT 0.0
546 .TP
547 .B \-Z\fP,\fB \-\-ditroff
548 Das traditionelle troff erzeugt ditroff. groff startet
549 zunaechst troff und leitet danach dessen Ausgabe an einen fuer
550 das gewaehlte Ausgabeformat geeigneten Postprozessor weiter.
551 Wenn groff \-mandoc groff ist, zwingt diese Option groff dazu,
552 traditionelles troff zu emulieren und impliziert \-t, andernfalls
553 wird es ignoriert.
554 .TP
555 .B \-w\fP,\fB \-\-where\fP,\fB \-\-location
556 Zeigt nicht die Manualseiten, sondern die Position der Dateien
557 im Dateisystem an, die formatiert oder angezeigt wuerden. Wenn
558 die Datei eine cat\-Seite ist, wird auch der Ort ihrer nroff\-
559 Quelldatei angezeigt.
560 .TP
561 .B \-h\fP,\fB \-\-help
562 Zeigt einen Hilfstext an.
563 .TP
564 .B \-V\fP,\fB \-\-version
565 Zeigt Programmversion und Autor an.
566 .UNINDENT
567 .SH UMGEBUNG
568 .INDENT 0.0
569 .TP
570 .B MANPATH
571 Wenn $MANPATH gesetzt ist, wird dessen Wert als Suchpfad fuer
572 die Manualseiten benutzt.
573 .TP
574 .B MANROFFSEQ
575 Wenn $MANROFFSEQ gesetzt ist, wird dessen Wert benutzt, um die
576 Abfolge der Praeprozessoren zu bestimmen, die jede Manualseite
577 vor nroff oder troff durchlaeuft. Als Default durchlaufen die
578 Seiten den tbl (t) Praeprozessor.
579 .TP
580 .B MANSECT
581 Wenn der Wert von $MANSECT eine durch Doppelpunkte getrennte
582 Liste von Abschnitten ist, wird dieser Wert dazu benutzt, um die
583 zu durchsuchenden Abschnitte und deren Reihenfolge zu bestimmen.
584 .TP
585 .B PAGER Wenn $PAGER gesetzt ist, wird dieses Programm zur Anzeige
586 benutzt. Default ist pager \-s.
587 .TP
588 .B SYSTEM Wenn $SYSTEM gesetzt ist, hat dies den gleichen Effekt wie die
589 Option \-m System wobei System als Inhalt der Umgebungsvariable
590 $SYSTEM benutzt wird.
591 .TP
592 .B MANOPT Wenn $MANOPT gesetzt ist, wird der Wert dieser Variablen vor der
593 man Kommandozeile durchsucht und abgearbeitet. Wie auch alle
594 anderen Umgebungsvariablen, die als Kommandozeilen\-Optionen aus\-
595 gedrueckt werden koennen, ist es moeglich, den Inhalt von
596 $MANOPT durch die Kommandozeile zu ueberschreiben. Alle Leerze\-
597 ichen, die Teil eines Argumentes sind, muessen gequotet werden.
598 .TP
599 .B LANG, LC_MESSAGES
600 Abhaengig von System und Implementation werden entweder $LANG
601 oder $LC_MESSAGES oder beide nach der gegenwaertigen locale
602 Information durchsucht. man wird (wenn moeglich) seine
603 Nachrichten in dieser locale anzeigen. Fuer Details siehe
604 setlocale(3).
605 .UNINDENT
606 .SH DATEIEN
607 .INDENT 0.0
608 .TP
609 .B \fB/etc/manpath.config\fP
610 Die Manualkonfigurationsdatei.
611 .TP
612 .B \fB/usr/.../man\fP
613 Globale Manualhierarchien.
614 .TP
615 .B \fB/var/catman/.../index.(bt|db|dir|pag)\fP
616 Die FSSTND complianten globalen Indexdatenbanken.
617 .UNINDENT
618 .SH SIEHE AUCH
619 .sp
620 mandb(8), manpath(1), manpath(5), apropos(1), whatis(1), catman(8),
621 less(1), nroff(1), troff(1), groff(1), zsoelim(1), setlocale(3),
622 man(7), ascii(7), latin1(7).
623 .SH FEHLER
624 .sp
625 Die Option \-t funktioniert nur, wenn ein troff\-aehnliches Programm
626 installiert ist.
627 .sp
628 Die Option \-e funktioniert momentan nur in Manualhierarchien, fuer die
629 mit mandb eine Indexdatenbank erzeugt wurde.
630 .sp
631 Manualseiten, die die erweiterte Darstellung im Zusammenhang mit der
632 Option \-e unterstuetzen, duerfen keinen Punkt beinhalten, denn sonst
633 werden diese Seiten als fehlerhaft zurueckgewiesen.
634 .SH GESCHICHTE
635 .sp
636 1990, 1991 \- Originale geschrieben von John W. Eaton
637 (
638 'UR jwe@che.utexas.edu
639 'UE
640 ).
641 .sp
642 23. Dez. 1992: Fehlerbereinigung durch Rik Faith (
643 'UR faith@cs.unc.edu
644 'UE
645 )
646 unterstützt durch Willem Kasdorp (
647 'UR wkasdo@nikhefk.nikef.nl
648 'UE
649 ).
650 .sp
651 Zwischen dem 30. April 1994 und dem 23. Februar 2000 hat Wilf
652 (
653 'UR G.Wilford@ee.surrey.ac.uk
654 'UE
655 ) unter Mithilfe von einigen wenigen
656 engagierten Menschen dieses Paket entwickelt und weitergeführt.
657 .sp
658 Die deutsche Übersetzung wurde von Anke Steuernagel
659 (
660 'UR a_steuer@informatik.uni\-kl.de
661 'UE
662 ) und Nils Magnus
663 (
664 'UR magnus@informatik.uni\-kl.de
665 'UE
666 ) angefertigt.
667 .sp
668 Für persönliche Würdigungen und Zusätze siehe Quelltexte.
669 .\" Generated by docutils manpage writer.
670 .