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
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
|
MAN(1) Manual Hilfsprogramme MAN(1)
NNAAMMEE
man - Programm zum Einsehen der Online-Manuale
SSYYNNTTAAXX
man [-acdhwutZV] [-m System[,...]] [-L locale] [-p Zeichenkette]
[-M Pfad] [-P Pager] [-r Prompt] [-T Format] [-S Liste] [-e Er-
weiterung] [[Abschnitt] Seite ...] ...
man -l [-tZ] [-p Zeichenkette] [-P Pager] [-r Prompt] [-T Format]
Datei ...
man -k Schluesselwort ...
man -f Seite ...
BBEESSCCHHRREEIIBBUUNNGG
man ist der Manualbrowser des Systems. Jedes Argument Seite ist nor-
malerweise der Name eines Programmes oder einer Funktion. Gefunden und
angezeigt wird die Manualseite, die auf alle Argumente passt. Wenn ein
Abschnitt angegeben wird, sucht man nur in diesem Abschnitt der Manual-
seiten. Ohne Angabe eine explizite Angabe werden alle verfueg-
baren Abschnitte in einer vorher definierten Reihenfolge durchsucht.
Wenn die Seite in mehreren Abschnitten vorkommt, wird nur die jeweils
erste Seite angezeigt, die gefunden wird.
Die folgende Tabelle zeigt die Nummern der Abschnitte der Manualseiten
gefolgt vom Typ der dort zu findenden Seiten.
+--+----------------------------+
|1 | Ausfuehrbare Programme |
| | oder Shellbefehle |
+--+----------------------------+
|2 | Systemaufrufe (Kernelfunk- |
| | tionen) |
+--+----------------------------+
|3 | Bibliotheksaufrufe (Funk- |
| | tionen in System-Biblio- |
| | theken) |
+--+----------------------------+
|4 | Spezielle Dateien |
| | (gewoehnlich in /dev) |
+--+----------------------------+
|5 | Dateiformate und Konven- |
| | tionen, z. B. /etc/passwd |
+--+----------------------------+
|6 | Spiele |
+--+----------------------------+
|7 | Makropakete und Konventio- |
| | nen, z. B. man(7), |
| | groff(7) |
+--+----------------------------+
|8 | Systemadministrationsbe- |
| | fehle (in der Regel nur |
| | fuer root) |
+--+----------------------------+
|9 | Kernelroutinen [Nicht |
| | Standard] |
+--+----------------------------+
|n | neu [veraltet] |
+--+----------------------------+
|l | lokal [veraltet] |
+--+----------------------------+
|p | oeffentlich [veraltet] |
+--+----------------------------+
|o | alt [veraltet] |
+--+----------------------------+
Eine Manualseite besteht aus mehreren Teilen. Die ueblichen Bezeichnun-
gen sind u. a. NAME, SYNTAX, BESCHREIBUNG, OPTIONEN, DATEIEN,
SIEHE AUCH, FEHLER, und AUTOR.
Die folgenden Konventionen gelten fuer den Abschnitt SYNTAX und koennen
fuer andere Abschnitte als Anleitung benutzt werden.
bboolldd tteexxtt
Literale Angaben wie in der Anzeige.
iittaalliicc tteexxtt
Ersetzen durch passendes Argument.
[[--aabbcc]] Ein oder mehrere Argumente innerhalb der [[ ]] sind optional.
--aa||--bb Optionen, die durch || abgegrenzt sind, koennen nicht zusammen
benutzt werden.
AArrgguummeenntt ......
Argument kann wiederholt werden.
[[AAuussddrruucckk]] ......
gesamter Ausdruck innerhalb [[ ]] kann wiederholt werden.
Die Befehls- oder Funktionsbeispiele sind Muster, die auf alle
moeglichen Aufrufe passen sollten. In manchen Faellen ist es ratsam,
die verschiedenen sich ausschliessenden Aufrufe zu illustrieren, wie es
im SYNTAX Abschnitt dieser Manualseite gezeigt ist.
BBEEIISSPPIIEELLEE
mmaann llss zeigt die Manualseite fuer das Programm ls an.
mmaann --aa iinnttrroo
zeigt alle vorhandenen intro Manualseiten an. Mit (q)uit ist
es moeglich, das aufeinanderfolgendende Anzeigen der
Seiten abzubrechen oder mit (s)kip eine Seite zu ueberspringen.
mmaann --tt aalliiaass || llpprr --PPppss
Formatiert die Manualseite, die sich auf alias bezieht, in
das Default troff oder groff Format und schickt es an den
Drucker ps. Die Defaultausgabe fuer groff ist Postscript.
Das Default fuer troff - ditroff, benoetigt weitere Bear-
beitung durch grops, bevor es von einem Postscriptdrucker
gedruckt werden kann. man --help sollte zu bestimmen
helfen, welcher Prozessor an die -t Option gebunden ist.
mmaann --ll --TTddvvii ..//ffoooo..11xx..ggzz >> ..//ffoooo..11xx..ddvvii
Dieser Befehl formatiert die komprimierte nroff-Manual-
seite ./foo.1x.gz in eine device independent (dvi) Datei.
Diese Datei wird zuerst dekomprimiert, bevor sie durch passende
Filter und Pro- gramme bearbeitet wird. Die Umlenkung ist
notwendig, da die -T Option die Ausgabe unformatiert an die
Standardausgabe schickt. Die Ausgabe kann mit einem Programm
wie xdvi betrachtet oder mit einem Programm wie dvips in Post-
script weiterverarbeitet werden.
mmaann --kk pprriinnttff
Sucht die Kurzbeschreibungen und die Namen der Manualseiten
zum Schluesselwort printf und gibt alle Treffer aus.
mmaann --ff ssmmaaiill
Sucht die Manualseiten, die sich auf smail beziehen und gibt
alle gefundenen Kurzbeschreibungen aus.
UUEEBBEERRSSIICCHHTT
Um dem Benutzer eine groesstmoegliche Flexibilität zu bieten, sind in
man viele Optionen verfuegbar. Veraenderungen koennen am Suchpfad, in
der Reihenfolge der Abschnitte oder am Ausgabeprozessor vorgenommen
werden. Andere Verhaltensweisen und Operationen sind weiter unten
beschrieben.
Um die Arbeitsweise von man zu bestimmen, werden verschiedene Umge-
bungsvariablen benutzt. Mit dieser Version ist es moeglich, die Vari-
able $$MMAANNOOPPTT auf einen Ausdruck im Kommandozeilenformat zu setzen. Es
gibt folgende Ausnahme: Da jede Option in $$MMAANNOOPPTT von Leerzeichen
eingeschlossen ist, muessen Leerzeichen, die Teil eines Argumentes
sind, gequotet werden. man bearbeitet diese Variable vor der eigenen
Kommandozeile. Die Optionen, die ein Argument benoetigen, koennen
durch die gleichen Optionen in der Kommandozeile ueberschrieben wer-
den. Um alle Optionen zurueckzusetzen, die in $$MMAANNOOPPTT gesetzt werden,
kann --DD als initiale Kommandozeilen-Option angegeben werden. Dies
erlaubt man alle Optionen zu _u_e_b_e_r_s_c_h_r_e_i_b_e_n, die in $$MMAANNOOPPTT gesetzt
werden, obwohl diese weiterhin gelten. Damit wird die groesst-
moegliche Flexibilität fuer einen Benutzer erzeugt, der man auf
seine eigenen Beduerfnisse anpassen will, ohne zahllose Optionen bei
der Suche einer Manualseite einzugeben.
Die Hilfsprogramme, die im man-db-Paket zusammengefasst sind, machen
umfassenden Gebrauch von Indexdatenbanken. Diese Zwischenspeicher
enthalten Informationen ueber den Ort und die zugehoerige whatis Infor-
mation (einzeilige Kurzbeschreibung der Manualseite), sowie darüber,
wo sich eine Manualseite im Dateisystem befindet. Eine Aufgabe von man
ist die Konsistenzsicherung der Datenbank. Die Datenbanken verhindern
die Notwendigkeit einer manuellen Bearbeitung zur Aktualisierung der
whatis-Textdatenbank und erlauben man schneller zu arbeiten, als bei
der Suche nach der passenden Manualseite im gesamten Dateisystem.
Wenn man keine von mandb erstellte Indexdatenbank zu einer speziellen
Manualhierarchie finden kann, wird dennoch nach der gewuenschten Manu-
alseite gesucht. In diesem Fall ist es jedoch wieder noetig, nach der
alten Methode alle in Frage kommenden Verzeichnisse zu durchsuchen
(sog. globbing). Wenn whatis oder apropos keine Indexdatenbank finden
koennen, versucht es die Information aus der whatis-Datenbank zu
beziehen. Auch anwenderspezifische Manualhierarchien werden waehrend
der Benutzung in Indexdatenbanken zusammengefasst.
Die Hilfsprogramme unterstuetzen komprimierte nroff-Quelldateien, die
normalerweise die Erweiterung .Z, .z oder .gz besitzen. Jede andere
Erweiterung kann unterstuetzt werden, wenn sie zur UEbersetzungszeit
bekannt ist. Als Default werden alle cat-Seiten mit gzip komprimiert.
Jede globale Manualhierarchie wie /usr/man oder /usr/X11R6/man kann
jedes Verzeichnis als cat-Seiten-Hierarchie besitzen. UEblicherweise
werden cat-Seiten unter der gleichen Hierarchie wie die Manualseiten
gespeichert. Allerdings kann es aus Gruenden, die im Linux File System
Standard (FSSTND) erlaeutert sind, besser sein, sie an anderer Stelle
zu speichern. Details, wann dies der Fall ist, beschreibt manpath(5).
Fuer Details, warum dies empfohlen wird, siehe den Linux File System
Standard (FSSTND).
Dieses Paket unterstuetzt internationale Anpassungen (sog. NLS-Support,
Native Language Support). Durch den Gebrauch von locale Funktionen ist
es moeglich, Manualseiten der Landessprache zu verwalten, wenn sie auf
dem System vorhanden sind. Um diese Unterstuetzung zu aktivieren, muss
man entweder in $LC_MESSAGES, $LANG oder anderen systemabhaengigen
Umgebungsvariablen die gewuenschte Sprache einstellen. Die Sprache wird
normalerweise in dem durch POSIX 1003.1 definierten Format angegeben:
<Sprache>[_<Region>[.<Zeichensatz>[,<Version>]]]
Wenn die angeforderte Seite in der locale vorhanden ist, wird sie
anstelle der Standardseite (normalerweise in amerikanischem Englisch)
angezeigt. Darueber hinaus werden auch Sammlungen von landessprach-
lichen Systemmeldungen unterstuetzt und auf dieselbe Weise aktiviert -
ebenfalls unter der Vorraussetzung, dass die uebersetzten Meldungen
vorliegen. Wer diese Manualseiten und die Ausgaben der Hilfsprogramme
gerne in seiner Landessprache haette, aber diese nicht vorfindet, ist
aufgefordert, eine UEbersetzung anzufertigen und sie dem Autor
zuzusenden, damit spaetere Versionen davon profitieren koennen.
Die anderen Eigenschaften und Erweiterungen von man sind in den
beiliegenden Dokumenten beschrieben. Einen umfassenden Einblick in die
mandb zugrundeliegenden Konzepte sind in der Dokumentation man-db-2.3 -
the database cached manual pager suite beschrieben. Die Dokumentation
sollte auf denselben Server wie das mandb- Paket selbst zu finden sein.
NNOORRMMAALLEEIINNSSTTEELLLLUUNNGGEENN
man sucht nach der gewueschten Manualseite in der Indexdatenbank. Wenn
die Suche fehlschlaegt, wird ein Konsistenztest durchgefuehrt, um die
korrekte Wiedergabe des Dateisystems zu sichern. Nachdem die Daten-
banken erzeugt wurden, ist es i. A. nicht notwendig, mandb zu starten,
es sei denn, die Datenbank wurde verfaelscht.
Wenn eine Manualseite gefunden wurde, wird getestet, ob dazu bereits
eine vorformatierte cat-Seite existiert und diese neuer als die nroff-
Datei ist. In diesem Fall wird die vorformatierte Datei dekomprimiert
und mit einem Browser angezeigt. Die Auswahl des Browsers kann auf
unterschiedliche Weise erfolgen (fuer Details siehe -P Option). Wenn
keine cat-Seite gefunden wird oder wenn sie aelter als die nroff-Datei
ist, wird die nroff-Datei durch diverse Programme gefiltert und
entweder sofort angezeigt oder zuerst als komprimierte cat-Datei gespe-
ichert und dann angezeigt.
Eine cat-Datei wird erzeugt, wenn ein relatives cat-Verzeichnis
existiert und man dort das Schreibrecht hat.
Die Filter werden in mehreren Schritten zusammengestellt: Zuerst wird
die Kommandozeilen-Option -p oder die Umgebungsvariable $MANROFFSEQ
untersucht. Wenn -p nicht benutzt wird und die Umgebungsvariable nicht
gesetzt ist, wird die Anfangszeile der nroff-Datei nach einer Zeichen-
kette fuer den Praeprozessor untersucht. Eine solche Praeprozessor-
Zeichenkette muss folgendes Aussehen haben:
'\" <Zeichenkette>
wobei Zeichenkette jede Kombination von Buchstaben sein kann, die unter
Option -p weiter unten beschrieben sind.
Wenn keine der obigen Methoden eine Filter-Information enthaelt, wird
tbl als Default verwendet.
Als primaerer Formatierer wird entweder nroff, troff oder groff ges-
tartet.
OOPPTTIIOONNEENN
Eine Argumentoption, die entweder in der Kommandozeile, in $$MMAANNOOPPTT oder
in beiden doppelt vorkommt , ist nicht schaedlich. Fuer Optionen, die
ein Argument benötigen, überschreibt jedes Duplikat den vorhergehenden
Wert.
--ll, ----llooccaall--ffiillee
Aktiviert den lokalen Modus. Formatiert und zeigt lokale Manual-
dateien an, anstatt die System-Manualsammlung zu durchsuchen.
Jedes Manualseiten-Argument wird als nroff-Quelle im richtigen
Format interpretiert. Komprimierte nroff-Quelldateien mit einer
unterstuetzten Kompressions-Erweiterung werden von man dekom-
primiert, bevor sie ueber den ueblichen Filter angezeigt werden.
Es wird keine cat-Datei erzeugt. Wenn eines der Argumente --
ist, wird die Eingabe von der Standardeingabe uebernommen.
--LL _l_o_c_a_l_e, ----llooccaallee==_l_o_c_a_l_e
Normalerweise bestimmt man die aktuelle locale durch einen
Aufruf der C Funktion setlocale (3), die diverse Umgebungsvari-
ablen, darunter u. U. $LC_MESSAGES und $LANG untersucht. Diese
Funktion kann dazu verwendet werden, kurzzeitig den so gefunde-
nen Wert zu ueberschreiben. Dazu kann diese Option mit einer
Zeichenkette, die die temporaere locale enthaelt, angegeben wer-
den. Man beachte, dass dieser Effekt erst beim konkreten Suchen
der Seite in Erscheinung tritt. Daher werden Ausgaben wie die
Hilfeseite immer in der urspruenglichen Sprache ausgegeben.
--DD, ----ddeeffaauulltt
Diese Option wird normalerweise nur als allererste angegeben und
setzt das Verhalten von man in allen Belangen wieder zum Nor-
malverhalten zurueck. Der Zweck dieser Option ist es, Optionen
wieder rueckgaengig zu machen, die bereits in der Umgebungsvari-
able $MANOPT gesetzt sind. Alle Optionen, die -D folgen, haben
wieder ihren gewohnten Effekt.
--MM _P_f_a_d, ----mmaannppaatthh==_P_f_a_d
Ermoeglicht es, einen alternativen Manualpfad anzugeben. Nor-
malerweise verwendet man dieselben Methoden wie in manpath, um
den Suchpfad zu ermitteln. Diese Option ueberschreibt die Umge-
bungsvariable $$MMAANNPPAATTHH.
--PP _P_a_g_e_r, ----ppaaggeerr==_P_a_g_e_r
Gibt an, welcher Pager verwendet wird. Die Normaleinstellung ist
pager-s. Diese Option ueberschreibt die Umgebungsvariable
$$PPAAGGEERR und wird nicht in Zusammenhang mit -f oder -k verwendet.
--rr _P_r_o_m_p_t, ----pprroommpptt==_P_r_o_m_p_t
Wenn eine hinreichend neue Version von less als Pager verwendet
wird, versucht man dort einige sinnvolle Optionen zu setzen. Die
Eingabeaufforderung in der letzten Zeile sieht in dem Fall so
aus:
Manual page name(sec) line x,
wobei name die Manualseite bezeichnet, die gerade angezeigt
wird, sec der Abschnitt ist, in dem sie gefunden wurde, und x
die aktuelle Zeilennummer ist. Diese Anzeige wird durch Verwen-
dung der Umgebungsvariable $$LLEESSSS erreicht. Man beachte, dass
einzelne Bezeichnungen sich bei der Verwendung von landessprach-
lichen Meldungen ändern koennen. Die Option --rr ermöglicht es,
durch Angabe einer Formatierungszeichenkette, das Ausgabeformat
selbst zu bestimmen. Wenn diese Zeichenkette $$MMAANN__PPNN enthält,
wird dieser Text durch den Namen der Manualseite gefolgt von der
Abschnittsnummer in runden Klammern ersetzt. Die Zeichenkette,
die im Normalfall verwendet wird ist:
\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB %pB\\%..
Die zweizeilige Darstellung wurde nur der besseren Lesbarkeit
wegen gewählt. Nähere Informationen liefert less(1). Da die
Zeichenkette zuerst vom Kommandointerpreter ausgewertet wird,
muessen entsprechende Zeichen durch einen Backslash geschützt
werden. Weitere Optionen für less koennen nach einem
geschützten $$ am Ende der Zeichenkette hinzugefügt werden. Der
Default ist hier --iixx88.
--SS _L_i_s_t_e, ----sseeccttiioonnss==_L_i_s_t_e
Eine durch Doppelpunkte getrennte Liste von Abschnitten
definiert bei Benutzung dieser Option die Reihenfolge, in der
die Abschnitte durchsucht werden. Diese Option ueberschreibt die
Umgebungsvariable $MANSECT.
--aa, ----aallll
Wird eine Manualseite in einem Abschnitt gefunden, so terminiert
man nach Anzeige dieser Seite. Wird jedoch diese Option
angegeben, so werden alle passenden Manualseiten nacheinander
angezeigt.
--cc, ----ccaattmmaann
Diese Option ueberprueft nur, ob die zur angegebenen Manualseite
passende cat-Seite aktuell ist und erzeugt ggf. eine neue. Es
wird dabei nichts angezeigt.
--dd, ----ddeebbuugg
Bei dieser Option werden keine Manualseiten angezeigt, sondern
nur eine Menge von Diagnoseinformation.
--ee _E_r_w_e_i_t_e_r_u_n_g, ----eexxtteennssiioonn==_E_r_w_e_i_t_e_r_u_n_g
Einige Systeme enthalten grosse Pakete an Manualseiten, wie
z.B. in dem Tcl Paket, die in die normalen Manualabschnitte in-
tegriert werden. Um beispielsweise das Problem zweier unter-
schiedlicher Manualseiten mit gleichem Namen, wie exit(3), zu
lösen, wurden früher alle Tcl Seiten dem Abschnitt l zugeordnet.
Dieses erwies sich als keine gute Lösung. Bei dieser Version von
man ist es möglich, die Seiten in die richtigen Abschnitte
einzuordnen und ihrem Seitennamen eine spezifische Erweiterung,
hier z. B. exit(3tcl) anzuhängen. Unter normalen Umständen
zeigt man bevorzugt exit(3) gegenüber exit(3tcl) an. Um dieses
Verhalten umzukehren, ist man die Zeichenkette Erweiterung
zu übergeben, die angibt, in welchem Paket die Manualseite zu
finden ist. Im obigen Fall beschränkt man seine Suche auf
Seiten mit der Erweiterung **ttccll, wenn es mit --ee ttccll aufgerufen
wurde. Die Suche wird dabei in allen Abschnitten durchgeführt.
--ff, ----wwhhaattiiss
Diese Option ist das AEquivalent zu whatis. Es wird eine
Kurzbeschreibung der gewuenschten Manualseite angezeigt, wenn
sie gefunden wurde. Zu Details siehe whatis(1). Mit dieser
Option ist nur eine Standardsuche moeglich. Verbesserte Such-
moeglichkeiten bieten die Optionen von whatis.
--kk, ----aapprrooppooss
Diese Option ist das AEquivalent zu apropos. Es werden die
Kurzbeschreibungen zu allen Manualseiten nach dem angegebenen
Stichwort durchsucht. Zu Details siehe apropos(1). Mit dieser
Option ist nur eine Standardsuche moeglich. Verbesserte Such-
moeglichkeiten bieten die Optionen von apropos.
--mm SSyysstteemm[[,,......]],, ----ssyysstteemmss==SSyysstteemm[[,,......]]
Wenn auch Manualseiten von einem anderen Betriebssystem instal-
liert sind, so kann auf sie mit dieser Option zugegriffen wer-
den. Um beispielsweise die Manualseiten von NewOS zu durch-
suchen, muss -m NewOS angegeben werden.
Das angegebene System kann eine durch Kommata abgetrennte Aufza-
ehlung von Betriebssystemnamen sein. Die normalen Seiten werden
durch den Betriebssystemnamen man angesprochen. Diese Option
ueberschreibt die Umgebungsvariable $SYSTEM.
--pp _Z_e_i_c_h_e_n_k_e_t_t_e, ----pprreepprroocceessssoorr==_Z_e_i_c_h_e_n_k_e_t_t_e
Diese Option gibt die Reihenfolge an, in der die Praeprozessoren
vor nroff oder troff/groff abgearbeitet werden. Nicht alle
Installationen haben notwendigerweise alle Praeprozessoren.
Einige der Praeprozessoren und die Zeichen, um sie zu repraesen-
tieren, sind: eqn (e), grap (g), pic (p), tbl (t), vgrind (v),
refer (r). Diese Option ueberschreibt die Umgebungsvariable
$MANROFFSEQ. Der Praeprozessor zsoelim wird immer als erster
gestartet.
--uu, ----uuppddaattee
Die Indexdatenbanken werden immer waehrend des laufenden
Betriebes auf neuestem Stand gehalten, was insbesondere
bedeutet, dass mandb nicht benoetigt wird, um sie konsistent zu
halten. Wenn die ausgewaehlte Manualseite nicht im Index gefun-
den wurde oder die -a Option verwendet wurde, macht man einen
Konsistenztest auf Verzeichnisebene, um sicherzustellen, dass
der Index immer noch eine gueltige Repraesentation der Manual-
seiten im Dateisystem darstellt. Wenn dieser Test auf Inode-
Ebene durchgefuehrt werden soll, muss man die Option -u
benutzen.
--tt, ----ttrrooffff
Mit dieser Option wird groff -mandoc verwendet, um die Manual-
seite zu formatieren und an die Standardausgabe zu liefern. Im
Zusammenhang mit -T oder -Z ist diese Option nicht noetig.
--TT FFoorrmmaatt,, ----ttrrooffff--ddeevviiccee [[==FFoorrmmaatt]]
Diese Option wird dazu verwendet, um das Ausgabeformat von groff
(oder moeglicherweise troff) zu aendern. Diese Option impliziert
die Angabe von -t. Verfuegbare Ausgabeformate (von Groff-1.17)
beinhalten dvi, latin1, ps, utf8, X75 und X100.
--ZZ, ----ddiittrrooffff
Das traditionelle troff erzeugt ditroff. groff startet
zunaechst troff und leitet danach dessen Ausgabe an einen fuer
das gewaehlte Ausgabeformat geeigneten Postprozessor weiter.
Wenn groff -mandoc groff ist, zwingt diese Option groff dazu,
traditionelles troff zu emulieren und impliziert -t, andernfalls
wird es ignoriert.
--ww, ----wwhheerree, ----llooccaattiioonn
Zeigt nicht die Manualseiten, sondern die Position der Dateien
im Dateisystem an, die formatiert oder angezeigt wuerden. Wenn
die Datei eine cat-Seite ist, wird auch der Ort ihrer nroff-
Quelldatei angezeigt.
--hh, ----hheellpp
Zeigt einen Hilfstext an.
--VV, ----vveerrssiioonn
Zeigt Programmversion und Autor an.
UUMMGGEEBBUUNNGG
MMAANNPPAATTHH
Wenn $MANPATH gesetzt ist, wird dessen Wert als Suchpfad fuer
die Manualseiten benutzt.
MMAANNRROOFFFFSSEEQQ
Wenn $MANROFFSEQ gesetzt ist, wird dessen Wert benutzt, um die
Abfolge der Praeprozessoren zu bestimmen, die jede Manualseite
vor nroff oder troff durchlaeuft. Als Default durchlaufen die
Seiten den tbl (t) Praeprozessor.
MMAANNSSEECCTT
Wenn der Wert von $MANSECT eine durch Doppelpunkte getrennte
Liste von Abschnitten ist, wird dieser Wert dazu benutzt, um die
zu durchsuchenden Abschnitte und deren Reihenfolge zu bestimmen.
PPAAGGEERR WWeennnn $$PPAAGGEERR ggeesseettzztt iisstt,, wwiirrdd ddiieesseess PPrrooggrraammmm zzuurr AAnnzzeeiiggee
benutzt. Default ist pager -s.
SSYYSSTTEEMM WWeennnn $$SSYYSSTTEEMM ggeesseettzztt iisstt,, hhaatt ddiieess ddeenn gglleeiicchheenn EEffffeekktt wwiiee ddiiee
Option -m System wobei System als Inhalt der Umgebungsvariable
$SYSTEM benutzt wird.
MMAANNOOPPTT WWeennnn $$MMAANNOOPPTT ggeesseettzztt iisstt,, wwiirrdd ddeerr WWeerrtt ddiieesseerr VVaarriiaabblleenn vvoorr ddeerr
man Kommandozeile durchsucht und abgearbeitet. Wie auch alle
anderen Umgebungsvariablen, die als Kommandozeilen-Optionen aus-
gedrueckt werden koennen, ist es moeglich, den Inhalt von
$MANOPT durch die Kommandozeile zu ueberschreiben. Alle Leerze-
ichen, die Teil eines Argumentes sind, muessen gequotet werden.
LLAANNGG,, LLCC__MMEESSSSAAGGEESS
Abhaengig von System und Implementation werden entweder $LANG
oder $LC_MESSAGES oder beide nach der gegenwaertigen locale
Information durchsucht. man wird (wenn moeglich) seine
Nachrichten in dieser locale anzeigen. Fuer Details siehe setlo-
cale(3).
DDAATTEEIIEENN
//eettcc//mmaannppaatthh..ccoonnffiigg
Die Manualkonfigurationsdatei.
//uussrr//......//mmaann
Globale Manualhierarchien.
//vvaarr//ccaattmmaann//......//iinnddeexx..((bbtt||ddbb||ddiirr||ppaagg))
Die FSSTND complianten globalen Indexdatenbanken.
SSIIEEHHEE AAUUCCHH
mandb(8), manpath(1), manpath(5), apropos(1), whatis(1), catman(8),
less(1), nroff(1), troff(1), groff(1), zsoelim(1), setlocale(3),
man(7), ascii(7), latin1(7).
FFEEHHLLEERR
Die Option -t funktioniert nur, wenn ein troff-aehnliches Programm
installiert ist.
Die Option -e funktioniert momentan nur in Manualhierarchien, fuer die
mit mandb eine Indexdatenbank erzeugt wurde.
Manualseiten, die die erweiterte Darstellung im Zusammenhang mit der
Option -e unterstuetzen, duerfen keinen Punkt beinhalten, denn sonst
werden diese Seiten als fehlerhaft zurueckgewiesen.
GGEESSCCHHIICCHHTTEE
1990, 1991 - Originale geschrieben von John W. Eaton (-
_j_w_e_@_c_h_e_._u_t_e_x_a_s_._e_d_u).
23. Dez. 1992: Fehlerbereinigung durch Rik Faith (_f_a_i_t_h_@_c_s_._u_n_c_._e_d_u)
unterstützt durch Willem Kasdorp (_w_k_a_s_d_o_@_n_i_k_h_e_f_k_._n_i_k_e_f_._n_l).
Zwischen dem 30. April 1994 und dem 23. Februar 2000 hat Wilf (-
_G_._W_i_l_f_o_r_d_@_e_e_._s_u_r_r_e_y_._a_c_._u_k) unter Mithilfe von einigen wenigen en-
gagierten Menschen dieses Paket entwickelt und weitergeführt.
Die deutsche Übersetzung wurde von Anke Steuernagel (-
_a___s_t_e_u_e_r_@_i_n_f_o_r_m_a_t_i_k_._u_n_i_-_k_l_._d_e) und Nils Magnus (-
_m_a_g_n_u_s_@_i_n_f_o_r_m_a_t_i_k_._u_n_i_-_k_l_._d_e) angefertigt.
Für persönliche Würdigungen und Zusätze siehe Quelltexte.
2.5.1 2008-01-28 MAN(1)
|
