Provided by:
man-db_2.5.7-4_i386 
NAZWA
manpath - format pliku /etc/manpath.config
OPIS
Plik konfiguracyjny cieek przeszukiwania stron podrcznika stosowany
jest przez narzdzia obsugi stron podrcznika do oszacowania cieek
manpath uytkownikw na bieco, podczas wykonywania programu. Wskazuje,
jakie hierarchie stron man (manpaths) powinny by traktowane jako
globalne oraz przypisuje im katalogi, ktre bd uyte do skadowania plikw
cat.
Jeeli jest ju ustawiona zmienna rodowiska $MANPATH, to informacja
zawarta w /etc/manpath.config nie bdzie jej nadpisywa.
FORMAT
Obecnie rozpoznawane s nastpujce typy pl:
# komentarz
Wiersze puste bd rozpoczynajce si znakiem # zostan uznane za
komentarze i zignorowane.
MANDATORY_MANPATH element_manpath
Wiersze tej postaci wskazuj cieki man, ktre powinna zawiera kada
automatycznie utworzona warto zmiennej $MANPATH. Zwykle obejmuje
to /usr/man.
MANPATH_MAP element_path element_manpath
Wiersze tej postaci ustawiaj odwzorowania $PATH na $MANPATH. Dla
kadego elementu_path znalezionego w ciece $PATH uytkownika do
zmiennej $MANPATH zostanie dodany element_manpath.
MANDB_MAP element_manpath [ element_catpath ]
Wiersze tej postaci wskazuj, ktre cieki man powinny by
traktowane jako systemowe, i opcjonalnie, gdzie powinny by
skadowane ich pliki cat. Ten typ pola jest szczeglnie wany, gdy
man jest programem setuid, gdy (jeeli jest umieszczony w
systemowym pliku konfiguracyjnym /etc/manpath.config, a nie w
pliku konfiguracyjnym uytkownika .manpath) mwi, do ktrych
hierarchii (katalogw) stron man naley siga jako uytkownik
setuid, a do ktrych jako uytkownik wywoujcy program.
Systemowe hierarchie stron man s zwykle skadowane wewntrz
katalogu /usr jak na przykad /usr/man, /usr/local/man czy
/usr/X11R6/man.
Jeli strony cat z danej cieki element_manpath maj nie by
przechowywane albo maj by skadowane w tradycyjnym miejscu, to
element_catpath mona pomin.
Tradycyjne umieszczanie stron "cat" nie jest moliwe dla
hierarchii stron man zamontowanych w trybie tylko do odczytu. Z
tego powodu mona poda dowoln poprawn hierarchi katalogw dla ich
skadowania. W celu przestrzegania linuksowego FSSTND (File
System Standard Group - ustalenia standardu struktury drzewa
katalogw Linuksa) mona posuy si sowem kluczowym `FSSTND' w
miejscu faktycznego katalogu.
Niestety, niezbdne jest podanie wszystkich systemowych cieek
drzew man, cznie ze ciekami kolejnych systemw, jak np.
/usr/man/sun czy te cieki NLS locale, takie jak
/usr/man/de_DE.88591.
Poniewa informacja jest analizowana wiersz po wierszu, w
kolejnoci zapisu, kada cieka manpath bdca podhierarchi innej
hierarchii powinna by podana jako pierwsza. W przeciwnym razie
zostan wykonane niepoprawne dopasowania. Na przykad
/usr/man/de_DE.88591 musi wystpi przed /usr/man.
DEFINE klucz warto
Linie tej postaci definiuj rnorodne zmienne konfiguracyjne -
domylny plik konfiguracyjny zawiera zmienne uywane przez
programy uytkowe przegldarki stron man. Zawieraj one domylne
cieki do rnych programw (takich jak grep i tbl) oraz domylne
argumenty wywoa tych programw.
SECTION sekcja ...
Linie w tej postaci okrelaj porzdek przeszukiwania sekcji
podrcznika ekranowego. Jeeli plik konfiguracyjny nie zawiera
adnej dyrektywy SECTION, to domylny porzdek przeszukiwania
sekcji jest nastpujcy:
SECTION 1 n l 8 3 0 2 5 4 9 6 7
Jeli podano wiele dyrektyw SECTION, podane w nich sekcje bd
poczone.
Jeli pewne rozszerzenie (na przykad 1mh) nie wystpuje w licie
sekcji, to bdzie wywietlane z pozosta czci sekcji, do ktrej
naley. Tak wic nie ma potrzeby wymienia wszystkich sekcji w
pliku konfiguracyjnym, aby wymusi okrelony porzdek
przeszukiwania sekcji. Sekcje z rozszerzeniami bd wystpowa po
gwnej sekcji (np. "1 1mh 8...").
Mona uy sowa SECTIONS jako alternatywnej nazwy tej dyrektywy.
MINCATWIDTH szeroko
Jeeli szeroko terminalu jest mniejsza ni szeroko, to
preformatowane strony podrcznika nie bd ani tworzone (jeli ich
nie ma), ani wywietlane. Domyln wartoci jest 80.
MAXCATWIDTH szeroko
Jeeli szeroko terminalu jest wiksza ni szeroko, to
preformatowane strony podrcznika nie bd ani tworzone (jeli ich
nie ma), ani wywietlane. Domyln wartoci jest 80.
CATWIDTH szeroko
Jeeli szeroko jest wiksza od zera, to zawsze bd tworzone
preformatowane strony podrcznika dla terminalu o podanej
szerokoci, niezalenie od szerokoci obecnie uywanego terminalu.
Warto tego ustawienia powinna by w zakresie od MINCATWIDTH do
MAXCATWIDTH.
NOCACHE
Ta flaga zapobiega automatycznemu tworzeniu preformatowanych
stron "cat" przez man.
BDY
Jeeli nie s cile przestrzegane powysze reguy, to narzdzia przegldania
stron man nie bd dziaa w podany sposb.
TUMACZENIE
Wojciech Kotwica w 1999 roku przetumaczy cz stron podrcznika pakietu
man-db i udostpni je w ramach Projektu Tumaczenia Manuali.
Robert Luberda tumaczenie zaktualizowa i uzupeni w roku 2008.