.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "INSTALL-DOCS 8"
.TH INSTALL-DOCS 8 "24 August, 2014" "doc-base v0.10.6" "Debian"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAZWA"
.IX Header "NAZWA"
install-docs \- zarządzanie dokumentacją Debiana
.SH "SKŁADNIA"
.IX Header "SKŁADNIA"
.Vb 1
\& install\-docs [opcje] \-i,\-\-install | \-r,\-\-remove | \-c,\-\-check plik [ plik ... ]
\&
\& install\-docs [opcje] \-I,\-\-install\-all | \-C,\-\-install\-changed | \-R,\-\-remove\-all
\&
\& install\-docs [opcje] \-s,\-\-status docid [ docid ... ]
\&
\& install\-docs [opcje] \-\-dump\-db nazwa_db
\&
\& install\-docs \-h,\-\-help | \-V,\-\-version
.Ve
.SH "OPIS"
.IX Header "OPIS"
\&\fBinstall-docs\fR jest narzędziem pozwalającym opiekunom pakietów Debiana na
rejestrowanie dokumentacji w różnych systemach. Obecnie wspiera przeglądarki
\&\fBdhelp\fR, \fBdwww\fR, \fBdoc-central\fR oraz \fBscrollkeeper\fR.
.PP
Ta strona podręcznika ekranowego zawiera podstawowe wskazówki dotyczące
używania \fBinstall-docs\fR. Pełny opis programu wraz z opisem składni składni
pliku konfiguracyjnego można znaleźć w dokumentacji dołączonej do pakietu.
.SH "OPCJE"
.IX Header "OPCJE"
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Tryb gadatliwy.
.IP "\fB\-d\fR, \fB\-\-debug\fR" 4
.IX Item "-d, --debug"
Wyświetla komunikaty diagnostyczne.
.IP "\fB\-\-no\-update\-menus\fR" 4
.IX Item "--no-update-menus"
Nie uruchamia \fIdwww\-build\-menu\fR\|(8), \fIdhelp_parse\fR\|(8), ani
\&\fIscrollkeeper\-update\fR\|(8).
.IP "\fB\-\-rootdir\fR \fIkatalog\fR" 4
.IX Item "--rootdir katalog"
Ustawia główny katalog na \fIkatlaog\fR, zamiast używać `\fI/\fR'. Użyteczne i
poprawne tylko w przypadku akcji \fB\-\-check\fR.
.SH "AKCJE"
.IX Header "AKCJE"
Poniżej podano listę akcji obsługiwanych przez \fBinstall-docs\fR. Programowi
można podać tylko jedną akcję. Ponadto akcja ta łącznie z jej argumentami
musi być przekazana jako ostatnia opcja linii poleceń.
.PP
Każdy argument \fIplik\fR powinien być pełną ścieżką do pliku kontrolnego
doc\-base(t.j. \*(L"/usr/share/doc\-base/jakiś_plik\*(R" lub
\&\*(L"/etc/doc\-base/documents/jakiś_plik\*(R"), a każde \fIdocid\fR powinno być
identyfikatorem dokumentu (Identyfikatory dokumentów  są ustawiane w polu
\&\*(L"Document\*(R" pliku kontrolnego i zazwyczaj są takie same jak nazwa pakietu).
.PP
Jeżeli \fIplik\fR lub <docid> jest równe "\fB\-\fR" (znak minusa), to lista
argumentów jest odczytywana ze standardowego wejścia (każda nazwa pliku lub
każde id dokumentu w oddzielnej linii).
.IP "\fB\-i\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-install\fR \fIplik\fR [\fIplik\fR ...]" 4
.IX Item "-i plik [plik ...], --install plik [plik ...]"
Instaluje dokumentację wymienioną w pliku kontrolnym \fIplik\fR.
.IP "\fB\-r\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-remove\fR \fIplik\fR [\fIplik\fR ...]" 4
.IX Item "-r plik [plik ...], --remove plik [plik ...]"
Wyrejestrowuje dokumentację wymienioną w pliku kontrolnym \fIplik\fR.
.IP "\fB\-c\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-check\fR \fIplik\fR [\fIplik\fR ...]" 4
.IX Item "-c plik [plik ...], --check plik [plik ...]"
Sprawdza poprawność pliku kontrolnego \fIplik\fR i wyświetla listę znalezionych
problemów. Użyta z opcją \fI\-\-verbose\fR podaje lokalizacje błędów i
ostrzeżeń. Jeśli podano także \fI\-\-rootdir\fR, to argument tej opcji zostanie
dołączony do nazw plików wymienionych w polach \*(L"Files\*(R" i \*(L"Index\*(R" \fIplik\fRu.
.IP "\fB\-R\fR, \fB\-\-remove\-all\fR" 4
.IX Item "-R, --remove-all"
Wyrejestrowuje wszystkie zarejestrowane dokumenty.
.IP "\fB\-I\fR, \fB\-\-install\-all\fR" 4
.IX Item "-I, --install-all"
(Ponownie) rejestruje wszystkie dokumenty z katalogów \fI/usr/share/doc\-base\fR
i \fI/etc/doc\-base/documents\fR.
.IP "\fB\-C\fR, \fB\-\-install\-changed\fR" 4
.IX Item "-C, --install-changed"
Porównuje zawartość katalogów  \fI/usr/share/doc\-base\fR i
\&\fI/etc/doc\-base/documents\fR z bazą danych zarejestrowanych dokumentów i
wyrejestrowuje usunięte pliki oraz (ponownie) rejestruje pliki zmienione lub
dodane.
.IP "\fB\-s\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-status\fR \fIdocid\fR [\fIdocid\fR ...]" 4
.IX Item "-s docid [docid ...], --status docid [docid ...]"
Wyświetla stan dokumentu określonego przez \fIdocid\fR.
.IP "\fB\-L\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-listfiles\fR \fIdocid\fR [\fIdocid\fR ...]" 4
.IX Item "-L docid [docid ...], --listfiles docid [docid ...]"
Opcja przestarzała. Nie robi nic.
.IP "\fB\-\-dump\-db\fR \fInazwa_db\fR" 4
.IX Item "--dump-db nazwa_db"
Wypisuje \- w celu debugowania programu \- zawartość wewnętrznych baz
danych. \fInazwa_db\fR może być albo \fBfiles.db\fR, albo \fBstatus.db\fR.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Wyświetla krótki komunikat pomocy.
.IP "\fB\-V\fR, \fB\-\-version\fR" 4
.IX Item "-V, --version"
Wyświetla informacje o wersji programu.
.SH "KOMPATYBILNOŚĆ Z POPRZEDNIMI WERSJAMI"
.IX Header "KOMPATYBILNOŚĆ Z POPRZEDNIMI WERSJAMI"
Następujące właściwości zostały dodane w wersji 0.8.4 programu, opiekunowie
pakietów powinni dodać odpowiednie linie "\fIConflicts\fR\*(L" lub \*(R"\fIDepends\fR",
jeśli planują ich używać w skryptach pakietów:
.IP "\(bu" 4
obsługa wielu argumentów akcji \fB\-i\fR oraz \fB\-r\fR,
.IP "\(bu" 4
czytanie argumentów ze standardowego wejścia,
.IP "\(bu" 4
akcje \fB\-I\fR, \fB\-\-install\-all\fR, \fB\-R\fR, \fB\-\-\-remove\-all\fR, \fB\-c\fR, \fB\-\-check\fR,
.IP "\(bu" 4
opcje \fB\-d\fR, \fB\-\-debug\fR, \fB\-h\fR, \fB\-\-help\fR.
.PP
Opcje \fB\-C\fR, \fB\-\-install\-changed\fR, \fB\-\-dump\-db\fR, \fB\-V\fR, \fB\-\-version\fR zostały
dodane w wersji 0.8.12.
.SH "PLIKI"
.IX Header "PLIKI"
.IP "\fI/usr/share/doc\-base/\fR" 4
.IX Item "/usr/share/doc-base/"
Lokalizacja plików kontrolnych doc-base dostarczanych przez pakiety.
.IP "\fI/etc/doc\-base/documents/\fR" 4
.IX Item "/etc/doc-base/documents/"
Lokalizacja plików kontrolnych doc-base dostarczanych przez lokalnego
administratora.
.IP "\fI/var/lib/doc\-base/info/documents/\fR" 4
.IX Item "/var/lib/doc-base/info/documents/"
Lokalizacja zarejestrowanych plików kontrolnych.
.IP "\fI/var/lib/doc\-base/info/status.db\fR" 4
.IX Item "/var/lib/doc-base/info/status.db"
Stany zarejestrowanych dokumentów.
.IP "\fI/var/lib/doc\-base/info/files.db\fR" 4
.IX Item "/var/lib/doc-base/info/files.db"
Znaczniku czasowe i identyfikatory zarejestrowanych plików doc-base.
.IP "\fI/var/lib/doc\-base/omf/\fR" 4
.IX Item "/var/lib/doc-base/omf/"
Lokalizacja wygenerowanych plików \s-1OMF\s0 scrollkeepera. Uwaga:
\&\fI/usr/share/omf/doc\-base\fR powinien być dowiązaniem symbolicznym wskazującym
na ten katalog.
.SH "BŁĘDY"
.IX Header "BŁĘDY"
Patrz <http://bugs.debian.org/doc\-base>.
.SH "ZOBACZ TAKŻE"
.IX Header "ZOBACZ TAKŻE"
\&\fIdhelp\fR\|(1), \fIdoccentral\fR\|(1), \fIdwww\fR\|(7), \fIscrollkeeper\fR\|(7), Podręcznik doc-base
\&\fI/usr/share/doc/doc\-base/doc\-base.html/index.html\fR
.SH "AUTOR"
.IX Header "AUTOR"
Program napisał  Christian Schwarz <schwarz@debian.org> dla systemu Debian
GNU/Linux; kolejnym opiekunem był Adam Di Carlo <aph@debian.org>. Robert
Luberda <robert@debian.org> zajmuje się nim obecnie i go rozszerza o nowe
funkcjonalności.
.PP
Ten program został napisany dla pożytku całej społeczności użytkowników i
opiekunów Debiana. Aby zaangażować się w rozwój programu, prosimy dołączyć
do listy dyskusyjnej <debian\-doc@lists.debian.org>.
