NAZWA

       whatis - wyświetla jednolinijkowe opisy stron podręcznika systemowego

SKŁADNIA

       whatis [-dlv?V] [-r|-w] [-s lista] [-m system[,...]] [-M ścieżka] [-L ustawienia_językowe]
       [-C plik] nazwa ...

OPIS

       Każda strona podręcznika zawiera krótki opis. whatis przeszukuje nazwy stron podręcznika i
       wyświetla opisy stron pasujących do podanej nazwy.

       nazwa  może  zawierać  znaki  dopasowania (-w) lub być wyrażeniem regularnym (-r). Podczas
       używania tych opcji może być potrzebne umieszczenie nazwy w cudzysłowach lub  poprzedzenie
       zawartych  w  niej  znaków  specjalnych  znakiem  odwrotnego  ukośnika  (\),  aby zapobiec
       interpretowaniu ich przez powłokę.

       Podczas przeszukiwania są używane indeksowane bazy danych, które  są  aktualizowane  przez
       program  mandb,  który  w  zależności  od  instalacji, może być uruchamiany okresowo przez
       program cron lub ręcznie po zainstalowaniu nowych stron podręcznika. Za pomocą  poniższego
       polecenia  można  z  indeksowanej  bazy danych utworzyć przestarzałą, tekstową bazę danych
       whatis:

       whatis -M manpath -w '*' | sort > manpath/whatis

       gdzie manpath jest hierarchią stron podręcznika ekranowego taką jak /usr/man.

OPCJE

       -d, --debug
              Wyświetla informację diagnostyczną (debug).

       -v, --verbose
              Wyświetla szczegółowe ostrzeżenia.

       -r, --regex
              Interpretuje  każdą  nazwę  jako  wyrażenie  regularne.  Jeżeli  nazwa  pasuje   do
              jakiejkolwiek części nazwy strony podręcznika, zostanie dopasowana. Opcja ta trochę
              spowalnia działanie whatis z powodu natury takich wyszukiwań bazy danych.

       -w, --wildcard
              Interpretuje każdą nazwę jako wzorzec  zawierający  globalne  znaki  dopasowania  w
              stylu  powłoki.  Aby  dopasowanie  było poprawne, nazwa musi pasować do całej nazwy
              strony podręcznika. Opcja ta trochę spowalnia  działanie  whatis  z  powodu  natury
              takich wyszukiwań bazy danych.

       -l, --long
              Nie przycina wyjścia do szerokości terminalu. Normalnie, wyjście będzie skrócone do
              szerokości terminalu, aby uniknąć brzydkich  efektów  w  przypadku  źle  napisanych
              sekcji NAZWA.

       -s lista, --sections lista, --section lista
              Przeszukuje  tylko podaną sekcje podręcznika. lista jest rozdzielona średnikami lub
              przecinkami listą sekcji. Jeśli element listy jest sekcją prostą, na przykład  "3",
              to  wyświetlona  lista  opisów będzie zawierać strony w sekcjach "3", "3perl", "3x"
              itd., podczas gdy jeżeli element listy zawiera rozszerzenie, na  przykład  "3perl",
              to lista będzie zawierać tylko i wyłącznie strony w tej sekcji podręcznika.

       -m system[,...], --systems=system[,...]
              Jeśli  ten system ma dostęp do hierarchii stron man innego systemu operacyjnego, to
              ta opcja zapewnia do nich dostęp. W celu włączenia hierarchii stron podręcznika man
              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 nadpisuje wartości ustawione w zmiennej środowiska $SYSTEM.

       -M ścieżka, --manpath=ścieżka
              Określa alternatywny zbiór rozdzielonych dwukropkami hierarchii  stron  podręcznika
              do przeszukiwania. Domyślnie whatis używa wartości zmiennej środowiskowej $MANPATH,
              chyba że jest pusta, co spowoduje, że na  podstawie  wartości  zmiennej  środowiska
              $PATH  określi  odpowiednią  ścieżkę  poszukiwań  man. Opcja ta nadpisuje zawartość
              zmiennej $MANPATH.

       -L ustawienia_językowe, --locale=ustawienia_językowe
              whatis zazwyczaj określa bieżące ustawienia  językowa  przez  wywołanie  systemowej
              funkcji C setlocale(3), która określa je na podstawie różnych zmiennych środowiska,
              takich jak $LC_MESSAGES i $LANG. Aby tymczasowo nadpisać wartości  ustalone   przez
              tę  funkcję, można użyć tej opcji do bezpośredniego przekazania ustawień_językowych
              do programu whatis. Uwaga: będzie  to  miało  wpływ  tylko  na  wyszukiwanie  stron
              podręcznika,  komunikaty  takie  jak informacje o pomocy, zawsze będą wyświetlane w
              języku określonym na początku działania.

       -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.

KOD ZAKOŃCZENIA

       0      Program zakończony bez żadnych błędów.

       1      Błąd użycia, składni lub pliku konfiguracyjnego.

       2      Błąd działania.

       16     Nie znaleziono niczego, co spełniałoby kryteria wyszukiwania.

ŚRODOWISKO

       SYSTEM Jeżeli ustawiona jest zmienna $SYSTEM, to ma to taki sam  skutek,  jak  przekazanie
              jej wartości jako argumentu opcji -m.

       MANPATH
              Jeżeli ustawiona jest $MANPATH, to jej wartość jest interpretowana jako wskazana do
              użycia ścieżka przeszukiwań  hierarchii  stron  man.  Ścieżka  zawiera  rozdzielone
              dwukropkami nazwy hierarchii (katalogów).

       MANWIDTH
              Jeżeli  jest ustawiona $MANWIDTH, to jej wartość określa szerokość terminala (patrz
              opis opcji --long). Jeśli nie  jest  ustawiona,  to  szerokość  terminala  zostanie
              wyliczona  na  podstawie   wartości  zmiennej  $COLUMNS  lub z ioctl(2), jeśli jest
              dostępne, albo zostanie użyta domyślna wartość 80 znaków.

PLIKI

       /usr/share/man/index.(bt|db|dir|pag)
              Tradycyjny globalny indeks bazy danych.

       /var/cache/man/index.(bt|db|dir|pag)
              Zgodny z FHS globalny indeks bazy danych.

       /usr/share/man/.../whatis
              Tradycyjna tekstowa baza danych whatis.

ZOBACZ TAKŻE

       apropos(1), man(1), mandb(8)

AUTOR

       Wilf. (G.Wilford@ee.surrey.ac.uk).
       Fabrizio Polacco (fpolacco@debian.org).
       Colin Watson (cjwatson@debian.org).

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.