man(1)

NAME
man - formatowanie i wyświetlanie dostępnych stron manuala
manpath - wyznaczanie ścieżki poszukiwania stron manuala odpowiedniej dla danego użytkownika

SKŁADNIA
man [-adfhkKtw] [-m system] [-p lańcuch znaków] [-C plik_konfiguracji] [-M ścieżka] [-P pager] [-S lista_sekcji] [sekcja] nazwa ...

OPIS
man formatuje i wyświetla strony manuala dostępne w systemie. Ta wersja sprawdza zmienne środowiskowe MANPATH i (MAN)PAGER, więc możesz mieć Twój własny zestaw (lub zestawy) osobistych stron manuala i wybrać do wyświetlania ulubiony program. Jeżeli zostanie podana sekcja, man sprawdza tylko tą sekcję manuala. Używając opcji lub zmiennych środowiskowych możesz także podać porządek, w jakim należy przeszukiwać sekcje oraz jakie preprocesory powinny zostać użyte do wstępnego przetworzenia stron. Jeżeli nazwa zawiera / wtedy man próbuje najpierw znaleźć podany plik, więc np. możesz man ./foo.5 a nawet man /cd/foo/bar.1.gz.

OPCJE

-C  plik_konfiguracji
    Możesz podać inny man.conf; domyślnie jest to @man_config_file@. (Zobacz man.conf(5).)

-M  ścieżka
    Możesz podać listę katalogów, w których będą szukane strony manuala. Jeżeli taka opcja nie zostanie podana, używana jest zmienna środowiskowa MANPATH formowana przez sprawdzenie @man_config_file@. Pusta MANPATH również oznacza wybranie ścieżki domyślnej.

-P  pager
    Możesz podać jakiego pagera chcesz uzywać. Domyślnie man używa @pager@ Podanie tej opcji powoduje zignorowanie wartosci zmiennej środowiskowej PAGER

-S  lista_sekcji
    Oddzielona dwukropkami lista sekcji manuala, które maja być przeszukane. Jeżeli uzyta jest ta opcja, zmienna środowiskowa MANSECT jest ignorowana.

-a  Zwykle man zakończy działanie po wyświetleniu pierwszej znalezionej strony. Użycie tej opcji powoduje wyświetlenie wszystkich stron manuala, które pasują do nazwy, nie tylko pierwszej.

-c  Przformatuj źródłową stronę manuala, nawet jezeli istnije aktualna storna cat. Może to być istotne, jeżeli strona cat jest sformatowana dla ekranu z inną liczbą kolumn.

-d  Zamiast stron manuala wyświetl mnóstwo informacji o wykonywaniu zadania.

-D  Wyświetl zarówno stronę manuala jak i informację o wykonaniu.

-f  Równoważne whatis.

-h  Wyświetl krótką informację o tym jak używać programu i zakończ pracę.

-k  Równoważny apropos.

-K  Szukaj podanego łańcucha znaków we *wszystkich* stronach manuala. Uwaga: może być bardzo powolne! Podanie sekscji pomaga przyspieszyć szukanie. (Dla ogólnej orientacji: na mojej maszynie zajmuje to ok. minuty dla 500 stron manuala.)

-m  system
    Podanie alternatywnego zestawu stron manuala, odpowiedniego dla podanego systemu.

-p  łańcuch_znaków
    Podanie nazw preprocesorów, ktore zostaną uruchomione przed nroff i troff. Nie wszystkie intalacje mają pełny zestaw preprocesorów. Niektóre z nich i litery używane do ich oznaczenia to: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Podanie tej opcji powoduje zignorowanie zmiennej środowiskowej MANROFFSEQ

-t  Użyj @troff@ dla sformatowania strony manuala, a wynik wyślij do stdout (standardowego wyjścia). Wynik z @troff@ powinien być na ogół przepuszczony przez jakiś filtr przed wydrukowaniem.

-w lub --path
    Nie wyświetlaj stron manuala, podaj tylko gdzie znajdują się pliki, które byłyby sformatowane i wyswietlone. Jeżeli nie są podane argumenty: wyświetla (przed stdout) liste katalogow przeszukiwanych przez man manpath to link do man to "manpath" jest równoważne "man --path".

STRONY CAT
Man będzie próbowal zapisać sformatowane strony manuala aby zaoszczedzić czasu zużywanego na formatowanie nastepnym razem, kiedy te strony będą potrzebne. Tradycyjnie sformatowane wersje stron z katalogu DIR/manX są zapisywane do DIR/catX, ale inne w pliku @man_config_file@ mogą być zapisane również inne zasady. Strony cat nie są zapisywane jeżeli wymagany do tego katalog nie istnieje.

Możliwe jest zmiana uprawnien man-a na suid man. Wtedy katalogi cat
    mają właściciela man i uprawnienia 0755 (zapisywalne tylko przez użytkownika man), a pliki cat mają właściciela man i uprawnienia 0644 lub 0444 (zapisywalne przez man lub przez nikogo). Żaden zwykły użytkownik nie może zmienić stron cat lub wpisać innych plików w te katalogi. Jeżeli man nie ma uprawnien suid to katalog cat powinien mieć uprawnienia 0777, jeżeli wszyscy użytkownicy powinni mieć możliwość pozostawienia tam stron cat.

Opcja -c wymusza przeformatowanie strony nawet jeżeli istnieje już
    strona cat.

ZMIENNE ŚRODOWISKOWE

MANPATH
    Jeżeli MANPATH jest zdefiniowana, wartość jest używana jako ścieżka poszukiwania stron manuala.

MANROFFSEQ
    Jeżeli MANROFFSEQ jest zdefinowana, wartość jest używana do zdefinowania zestawu preprocesorów uruchamianych przed nroff i troff. Domyślnie strony są przepuszczane przez procesor tablic przed użyciem nroff.

MANSECT
    Jeżeli MANSECT jest zdefiniowana, wartość jest używana do podania jakie sekcje manuala powinny zostac przeszukane.

PAGER
    Jeżeli PAGER jest zdefiniowana, wartość jest używana jako nazwa programu do wyświetlania strony manuala. Domyślnie uzywany jest @pager@

LANG
    Jeżeli LANG jest zdefiniowana, wartość jest nazwą podkatalogu, gdzie man szuka stron. Zatem komenda `LANG=dk man 1 foo' (w sh lub bash) spowoduje, że man będzie szukal strony w .../dk/man1/foo.1, a następnie, jeżeli nie będzie mógł znaleźć takiego pliku, w .../man1/foo.1, gdzie ... jest katalogiem ze ścieżki przeszukiwania.

NLSPATH, LC_MESSAGES, LANG
    Zmienne środowiskowe NLSPATH i LC_MESSAGES (lub LANG, jeżeli ta druga nie istnieje) sterują przeszukiwaniem katalogów z komunikatami. (Komunikaty angielskie są wkompilowane, więc dla angielskiego taki katalog nie jest potrzebny.) Zauważ, ze programy takie jak col(1), wołane przez man, również używają np. LC_TYPE.

PATH
    PATH jest używana do zbudowania domyślnej ściezki szukania stron manuala.

SYSTEM
    SYSTEM jest używana dla podania domyślnej alternatywnej nazwy systemu (do używania razem z opcją -m ).

ZOBACZ TEŻ
apropos(1), whatis(1), less(1), groff(1).

BŁĘDY
Opcja -t działa tylko jeżeli jest zainstalowany jakiś program działający jak troff.