Provided by:
man-db_2.6.0.2-2_i386 
NAZWA
manpath - format pliku /etc/manpath.config
OPIS
Plik konfiguracyjny cieek przeszukiwania stron podrcznika stosowany
jest przez narzdzia obslugi stron podrcznika do oszacowania cieek
manpath uytkownikow na bieco, podczas wykonywania programu. Wskazuje,
jakie hierarchie stron man (manpaths) powinny by traktowane jako
globalne oraz przypisuje im katalogi, ktore bd uyte do skladowania
plikow 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 pol:
# komentarz
Wiersze puste bd rozpoczynajce si znakiem # zostan uznane za
komentarze i zignorowane.
MANDATORY_MANPATH element_manpath
Wiersze tej postaci wskazuj cieki man, ktore 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, ktore cieki man powinny by
traktowane jako systemowe, i opcjonalnie, gdzie powinny by
skladowane ich pliki cat. Ten typ pola jest szczegolnie wany,
gdy man jest programem setuid, gdy (jeeli jest umieszczony w
systemowym pliku konfiguracyjnym /etc/manpath.config, a nie w
pliku konfiguracyjnym uytkownika .manpath) mowi, do ktorych
hierarchii (katalogow) stron man naley siga jako uytkownik
setuid, a do ktorych jako uytkownik wywolujcy program.
Systemowe hierarchie stron man s zwykle skladowane wewntrz
katalogu /usr jak na przyklad /usr/man, /usr/local/man czy
/usr/X11R6/man.
Jeli strony cat z danej cieki element_manpath maj nie by
przechowywane albo maj by skladowane 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 katalogow dla ich
skladowania. W celu przestrzegania linuksowego FSSTND (File
System Standard Group - ustalenia standardu struktury drzewa
katalogow Linuksa) mona posluy si slowem kluczowym `FSSTND' w
miejscu faktycznego katalogu.
Niestety, niezbdne jest podanie wszystkich systemowych cieek
drzew man, lcznie ze ciekami kolejnych systemow, 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 przyklad
/usr/man/de_DE.88591 musi wystpi przed /usr/man.
DEFINE klucz warto
Linie tej postaci definiuj ronorodne zmienne konfiguracyjne -
domylny plik konfiguracyjny zawiera zmienne uywane przez
programy uytkowe przegldarki stron man. Zawieraj one domylne
cieki do ronych programow (takich jak grep i tbl) oraz domylne
argumenty wywola tych programow.
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
polczone.
Jeli pewne rozszerzenie (na przyklad 1mh) nie wystpuje w licie
sekcji, to bdzie wywietlane z pozostal czci sekcji, do ktorej
naley. Tak wic nie ma potrzeby wymienia wszystkich sekcji w
pliku konfiguracyjnym, aby wymusi okrelony porzdek
przeszukiwania sekcji. Sekcje z rozszerzeniami bd wystpowa po
glownej sekcji (np. "1 1mh 8...").
Mona uy slowa 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.
B/LDY
Jeeli nie s cile przestrzegane powysze reguly, to narzdzia przegldania
stron man nie bd dziala w podany sposob.
T/LUMACZENIE
Wojciech Kotwica w 1999 roku przetlumaczyl cz stron podrcznika pakietu
man-db i udostpnil je w ramach Projektu Tlumaczenia Manuali.
Robert Luberda tlumaczenie zaktualizowal i uzupelnil w roku 2008.