manpath − określa ścieżkę przeszukiwania stron podręcznika ekranowego
manpath [−qgdc?V] [−m system[,...]] [−C plik]
Jeżeli ustawiona jest zmienna $MANPATH, to manpath po prostu wyświetli jej zawartość i wyśle ostrzeżenie. W przeciwnym razie manpath określi odpowiednią hierarchię ścieżek poszukiwania stron podręcznika man i wyświetli wyniki.
Ścieżka poszukiwań, w postaci listy rozdzielonych dwukropkami katalogów, określana jest przy pomocy informacji pozyskanej z pliku konfiguracyjnego man−db − (/etc/manpath.config) oraz środowiska użytkownika.
−q, −−quiet
Nie wysyła ostrzeżeń.
−d, −−debug
Wyświetla informację diagnostyczną (debug).
−c, −−catpath
Tworzy ścieżkę catpath [do stron w postaci catman] zamiast manpath. Po ustaleniu ścieżki manpath, każdy jej element zamieniany jest na jego odpowiednik catpath.
−g, −−global
Tworzy ścieżkę manpath składającą się ze wszystkich ścieżek wymienionych jako globalne" w pliku konfiguracyjnym man−db.
−m system[,...], −−systems=system[,...]
Jeśli ten system ma dostęp do hierarchii stron man innego systemu operacyjnego, to można wykorzystać tę opcję do włączenia tych hierarchii do wyniku działania manpath. W celu włączenia hierarchii stron podręcznika ekranowego z systemu NewOS, należy użyć opcji −m NewOS.
Podany system może być kombinacją oddzielonych przecinkami nazw systemów operacyjnych. Jeżeli chcemy włączyć hierarchię stron man macierzystego systemu operacyjnego, to musimy użyć man jako nazwy systemu w łańcuchu argumentów. Niniejsza opcja unieważnia ewentualne użycie zmiennej środowiska $SYSTEM.
−C plik, −−config−file=plik
Używa podanego pliku konfiguracyjnego użytkownika zamiast domyślnego ~/.manpath.
−?, −−help
Wyświetla komunikat pomocy i kończy pracę.
−−usage
Wyświetla krótki opis użycia programu i kończy pracę.
−V, −−version
Wyświetla informację o wersji.
MANPATH
Jeżeli ustawiona jest zmienna $MANPATH, to manpath wyświetli jej wartość zamiast określić ją na bieżąco. Jeżeli zmienna $MANPATH zaczyna się od dwukropka, to wartość tej zmiennej jest dodawana do listy pozyskanej z plików konfiguracyjnych. Jeżeli dwukropek umieszczono na końcu wartości tej zmiennej, to ta pozyskana lista ścieżek jest dodawana na koniec zmiennej. Jeżeli wartość tej zmiennej zawiera podwójny dwukropek (::), to pozyskana lista ścieżek jest wstawiana do środka wartości zmiennej, pomiędzy dwukropki.
SYSTEM |
Jeżeli ustawiona jest zmienna $SYSTEM, to ma to taki sam skutek, jak przekazanie jej wartości jako argumentu opcji −m. |
/etc/manpath.config |
Plik konfiguracyjny man−db. |
Wilf. (G DOT Wilford AT ee DOT surrey DOT ac DOT uk).
Fabrizio Polacco (fpolacco AT debian DOT org).
Colin Watson (cjwatson AT debian DOT org).
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.