NAZWA

       catman - tworzy lub aktualizuje preformatowane strony podręcznika ekranowego

SKŁADNIA

       catman [-d?V] [-M ścieżka] [-C plik] [sekcja] ...

OPIS

       catman  służy  do tworzenia i aktualizacji zestawu preformatowanych stron podręcznika znanych jako strony
       cat (cat pages). Wyświetlanie stron "cat" jest na ogół dużo szybsze niż  wyświetlenie  pierwotnych  stron
       man,  jednakże  strony  "cat"  wymagają  dodatkowego miejsca na ich składowanie. Decyzja o obsłudze stron
       "cat" należy do lokalnego administratora, który musi zapewnić odpowiednie katalogi do ich przechowywania.

       Opcje polecenia catman opisują  hierarchie  stron  podręcznika  man  oraz  sekcje,  które  mają  podlegać
       preformatowaniu.  Domyślnymi  hierarchiami  (drzewami  katalogów) są te, które określono jako systemowe w
       pliku konfiguracyjnym man-db. Domyślne sekcje określa  albo  podzielona  dwukropkami  zawartość  zmiennej
       środowiska  $MANSECT,  albo  zestaw standardowy wkompilowany w man, jeżeli $MANSECT jest niezdefiniowana.
       Wywołanie catman z zestawem rozdzielonych białymi  znakami  nazw  sekcji  nadpisuje  powyższe  ustawienia
       domyślne.

       catman  do  ustalenia,  które z plików powinny zostać sformatowane, korzysta z indeksów baz danych (index
       database cache) związanych z każdą z hierarchii.

OPCJE

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

       -M ścieżka, --manpath=ścieżka
              Określa alternatywną, rozdzieloną dwukropkami, ścieżkę przeszukiwań hierarchii  stron  podręcznika
              (manpath).  Domyślnie  są  to  wszystkie  ścieżki  wskazane jako systemowe w pliku konfiguracyjnym
              man-db.

       -C plik, --config-file=plik
              Use this user configuration file rather than the default of ~/.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.

ŚRODOWISKO

       MANSECT
              Jeżeli ustawiona jest $MANSECT, to jej wartość jest listą oddzielonych dwukropkami sekcji i  służy
              do  określania,  które  sekcje  podręcznika man i w jakiej kolejności będą przeszukiwane. Domyślną
              wartością jest "1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am  5  4  9  6  7",  chyba  że  zostanie  to
              nadpisane w polu SECTION pliku /etc/manpath.config.

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

              See the SEARCH PATH section of manpath(5)  for the default  behaviour  and  details  of  how  this
              environment variable is handled.

PLIKI

       /etc/manpath.config
              Plik konfiguracyjny man-db.

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

       /var/catman/index.(bt|db|dir|pag)
              Alternatywny lub zgodny z FSSTND globalny indeks bazy danych.

ZOBACZ TAKŻE

       man(1), manpath(5), mandb(8)

AUTOR

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

BŁĘDY

       https://gitlab.com/man-db/man-db/-/issues
       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.

2.13.1                                             2025-05-02                                          CATMAN(8)