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