manpath(5) das Format der Datei /etc/manpath.config

BESCHREIBUNG

Diese Konfigurationsdatei wird von den Handbuchseiten-Hilfsprogrammen dazu benutzt, den Benutzer-Handbuchpfad zur Laufzeit zu bestimmen, Handbuch-Hierarchien (Manpaths) als systemweit zu erkennen und Verzeichnisse für die Speicherung von Cat-Dateien zuzuordnen.

Wenn die Umgebungsvariable $MANPATH schon gesetzt ist, wird die Information in /etc/manpath.config die Variable nicht außer Kraft setzen.

FORMAT

Derzeit werden die folgenden Feldtypen erkannt:
# Kommentar
Leerzeilen und Zeilen, die mit einem # beginnen, werden als Kommentare behandelt und ignoriert.
MANDATORY_MANPATH geforderter Hierarchie-Bestandteil
Zeilen dieser Form zeigen die Hierarchien an, die jede automatisch erzeugte $MANPATH-Variable beinhalten sollte. Normalerweise gehört dazu /usr/man.
MANPATH_MAP Pfad-Bestandteil Hierarchie-Bestandteil
Zeilen dieser Form wandeln $PATH in die entsprechende $MANPATH-Syntax um. Für jeden Pfad-Bestandteil im persönlichen $PATH wird ein Hierarchie-Bestandteil zu $MANPATH hinzugefügt.
MANDB_MAP Hierarchie-Bestandteil [ Cat-Hierarchie-Bestandteil ]
Zeilen dieser Form geben die systemweiten Hierarchien und optional den Speicherort ihrer Cat-Dateien an. Dieser Feldtyp ist besonders wichtig, wenn man ein Setuid-Programm ist und die System-Konfigurationsdatei /etc/manpath.config die persönliche Konfigurationsdatei .manpath überlagert. Das Feld gibt an, auf welche Hierarchien als Setuid-Benutzer und auf welche als der aufrufende Benutzer zugegriffen wird.

Die systemweiten Handbuch-Hierarchien sind üblicherweise die unter /usr gespeicherten wie /usr/man, /usr/local/man und /usr/X11R6/man.

Wenn Cat-Seiten für einen Hierarchie-Bestandteil nicht oder am traditionellen Speicherort gespeichert werden sollen, kann der Cat-Hierarchie-Bestandteil weggelassen werden.

Die traditionelle Platzierung der Cat-Dateien wäre unmöglich für nicht schreibbar eingebundene Handbuch-Hierarchien. Aus diesem Grund ist es möglich, beliebige gültige Verzeichnis-Hierarchien als Speicherorte anzugeben. Zur Wahrung des Linux FSSTND kann das Schlüsselwort FSSTND anstelle eines vorhandenen Verzeichnisses verwendet werden.

Leider müssen alle System-Handbuchpfade angegeben werden, einschließlich derer von alternativen Betriebssystemen wie /usr/man/sun und aller Pfade für NLS Locales wie beispielsweise /usr/man/de_DE.88591.

Da die Informationen Zeile für Zeile in der Schreibreihenfolge analysiert werden, müssen alle einer anderen untergeordneten Handbuch-Hierarchien zuerst aufgeführt werden, damit falsche Zuordnungen ausgeschlossen werden. Beispielsweise muss /usr/man/de_DE.88591 vor /usr/man aufgeführt werden.

DEFINE Schlüssel Wert
Zeilen dieser Form definieren verschiedene Konfigurationsvariablen. In der Standard-Konfigurationsdatei werden die von den Handbuch-Programmen verwendeten Variablen festgelegt. Dazu gehören Standard-Pfade zu verschiedenen Programmen (wie grep und tbl) und Sätze von Standard-Argumenten für diese Programme.
SECTION Abschnitt ...
Zeilen dieser Form bestimmen die Reihenfolge, in der Handbuch-Abschnitte durchsucht werden sollen. Enthält die Konfigurationsdatei keinen SECTION-Eintrag, ist der Standardwert:

SECTION 1 n l 8 3 0 2 5 4 9 6 7

Sind mehrere SECTION-Einträge vorhanden, werden deren Listen aneinander gehängt.

Wenn eine bestimmte Erweiterung (z.B. 1mh) nicht in dieser Liste eingetragen ist, werden die entsprechenden Seiten mit dem Rest des zugehörigen Abschnitts angezeigt. Der Effekt davon ist: Nur, wenn Sie eine bestimmte Reihenfolge erzwingen wollen, müssen Sie explizit eine Liste von Erweiterungen angeben. Abschnitte mit Erweiterungen sollten in der Regel den Hauptabschnitten benachbart sein (z.B. »1 1mh 8 ... «).

Als alternativer Name für diese Direktive wird SECTIONS akzeptiert.

MINCATWIDTH Breite
Wenn die Terminalbreite kleiner als Breite ist, werden fehlende Cat-Seiten nicht erzeugt und vorhandene nicht angezeigt. Der Standardwert ist 80.
MAXCATWIDTH Breite
Wenn die Terminalbreite größer als Breite ist, werden fehlende Cat-Seiten nicht erzeugt und vorhandene nicht angezeigt. Der Standardwert ist 80.
CATWIDTH Breite
Wenn Breite von Null verschieden ist, werden die Cat-Seiten für ein Terminal der vorgegebenen Breite formatiert, ungeachtet der Breite des aktuell verwendeten Terminals. Im Allgemeinen sollte ein Wert aus dem von MINCATWIDTH und MAXCATWIDTH festgelegten Bereich gewählt werden.
NOCACHE
Dieses Option hält man von der automatischen Erzeugung von Cat-Seiten ab.

FEHLER

Wenn die oben angeführten Regeln nicht genau befolgt werden, werden sich die Handbuch-Dienstprogramme nicht wie gewünscht verhalten. Die Regeln sind zu kompliziert.