MANPATH(5) /etc/man_db.conf MANPATH(5) NAZWA manpath - format pliku /etc/man_db.conf OPIS Plik konfiguracyjny sciezek przeszukiwania stron podrecznika stosowany jest przez narzedzia obslugi stron podrecznika do oszacowania sciezek manpath uzytkownikow na biezaco, podczas wykonywania programu. Wskazuje, jakie hierarchie stron man (manpaths) powinny byc traktowane jako globalne oraz przypisuje im katalogi, ktore beda uzyte do skladowania plikow cat. Jezeli jest juz ustawiona zmienna srodowiska $MANPATH, to informacja zawarta w /etc/man_db.conf nie bedzie jej nadpisywac. SEARCH PATH By default, man-db examines the user's $PATH. For each path_element found there, it adds manpath_element to the search path. If there is no MANPATH_MAP line in the configuration file for a given path_element, then it adds all of path_element/../man, path_element/man, path_element/../share/man, and path_element/share/man that exist as directories to the search path. It then adds any MANDATORY_MANPATH entries from the configuration file to the search path. Finally, if the --systems option is used or the $SYSTEM environment variable is set, then that should consist of a sequence of operating system names separated by commas or colons. This acts as a template, expanding the search path once more to allow access to other operating systems' manual pages: for each system name, man-db looks for that name as a subdirectory of each entry in the search path, and adds it to the final search path if it exists. A system name of man inserts the normal search path without subdirectories. For example, if the search path would otherwise have been /usr/share/man:/usr/local/man, and $SYSTEM is set to newOS:man, then the final search path will be /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man. The $MANPATH environment variable overrides man-db's default manual page search paths. Most users should not need to set it. Its syntax is similar to the $PATH environment variable: it consists of a sequence of directory names separated by colons. It overrides the default search path described above. If the value of $MANPATH starts with a colon, then the default search path is added at its start. If the value of $MANPATH ends with a colon, then the default search path is added at its end. If the value of $MANPATH contains a double colon (::), then the default search path is inserted in the middle of the value, between the two colons. FORMAT Obecnie rozpoznawane sa nastepujace typy pol: # komentarz Wiersze puste badz rozpoczynajace sie znakiem # zostana uznane za komentarze i zignorowane. MANDATORY_MANPATH element_manpath Wiersze tej postaci wskazuja sciezki man, ktore powinna zawierac kazda automatycznie utworzona wartosc zmiennej $MANPATH. Zwykle obejmuje to /usr/man. MANPATH_MAP element_path element_manpath Wiersze tej postaci ustawiaja odwzorowania $PATH na $MANPATH. Dla kazdego elementu_path znalezionego w sciezce $PATH uzytkownika do zmiennej $MANPATH zostanie dodany element_manpath. MANDB_MAP element_manpath [ element_catpath ] Wiersze tej postaci wskazuja, ktore sciezki man powinny byc traktowane jako systemowe, i opcjonalnie, gdzie powinny byc skladowane ich pliki cat. Ten typ pola jest szczegolnie wazny, gdy man jest programem setuid, gdyz (jezeli jest umieszczony w systemowym pliku konfiguracyjnym /etc/man_db.conf, a nie w pliku konfiguracyjnym uzytkownika .manpath) mowi, do ktorych hierarchii (katalogow) stron man nalezy siegac jako uzytkownik setuid, a do ktorych jako uzytkownik wywolujacy program. Systemowe hierarchie stron man sa zwykle skladowane wewnatrz katalogu /usr jak na przyklad /usr/man, /usr/local/man czy /usr/X11R6/man. Jesli strony cat z danej sciezki element_manpath maja nie byc przechowywane albo maja byc skladowane w tradycyjnym miejscu, to element_catpath mozna pominac. Traditional cat placement would be impossible for read only mounted manual page hierarchies and because of this it is possible to specify any valid directory hierarchy for their storage. To observe the Linux FSSTND the keyword FSSTND can be used in place of an actual directory. Niestety, niezbedne jest podanie wszystkich systemowych sciezek drzew man, lacznie ze sciezkami kolejnych systemow, jak np. /usr/man/sun czy tez sciezki NLS locale, takie jak /usr/man/de_DE.88591. Poniewaz informacja jest analizowana wiersz po wierszu, w kolejnosci zapisu, kazda sciezka manpath bedaca podhierarchia innej hierarchii powinna byc podana jako pierwsza. W przeciwnym razie zostana wykonane niepoprawne dopasowania. Na przyklad /usr/man/de_DE.88591 musi wystapic przed /usr/man. DEFINE klucz wartosc Linie tej postaci definiuja roznorodne zmienne konfiguracyjne - domyslny plik konfiguracyjny zawiera zmienne uzywane przez programy uzytkowe przegladarki stron man. Zawieraja one domyslne sciezki do roznych programow (takich jak grep i tbl) oraz domyslne argumenty wywolan tych programow. SECTION sekcja ... Linie w tej postaci okreslaja porzadek przeszukiwania sekcji podrecznika ekranowego. Jezeli plik konfiguracyjny nie zawiera zadnej dyrektywy SECTION, to domyslny porzadek przeszukiwania sekcji jest nastepujacy: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Jesli podano wiele dyrektyw SECTION, podane w nich sekcje beda polaczone. Jesli pewne rozszerzenie (na przyklad 1mh) nie wystepuje w liscie sekcji, to bedzie wyswietlane z pozostala czescia sekcji, do ktorej nalezy. Tak wiec nie ma potrzeby wymieniac wszystkich sekcji w pliku konfiguracyjnym, aby wymusic okreslony porzadek przeszukiwania sekcji. Sekcje z rozszerzeniami beda wystepowac po glownej sekcji (np. "1 1mh 8..."). Mozna uzyc slowa SECTIONS jako alternatywnej nazwy tej dyrektywy. MINCATWIDTH szerokosc Jezeli szerokosc terminalu jest mniejsza niz szerokosc, to preformatowane strony podrecznika nie beda ani tworzone (jesli ich nie ma), ani wyswietlane. Domyslna wartoscia jest 80. MAXCATWIDTH szerokosc Jezeli szerokosc terminalu jest wieksza niz szerokosc, to preformatowane strony podrecznika nie beda ani tworzone (jesli ich nie ma), ani wyswietlane. Domyslna wartoscia jest 80. CATWIDTH szerokosc If width is non-zero, cat pages will always be formatted for a terminal of the given width, regardless of the width of the terminal actually being used. This overrides MINCATWIDTH and MAXCATWIDTH. NOCACHE Ta flaga zapobiega automatycznemu tworzeniu preformatowanych stron "cat" przez man. BLEDY Jezeli nie sa scisle przestrzegane powyzsze reguly, to narzedzia przegladania stron man nie beda dzialac w pozadany sposob. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db TLUMACZENIE Wojciech Kotwica w 1999 roku przetlumaczyl czesc stron podrecznika pakietu man-db i udostepnil je w ramach Projektu Tlumaczenia Manuali. Robert Luberda tlumaczenie zaktualizowal i uzupelnil w roku 2008. 2.12.1 2024-04-05 MANPATH(5)