'\" t
.\" Man page for mandb
.\"
.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MANDB 8 2023-01-08 2.11.2 "Narzędzia przeglądarki stron podręcznika ekranowego"
.SH NAZWA
mandb \- tworzy lub aktualizuje bufory indeksowe stron podręcznika
ekranowego
.SH SKŁADNIA
\fBmandb\fP [\|\fB\-dqsucpt?V\fP\|] [\|\fB\-C\fP \fIplik\fP\|] [\|\fImanpath\fP\|]
.br
\fBmandb\fP [\|\fB\-dqsut\fP\|] [\|\fB\-C\fP \fIplik\fP\|] \fB\-f\fP \fInazwa_pliku\fP\ .\|.\|.
.SH OPIS
\fBmandb\fP is used to initialise or manually update \fBindex\fP database
caches.  The caches contain information relevant to the current state of the
manual page system and the information stored within them is used by the
man\-db utilities to enhance their speed and functionality.

Podczas tworzenia bądź aktualizacji \fBindeksu\fP, \fBmandb\fP ostrzega o złych
żądaniach .so ROFF, niepoprawnych nazwach plików stron podręcznika oraz
stronach, z których nie można utworzyć zapisu dla \fBwhatis\fP.

Wywołanie \fBmandb\fP z opcjonalną ścieżką rozdzielonych dwukropkami
hierarchii katalogów unieważni wewnętrzną globalną ścieżkę przeszukiwań,
określaną na podstawie informacji znalezionej w pliku konfiguracyjnym
man\-db.
.SH "BUFORY BAZY DANYCH"
\fBmandb\fP może zostać skompilowane z obsługą jednego z następujących typów
baz.

.TS
tab (@);
l l l.
Nazwa@Asynchroniczna@Nazwa pliku
_
Berkeley db@Tak@\fIindex.bt\fP
GNU gdbm@Tak@\fIindex.db\fP
UNIX ndbm@Nie@\fIindex.(dir|pag)\fP
.TE

