CATMAN

Section: Dienstprogramme für Handbuchseiten (8)
Updated: 2020-06-22
Page Index

BEZEICHNUNG

catman - erzeugt oder aktualisiert vorformatierte Handbuchseiten

ÜBERSICHT

catman [-d?V] [-M Pfad] [-C Datei] [Abschnitt] ...

BESCHREIBUNG

catman wird benutzt, um einen aktuellen Satz von vorformatierten Handbuchseiten zu erzeugen, die als Cat-Seiten bezeichnet werden. Diese werden wesentlich schneller angezeigt als die unformatierten Handbuchseiten, benötigen aber zusätzlichen Speicherplatz. Die Entscheidung zur Unterstützung von »cat«-Seiten liegt beim lokalen Administrator, der für diese Seiten passende Verzeichnisse bereitstellen muss.

Die Optionen für catman geben an, welche Handbuchseiten-Hierarchien und welche Abschnitte vorformatiert werden sollen. Standard-Hierarchien sind die, die in der Konfigurationsdatei von Man-db als System-Hierarchien festgelegt werden. Die Standard-Abschnitte stehen in der Umgebungsvariable $MANSEC oder sind die in man(1) einkompilierten, wenn $MANSEC nicht definiert ist. Wird catman eine durch Leerräume gegliederte Liste von Abschnittsnamen übergeben, setzt das die oben beschriebenen Standardwerte außer Kraft.

Um die zu formatierenden Dateien zu ermitteln, wertet catman die Index-Datenbankzwischenspeicher der jeweiligen Hierarchien aus.

OPTIONEN

-d, --debug: Ausgabe von Debug-Informationen
-M Pfad, --manpath=Pfad: Gibt einen alternativen, durch Doppelpunkte gegliederten Suchpfad für Handbuchseiten-Hierarchien an. Als Standard sind dies alle Pfade, die in der Man-db-Konfigurationsdatei als systemweit gültig deklariert sind.
-C Datei, --config-file=Datei: Verwendung dieser benutzerspezifischen Konfigurationsdatei an Stelle der Vorgabe ~/.manpath
-?, --help: Hilfetext anzeigen und beenden
--usage: zeigt eine kurze Anwendungszusammenfassung an und beendet das Programm.
-V, --version: Versionsinformation anzeigen und beenden

UMGEBUNGSVARIABLEN

MANSECT: Wenn $MANSECT gesetzt ist, wird ihr Wert als eine durch Doppelpunkte gegliederte Liste von Abschnitten interpretiert und dazu benutzt, die zu durchsuchenden Abschnitte und deren Reihenfolge zu bestimmen. Die Vorgabe ist »1 1p 8 2 3 3p 3pm 4 5 6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8x«, es sei denn, dies wird durch die SECTION-Anweisung in /etc/man_db.conf außer Kraft gesetzt.
MANPATH: Wenn $MANPATH gesetzt ist, wird ihr Wert als der mit Kommas getrennte anzuwendende Hierarchie-Suchpfad für Handbuchseiten interpretiert.

DATEIEN

/etc/man_db.conf: Konfigurationsdatei für Man-db
/usr/man/index.(bt|db|dir|pag): ein traditioneller, globaler Zwischenspeicher für die Index-Datenbank
/var/catman/index.(bt|db|dir|pag): ein alternativer oder FSSTND-konformer, globaler Index-Datenbankzwischenspeicher

SIEHE AUCH

man(1), manpath(5), mandb(8)

AUTOR

Wilf. (G.Wilford@ee.surrey.ac.uk).Fabrizio Polacco (fpolacco@debian.org).Colin Watson (cjwatson@debian.org).

FEHLER

https://savannah.nongnu.org/bugs/?group=man-db