Provided by:
man-db_2.6.1-2_i386 
BEZEICHNUNG
manpath - 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 fur die Speicherung von Cat-Dateien zuzuordnen.
Wenn die Umgebungsvariable $MANPATH schon gesetzt ist, wird die
Information in /etc/manpath.config die Variable nicht auBer 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 gehort dazu /usr/man.
MANPATH_MAP Pfad-Bestandteil Hierarchie-Bestandteil
Zeilen dieser Form wandeln $PATH in die entsprechende
$MANPATH-Syntax um. Fur jeden Pfad-Bestandteil im personlichen
$PATH wird ein Hierarchie-Bestandteil zu $MANPATH hinzugefugt.
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 personliche
Konfigurationsdatei .manpath uberlagert. Das Feld gibt an, auf
welche Hierarchien als Setuid-Benutzer und auf welche als der
aufrufende Benutzer zugegriffen wird.
Die systemweiten Handbuch-Hierarchien sind ublicherweise die
unter /usr gespeicherten wie /usr/man, /usr/local/man und
/usr/X11R6/man.
Wenn Cat-Seiten fur einen Hierarchie-Bestandteil nicht oder am
traditionellen Speicherort gespeichert werden sollen, kann der
Cat-Hierarchie-Bestandteil weggelassen werden.
Die traditionelle Platzierung der Cat-Dateien ware unmoglich fur
nicht schreibbar eingebundene Handbuch-Hierarchien. Aus diesem
Grund ist es moglich, beliebige gultige Verzeichnis-Hierarchien
als Speicherorte anzugeben. Zur Wahrung des Linux FSSTND kann
das Schlusselwort FSSTND anstelle eines vorhandenen
Verzeichnisses verwendet werden.
Leider mussen alle System-Handbuchpfade angegeben werden,
einschlieBlich derer von alternativen Betriebssystemen wie
/usr/man/sun und aller Pfade fur NLS Locales wie beispielsweise
/usr/man/de_DE.88591.
Da die Informationen Zeile fur Zeile in der Schreibreihenfolge
analysiert werden, mussen alle einer anderen untergeordneten
Handbuch-Hierarchien zuerst aufgefuhrt werden, damit falsche
Zuordnungen ausgeschlossen werden. Beispielsweise muss
/usr/man/de_DE.88591 vor /usr/man aufgefuhrt werden.
DEFINE Schl"ussel Wert
Zeilen dieser Form definieren verschiedene
Konfigurationsvariablen. In der Standard-Konfigurationsdatei
werden die von den Handbuch-Programmen verwendeten Variablen
festgelegt. Dazu gehoren Standard-Pfade zu verschiedenen
Programmen (wie grep und tbl) und Satze von Standard-Argumenten
fur diese Programme.
SECTION Abschnitt ...
Zeilen dieser Form bestimmen die Reihenfolge, in der
Handbuch-Abschnitte durchsucht werden sollen. Enthalt die
Konfigurationsdatei keinen SECTION-Eintrag, ist der
Standardwert:
SECTION 1 n l 8 3 0 2 5 4 9 6 7
Sind mehrere SECTION-Eintrage vorhanden, werden deren Listen
aneinander gehangt.
Wenn eine bestimmte Erweiterung (z.B. 1mh) nicht in dieser Liste
eingetragen ist, werden die entsprechenden Seiten mit dem Rest
des zugehorigen Abschnitts angezeigt. Der Effekt davon ist: Nur,
wenn Sie eine bestimmte Reihenfolge erzwingen wollen, mussen 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 fur 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 groBer 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 fur
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 gewahlt werden.
NOCACHE
Dieses Option halt man von der automatischen Erzeugung von
Cat-Seiten ab.
FEHLER
Wenn die oben angefuhrten Regeln nicht genau befolgt werden, werden
sich die Handbuch-Dienstprogramme nicht wie gewunscht verhalten. Die
Regeln sind zu kompliziert.