catman(n)             Manual Hilfsprogramme             catman(n)



NAME
       catman  - erzeugt oder aktualisiert die formatierten Manu-
       alseiten

SYNTAX
       catman [-dhV] [-M Pfad] [Abschnitt] ...

BESCHREIBUNG
       catman wird benutzt, um einen aktuellen Satz  von  vorfor-
       matierten  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  Fest-
       platte.  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 Normal-
       fall  werden  die Manualseiten verwendet, die in der Manu-
       alkonfigurationsdatei beschrieben sind. Normalerweise wer-
       den  die  Abschnitte formatiert, die entweder in der Umge-
       bungsvariable $MANSEC stehen oder fest in  man(n)  einkom-
       piliert  sind,  wenn  $MANSEC undefiniert ist. Wird catman
       eine durch Whitespace abgetrennte  Liste  von  Abschnitten
       bergeben,  so  werden  nur die Manualseiten in den betref-
       fenden Abschnitten bearbeitet.

       Um festzustellen, welche Dateien formatiert werden  mssen,
       macht  catman  Gebrauch  von den Indexdatenbanken der jew-
       eiligen 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 Manualkonfigura-
              tionsdatei als global deklariert  sind.  Die  Umge-
              bungsvariable   $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(n), manpath(h), mandb(b).

FEHLER
       Auf Systemen mit kleinem (~4  kByte)  Zwischenspeicher  fr
       Argumente  von  execve(e)  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  (vielle-
       icht 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).



2.3.20                  07 September 2001               catman(n)