Typy baz danych obsługujące aktualizacje asynchroniczne zapewniają lepszą
szybkość kosztem możliwego uszkodzenia w przypadku nienormalnego przerwania
pracy. W niezbyt częstym przypadku takiego przerwania, może być niezbędne
ponowne uruchomienie \fBmandb\fP z opcją \fB\-c\fP do odbudowania bazy danych od
zera.
.SH OPCJE
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
Wyświetla informację diagnostyczną (debug).
.TP 
.if  !'po4a'hide' .BR \-q ", " \-\-quiet
Nie generuje ostrzeżeń.
.TP 
.if  !'po4a'hide' .BR \-s ", " \-\-no-straycats
Nie traci czasu na poszukiwanie lub dodawanie do bazy informacji dotyczącej
zabłąkanych stron cat. [tłum: stray cats \- również "zabłąkane koty" :)].
.TP 
.if  !'po4a'hide' .BR \-p ", " \-\-no-purge
Nie traci czasu na poszukiwanie usuniętych stron podręcznika i usuwanie ich
z bazy danych.
.TP 
.if  !'po4a'hide' .BR \-c ", " \-\-create
Domyślnie \fBmandb\fP próbuje zaktualizować uprzednio utworzone bazy. Jeśli
baza nie istnieje, to ją utworzy. Niniejsza opcja wymusza na \fBmandb\fP
usunięcie poprzednich baz i utworzenie ich od zera, włącza też automatycznie
opcję \fB\-\-no\-purge.\fP Może to być niezbędne, jeśli baza została uszkodzona
lub jeśli wprowadza się nowy układ przechowywania baz.
.TP 
.if  !'po4a'hide' .BR \-u ", " \-\-user-db
Twórz wyłącznie bazy danych użytkownika, nawet przy prawach zapisu
niezbędnych do utworzenia baz systemowych.
.TP 
.if  !'po4a'hide' .BR \-t ", " \-\-test
Sprawdza poprawność stron podręcznika znajdujących się w ścieżce
poszukiwań. Jeżeli podano tę opcję, to \fBmandb\fP w żaden sposób nie zmieni
istniejącej bazy danych.
.TP 
.if  !'po4a'hide' .BR \-f ", " \-\-filename
Aktualizuje tylko wpisy dotyczące danego pliku. Nie jest to opcja
przeznaczona dla ogółu, jest używana wewnętrznie przez \fBman\fP, jeżeli
został skompilowany z włączoną opcją \fBMAN_DB_UPDATES\fP, a podana strona
podręcznika jest przestarzała. Włącza \fB\-p\fP i deaktywuje \fB\-c\fP i \fB\-s\fP.
.TP 
\fB\-C\ \fP\fIplik\fP,\ \fB\-\-config\-file=\fP\fIplik\fP
Używa podanego pliku konfiguracyjnego użytkownika zamiast domyślnego
\fI~/.manpath\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
Wyświetla komunikaty o zastosowaniu i kończy pracę.
.TP 
.if  !'po4a'hide' .B \-\-usage
Wyświetla krótki opis użycia programu i kończy pracę.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
Wyświetla numer wersji i kończy pracę.
.SH "KOD ZAKOŃCZENIA"
.TP 
.if  !'po4a'hide' .B 0
Program zakończony bez żadnych błędów.
.TP 
.if  !'po4a'hide' .B 1
Błąd użycia, składni lub w pliku konfiguracyjnym.
.TP 
.if  !'po4a'hide' .B 2
Błąd działania.
.TP 
.if  !'po4a'hide' .B 3
Błąd działania procesu potomnego.
.SH DIAGNOSTYKA
Podczas tworzenia bazy danych mogą być wyświetlane następujące ostrzeżenia:
.TP 
\fB<plik>: przetwarzanie whatis strona(sekcja) się nie powiodło\fP
Nie udała się próba uzyskania wiersza(y) whatis z zadanego
<pliku>. Zwykle jest to spowodowane przez kiepsko napisaną stronę
man, ale jeśli wyświetlanych jest wiele takich komunikatów, to
prawdopodobnie system zawiera niestandardowe strony man, niezgodne z
analizatorem składni whatis wbudowanym w man\-db.  Więcej informacji można
znaleźć w sekcji \fBPRZETWARZANIE WHATIS\fP na stronie \fBlexgrog\fP(1).
.TP 
\fB<plik>: jest wiszącym dowiązaniem symbolicznym\fP
<plik> o podanej nazwie nie istnieje, ale jest wskazywany przez
dowiązanie symboliczne (symbolic link). Zwykle generowane jest dodatkowa
informacja diagnostyczna dla identyfikacji <pliku> z błędnego
dowiązania.
.TP 
\fB<plik>: złe dowiązanie symboliczne lub błędne żądanie "so" ROFF\fP
<plik> jest albo dowiązaniem symbolicznym do nieistniejącego pliku,
albo zawiera żądanie włączenia ROFF (include) nieistniejącego pliku.
.TP 
\fB<plik>: ignorowanie niepoprawnej nazwy pliku\fP
<plik> być może być lub nie być poprawną stroną man, ale jego nazwa
jest niepoprawna. Spowodowane zwykle przez stronę man z rozszerzeniem sekcji
<x> umieszczoną w sekcji stron <y>.
.TP 
\fB<maska_pliku>: konkurujące rozszerzenia\fP
Wzorzec nazwy <maska_pliku> nie daje unikatowego wyniku. Zwykle
spowodowane istnieniem zarówno skompresowanej jak i nieskompresowanej wersji
tej samej strony man. Ignorowane są wszystkie oprócz najnowszej.
.SH PLIKI
.TP 
.if  !'po4a'hide' .I /etc/manpath.config
Plik konfiguracyjny man\-db.
.TP 
.if  !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag)
Zgodny z FHS globalny \fIindeks\fP bazy danych.
.PP
Poprzednie lokalizacje bufora bazy danych obejmowały między innymi:
.TP 
.if  !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag)
Tradycyjny globalny \fIindeks\fP bazy danych.
.TP 
.if  !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag)
Alternatywny lub zgodny z FSSTND globalny \fIindeks\fP bazy danych.
.SH "ZOBACZ TAKŻE"
.if  !'po4a'hide' .BR lexgrog (1),
.if  !'po4a'hide' .BR man (1),
.if  !'po4a'hide' .BR manpath (5),
.if  !'po4a'hide' .BR catman (8)
.PP
Sekcja \fBPRZETWARZANIE WHATIS\fP, będąca poprzednio w tej stronie podręcznika,
została przeniesiona do \fBlexgrog\fP(1).
.SH AUTOR
.nf
.if  !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk).
.if  !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi
.SH BŁĘDY
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db
.SH 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.
.br
Robert Luberda tłumaczenie zaktualizował i uzupełnił w roku 2008.
