MANPATH
NAZWA
OPIS
FORMAT
BÅÄDY
TÅUMACZENIE
NAZWA
manpath − format pliku /etc/man_db.conf
OPIS
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/man_db.conf nie bÄdzie jej nadpisywaÄ.
FORMAT
Obecnie rozpoznawane sÄ nastÄpujÄce typy pól:
# komentarz
Wiersze puste bÄdź rozpoczynajÄce siÄ znakiem # zostanÄ uznane za komentarze i zignorowane.
MANDATORY_MANPATH element_manpath
Wiersze tej postaci wskazujÄ Åcieżki man, które powinna zawieraÄ każda 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 każdego elementu_path znalezionego w Åcieżce $PATH użytkownika do zmiennej $MANPATH zostanie dodany element_manpath.
MANDB_MAP element_manpath [ element_catpath ]
Wiersze tej postaci wskazujÄ, które Åcieżki man powinny byÄ traktowane jako systemowe, i opcjonalnie, gdzie powinny byÄ skÅadowane ich pliki cat. Ten typ pola jest szczególnie ważny, gdy man jest programem setuid, gdyż (jeżeli jest umieszczony w systemowym pliku konfiguracyjnym /etc/man_db.conf, a nie w pliku konfiguracyjnym użytkownika .manpath) mówi, do których hierarchii (katalogów) stron man należy siÄgaÄ jako użytkownik setuid, a do których jako użytkownik wywoÅujÄcy program.
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ÄÄ.
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, 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.
DEFINE klucz wartoÅÄ
Linie tej postaci definiujÄ różnorodne zmienne konfiguracyjne − domyÅlny plik konfiguracyjny zawiera zmienne używane przez programy użytkowe przeglÄdarki stron man. ZawierajÄ one domyÅlne Åcieżki do różnych programów (takich jak grep i tbl) oraz domyÅlne argumenty wywoÅaÅ tych programów.
SECTION sekcja …
Linie w tej postaci okreÅlajÄ porzÄdek przeszukiwania sekcji podrÄcznika ekranowego. Jeżeli plik konfiguracyjny nie zawiera żadnej dyrektywy SECTION, to domyÅlny porzÄdek przeszukiwania sekcji jest nastÄpujÄcy:
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.
MINCATWIDTH szerokoÅÄ
Jeżeli szerokoÅÄ terminalu jest mniejsza niż szerokoÅÄ, to preformatowane strony podrÄcznika nie bÄdÄ ani tworzone (jeÅli ich nie ma), ani wyÅwietlane. DomyÅlnÄ wartoÅciÄ jest 80.
MAXCATWIDTH szerokoÅÄ
Jeżeli szerokoÅÄ terminalu jest wiÄksza niż szerokoÅÄ, to preformatowane strony podrÄcznika nie bÄdÄ ani tworzone (jeÅli ich nie ma), ani wyÅwietlane. DomyÅlnÄ wartoÅciÄ jest 80.
CATWIDTH szerokoÅÄ
Jeżeli szerokoÅÄ jest wiÄksza od zera, to zawsze bÄdÄ tworzone preformatowane strony podrÄcznika dla terminalu o podanej szerokoÅci, niezależnie od szerokoÅci obecnie używanego terminalu. WartoÅÄ tego ustawienia powinna byÄ w zakresie od MINCATWIDTH do MAXCATWIDTH.
NOCACHE
Ta flaga zapobiega automatycznemu tworzeniu preformatowanych stron “cat” przez man.
BÅÄDY
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.
https://savannah.nongnu.org/bugs/?group=man-db
TÅUMACZENIE
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.