Provided by: man-db_2.5.7-4_i386 bug

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).