Provided by:
man-db_2.5.7-4_i386 
NAME
catman - erzeugt oder aktualisiert die formatierten Manualseiten
SYNTAX
catman [-dhV] [-M Pfad] [Abschnitt] ...
BESCHREIBUNG
catman wird benutzt, um einen aktuellen Satz von vorformatierten
Manualseiten zu erzeugen, die als cat-Seiten bezeichnet werden. Die
cat-Seiten werden wesentlich schneller angezeigt als die unformatierten
Manualseiten, bentigen aber zustzlichen Speicherplatz auf der
Festplatte. Die Entscheidung zur Untersttzung von cat-Seiten liegt beim
lokalen Administrator, der fr diese Seiten passende Verzeichnisse
anlegen mu.
Die Optionen fr catman geben die Manualseiten und die Abschnitte an,
die vorformatiert werden sollen. Im Normalfall werden die Manualseiten
verwendet, die in der Manualkonfigurationsdatei beschrieben sind.
Normalerweise werden die Abschnitte formatiert, die entweder in der
Umgebungsvariable $MANSECT stehen oder fest in man(1) einkompiliert
sind, wenn $MANSECT undefiniert ist. Wird catman eine durch Whitespace
abgetrennte Liste von Abschnitten bergeben, so werden nur die
Manualseiten in den betreffenden Abschnitten bearbeitet.
Um festzustellen, welche Dateien formatiert werden mssen, macht catman
Gebrauch von den Indexdatenbanken der jeweiligen Manualseiten.
OPTIONEN
-d, --debug
Ausgeben von Fehlerinformationen.
-M Pfad, --manpath=Pfad
Gibt einen alternativen Manualpfad an. Als Default sind dies
alle Pfade, die in der Manualkonfigurationsdatei als global
deklariert sind. Die Umgebungsvariable $MANPATH wird von catman
nicht benutzt.
-h, --help
Zeigt einen Hilfstext an.
-V, --version
Zeigt Programmversion und Autor an.
DATEIEN
/var/catman/.../index.(bt|db|dir|pag)
Die FSSTND complianten globalen Indexdatenbanken.
/usr/man/.../whatis
Traditionelle whatis Datenbank.
SIEHE AUCH
man(1), manpath(5), mandb(8).
FEHLER
Auf Systemen mit kleinem (~4 kByte) Zwischenspeicher fr Argumente von
execve(2) kann es ntig sein, da catman mehrere kleine im Gegensatz zu
wenigen groen Batchjobs ausfhren mu. In diesem Fall ist es fr man
mglich, diesen Eintrag (korrekt) aus einer Datenbank zu lschen
(vielleicht existiert er in Wirklichkeit gar nicht mehr), der vom
aktuellen Aufruf von catman bentigt wird, um die nchste Seite zu
bestimmen. Wenn die Indexdatenbank einen Hashtable-Lookup (ndbm, gdbm)
benutzt, fhrt dies zu einem `sich am eigenen Schopf aus dem Sumpf
ziehen'. Obgleich dies selten auftritt, fhrt es dazu, da catman nicht
mehr die weiteren Seiten des Abschnittes bearbeitet.
Hinweis: Linux hat einen Zwischenspeicher von 128 kByte fr execve (2)
Argumente.
AUTOR
Wilf. (G.Wilford@ee.surrey.ac.uk), die deutsche bersetzung ist von Anke
Steuernagel (a_steuer@informatik.uni-kl.de) und Nils Magnus
(magnus@informatik.uni-kl.de).