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-Datenbankcaches 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 n l 8 3 2 3posix 3pm 3perl 5 4 9 6
7«, es sei denn, dies wird durch die SECTION-Anweisung in
/etc/manpath.config 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/manpath.config
- Konfigurationsdatei für Man-db
- /usr/man/index.(bt|db|dir|pag)
- ein traditioneller, globaler Cache für die
Index-Datenbank
- /var/catman/index.(bt|db|dir|pag)
- ein alternativer oder FSSTND-konformer, globaler
Index-Datenbank-Cache
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).