MANPATH(5) | /etc/manpath.config | MANPATH(5) |
manpath - format pliku /etc/manpath.config
Plik konfiguracyjny ścieżek przeszukiwania stron podręcznika stosowany jest przez narzędzia obsługi stron podręcznika do oszacowania ścieżek manpath użytkowników na bieżąco, podczas wykonywania programu. Wskazuje, jakie hierarchie stron man (manpaths) powinny być traktowane jako globalne oraz przypisuje im katalogi, które będą użyte do składowania plików cat.
Jeżeli jest już ustawiona zmienna środowiska $MANPATH, to informacja zawarta w /etc/manpath.config nie będzie jej nadpisywać.
Obecnie rozpoznawane są następujące typy pól:
Systemowe hierarchie stron man są zwykle składowane wewnątrz katalogu /usr jak na przykład /usr/man, /usr/local/man czy /usr/X11R6/man.
Jeśli strony cat z danej ścieżki element_manpath mają nie być przechowywane albo mają być składowane w tradycyjnym miejscu, to element_catpath można pominąć.
Tradycyjne umieszczanie stron "cat" nie jest możliwe dla hierarchii stron man zamontowanych w trybie tylko do odczytu. Z tego powodu można podać dowolną poprawną hierarchię katalogów dla ich składowania. W celu przestrzegania linuksowego FSSTND (File System Standard Group - ustalenia standardu struktury drzewa katalogów Linuksa) można posłużyć się słowem kluczowym `FSSTND' w miejscu faktycznego katalogu.
Niestety, niezbędne jest podanie wszystkich systemowych ścieżek drzew man, łącznie ze ścieżkami kolejnych systemów, jak np. /usr/man/sun czy też ścieżki NLS locale, takie jak /usr/man/de_DE.88591.
Ponieważ informacja jest analizowana wiersz po wierszu, w kolejności zapisu, każda ścieżka manpath będąca podhierarchią innej hierarchii powinna być podana jako pierwsza. W przeciwnym razie zostaną wykonane niepoprawne dopasowania. Na przykład /usr/man/de_DE.88591 musi wystąpić przed /usr/man.
SECTION 1 n l 8 3 0 2 5 4 9 6 7
Jeśli podano wiele dyrektyw SECTION, podane w nich sekcje będą połączone.
Jeśli pewne rozszerzenie (na przykład 1mh) nie występuje w liście sekcji, to będzie wyświetlane z pozostałą częścią sekcji, do której należy. Tak więc nie ma potrzeby wymieniać wszystkich sekcji w pliku konfiguracyjnym, aby wymusić określony porządek przeszukiwania sekcji. Sekcje z rozszerzeniami będą występować po głównej sekcji (np. "1 1mh 8...").
Można użyć słowa SECTIONS jako alternatywnej nazwy tej dyrektywy.
Jeżeli nie są ściśle przestrzegane powyższe reguły, to narzędzia przeglądania stron man nie będą działać w pożądany sposób.
Wojciech Kotwica w 1999 roku przetłumaczył
część stron podręcznika pakietu man-db i
udostępnił je w ramach Projektu Tłumaczenia Manuali.
Robert Luberda tłumaczenie zaktualizował i
uzupełnił w roku 2008.
2019-01-05 | 2.8.5 |