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 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   für   nicht   schreibbar
              eingebundene  Handbuch-Hierarchien  unmöglich.  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.