.\" dpkg manual page - dpkg-source(1)
.\"
.\" Copyright ÂŠ 1995-1996 Ian Jackson <ian@chiark.chu.cam.ac.uk>
.\" Copyright ÂŠ 2000 Wichert Akkerman <wakkerma@debian.org>
.\" Copyright ÂŠ 2006-2007 Frank Lichtenheld <djpig@debian.org>
.\" Copyright ÂŠ 2006-2013 Guillem Jover <guillem@debian.org>
.\" Copyright ÂŠ 2008-2011 RaphaĂŤl Hertzog <hertzog@debian.org>
.\" Copyright ÂŠ 2010 Joey Hess <joeyh@debian.org>
.\"
.\" This is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-source 1 2013\-12\-05 "Projekt Debian" "programy pomocnicze dpkg"
.SH NAZWA
dpkg\-source \- narzędzia do zarządzania źródłowymi pakietami Debiana (.dsc)
.
.SH SKŁADNIA
\fBdpkg\-source\fP [\fIopcja\fP...] \fIpolecenie\fP
.
.SH OPIS
\fBdpkg\-source\fP tworzy i rozpakowuje źródłowe archiwa (pakiety) Debiana.

Żadne z tych poleceń nie pozwala na łączenie wielu opcji w jedną, nie
pozwalają również na podawanie wartości opcji jako oddzielnego parametru.
.
.SH POLECENIA
.TP 
\fB\-x \fP\fInazwa\-pliku\fP\fB.dsc \fP[\fIkatalog\-wyjściowy\fP]
Rozpakowanie pakietu źródłowego. Wymagane jest podanie jednego argumentu nie
będącego opcją, nazwy pliku kontrolny pakietu źródłowego (\fB.dsc\fP). Ponadto
może być podany drugi opcjonalny argument niebędący opcją, określający
katalog, do którego pakiet źródłowy ma zostać rozpakowany (katalog ten nie
może istnieć). Jeśli nie podano katalogu wyjściowego, pakiet źródłowy jest
rozpakowywany do katalogu o nazwie \fIźródło\fP\-\fIwersja\fP w ramach bieżącego
katalogu roboczego.

\fBdpkg\-source\fP odczyta nazwy innych plików tworzących pakiet źródłowy z
pliku kontrolnego; zakładane jest, że są one w tym samym katalogu co
\&\fB.dsc\fP.

Pliki w rozpakowanym pakiecie będą mieć uprawnienia i właściciela zgodnie z
typowymi, oczekiwanymi wartościami jak przy zwykłym tworzeniu plików i
katalogów \- katalogi i pliki wykonywalne będą mieć prawa 0777, zaś zwykłe
pliki będą mieć prawa 0666 (w obu przypadkach modyfikowane przez umask
rozpakowującego). Ponadto jeśli katalog nadrzędny ma ustawiony bit setgid,
rozpakowane katalogi także będą go mieć, zaś wszystkie pliki i katalogi
przejmą ustawienia grupy katalogu nadrzędnego.

Jeśli pakiet źródłowy używa niestandardowego formatu (aktualnie oznacza to
wszystkie formaty poza "1.0"), jego nazwa będzie umieszczona w pliku
\fBdebian/source/format\fP. Dzięki temu przy następnych budowach pakietu
źródłowego będzie domyślnie używany ten sam format.

.TP 
\fB\-b\fP, \fIkatalog\fP [\fIparametry\-zależne\-od\-formatu\fP]
Budowanie pakietu źródłowego. Pierwszy argument nie będący opcją przyjmowany
jest jako nazwa katalogu zdebianizowanego drzewa ze źródłami (czyli
zawierającego podkatalog "debian" i być może zmiany w stosunku do
oryginalnych plików). Zależnie od formatu pakietu źródłowego używanego przy
budowaniu pakietu, mogą być również akceptowane dodatkowe parametry.

\fBdpkg\-source\fP będzie budować pakiet źródłowy z użyciem pierwszego
znalezionego formatu z następującej listy, w kolejności: format(y)
określony(e) za pomocą opcji \fI\-\-format\fP, format określony w pliku
\fBdebian/source/format\fP, "1.0". Powrót do "1.0" jest uważany za przestarzały
i kiedyś zostanie usunięty, dlatego należy zawsze dokumentować żądany format
źródła w pliku \fBdebian/source/format\fP. W sekcji \fBFORMATY PAKIETÓW
ŹRÓDŁOWYCH\fP można znaleźć wyczerpujący opis różnych formatów pakietów
źródłowych.

.TP 
\fB\-\-print\-format\fP \fIkatalog\fP
Wyświetla format źródłowy, który będzie użyty do zbudowania pakietu
źródłowego, jeśli zostanie wywołane \fBdpkg\-source \-b \fP\fIkatalog\fP (z tymi
samymi warunkami i parametrami).

.TP 
\fB\-\-before\-build\fP \fIkatalog\fP
Uruchamia odpowiedni zaczep formatu pakietu źródłowego. Zaczep jest
wywoływany przed pierwszym zbudowaniem pakietu (\fBdpkg\-buildpackage\fP
wywołuje go bardzo wcześnie, nawet przed \fBdebian/rules clean\fP). Polecenie
to jest idempotentne i może być wywołane wielokrotnie. Nie wszystkie formaty
źródłowe zaimplementowały coś w tym zaczepie, a te które to zrobiły,
wykorzystują je z reguły do przygotowania drzewa źródeł do budowania
upewniając się na przykład, że zaaplikowano łatki Debiana.

.TP 
\fB\-\-after\-build\fP \fIkatalog\fP
Uruchamia odpowiedni zaczep formatu pakietu źródłowego. Zaczep jest
wywoływany po ostatnim zbudowaniu pakietu (\fBdpkg\-buildpackage\fP wywołuje go
jako ostatni). Polecenie to jest idempotentne i może być wywołane
wielokrotnie. Nie wszystkie formaty źródłowe zaimplementowały coś w tym
zaczepie, a te które to zrobiły, wykorzystują je z reguły do cofnięcia tego,
co zostało wykonane podczas \fB\-\-before\-build\fP.

.TP 
\fB\-\-commit\fP [\fIkatalog\fP] ...
Zapisuje zmiany w drzewie źródłowym rozpakowanym w \fIkatalogu\fP. Polecenie to
może przyjąć argumenty uzupełniające, w zależności od formatu źródeł. Zwróci
błąd, w przypadku formatów, w których ta operacja nic nie znaczy.

.TP 
\fB\-?\fP, \fB\-\-help\fP
Wyświetla informację o użytkowaniu i kończy działanie.
.TP 
\fB\-\-version\fP
Wyświetla informację o wersji i pomyślnie kończy działanie.
.
.SH OPCJE
.SS "Generic build options"
.TP 
\fB\-c\fP\fIplik\-kontrolny\fP
Określa główny plik kontrolny źródeł, z którego będą czytane
informacje. Domyślnie jest to \fBdebian/control\fP. Jeśli podano względną
ścieżkę, to jest ona interpretowana od najwyższego poziomu katalogu drzewa
ze źródłami.
.TP 
\fB\-l\fP\fIplik\-dziennika\-zmian\fP
Określa dziennik zmian, z którego będą czytane informacje. Domyślnie jest to
\fBdebian/changelog\fP. Jeśli podano względną ścieżkę, to jest ona
interpretowana od najwyższego poziomu katalogu drzewa ze źródłami.
.TP 
\fB\-F\fP\fIformat\-dziennika\-zmian\fP
Określa format dziennika zmian. Więcej informacji o alternatywnych formatach
można znaleźć w \fBdpkg\-parsechangelog\fP(1).
.TP 
\fB\-\-format=\fP\fIwartość\fP
Do budowy pakietu źródłowego używany jest podany format. Nadpisuje to każdy
format podany w pliku \fBdebian/source/format\fP.
.TP 
\fB\-V\fP\fInazwa\fP\fB=\fP\fIwartość\fP
Ustawia zmienną podstawienia wyjścia. Szczegółowy opis podstawiania
zmiennych wyjściowych znajduje się w \fBdeb\-substvars\fP(5).
.TP 
\fB\-T\fP\fIplik\-zmiennych\-podst\fP
Odczytuje zmienne podstawiania z \fIpliku\-zmiennych\-podst\fP; domyślnie nie
czyta żadnego pliku. Opcja może być użyta wielokrotnie, aby odczytać
podstawiania z wielu plików.
.TP 
\fB\-D\fP\fIpole\fP\fB=\fP\fIwartość\fP
Nadpisuje lub dodaje wyjściowe pole pliku kontrolnego.
.TP 
\fB\-U\fP\fIpole\fP
Usuwa wyjściowe pole pliku kontrolnego.
.TP 
\fB\-Z\fP\fIkompresja\fP, \fB\-\-compression\fP=\fIkompresja\fP
Specify the compression to use for created files (tarballs and diffs).  Note
that this option will not cause existing tarballs to be recompressed, it
only affects new files. Supported values are: \fIgzip\fP, \fIbzip2\fP, \fIlzma\fP and
\fIxz\fP.  \fIgzip\fP is the default. \fIxz\fP is only supported since dpkg 1.15.5.
.TP 
\fB\-z\fP\fIpoziom\fP, \fB\-\-compression\-level\fP=\fIpoziom\fP
Używany poziom kompresowania. Podobnie jak w wypadku \fB\-Z\fP, dotyczy tylko
nowo tworzonych plików. Obsługiwane wartości: \fI1\fP do \fI9\fP, \fIbest\fP oraz
\fIfast\fP. \fI9\fP jest wartością domyślną w przypadku gzip i bzip2, \fI6\fP w
przypadku xz i lzma.
.TP 
\fB\-i\fP[\fIregex\fP], \fB\-\-diff\-ignore\fP[=\fIregex\fP]
You may specify a perl regular expression to match files you want filtered
out of the list of files for the diff. (This list is generated by a find
command.) (If the source package is being built as a version 3 source
package using a VCS, this can be used to ignore uncommited changes on
specific files. Using \-i.* will ignore all of them.)

The \fB\-i\fP option by itself enables this setting with a default regex
(preserving any modification to the default regex done by a previous use of
\fB\-\-extend\-diff\-ignore\fP) that will filter out control files and directories
of the most common revision control systems, backup and swap files and
Libtool build output directories. There can only be one active regex, of
multiple \fB\-i\fP options only the last one will take effect.

This is very helpful in cutting out extraneous files that get included in
the diff, e.g. if you maintain your source in a revision control system and
want to use a checkout to build a source package without including the
additional files and directories that it will usually contain (e.g. CVS/,
\&.cvsignore, .svn/). The default regex is already very exhaustive, but if you
need to replace it, please note that by default it can match any part of a
path, so if you want to match the begin of a filename or only full
filenames, you will need to provide the necessary anchors (e.g. '(^|/)',
\&'($|/)') yourself.
.TP 
\fB\-\-extend\-diff\-ignore\fP=\fIregex\fP
The perl regular expression specified will extend the default value used by
\fB\-\-diff\-ignore\fP and its current value (if set). It does this by
concatenating "\fB|\fP\fIregex\fP" to the existing value.  This option is
convenient to use in \fBdebian/source/options\fP to exclude some auto\-generated
files from the automatic patch generation.
.TP 
\fB\-I\fP[\fIwzorzec\-pliku\fP], \fB\-\-tar\-ignore\fP[=\fIwzorzec\-pliku\fP]
If this option is specified, the pattern will be passed to \fBtar\fP(1)'s
\fB\-\-exclude\fP option when it is called to generate a .orig.tar or .tar
file. For example, \fB\-I\fPCVS will make tar skip over CVS directories when
generating a .tar.gz file. The option may be repeated multiple times to list
multiple patterns to exclude.

\fB\-I\fP by itself adds default \fB\-\-exclude\fP options that will filter out
control files and directories of the most common revision control systems,
backup and swap files and Libtool build output directories.
.PP
\fBNote:\fP While they have similar purposes, \fB\-i\fP and \fB\-I\fP have very
different syntax and semantics. \fB\-i\fP can only be specified once and takes a
perl compatible regular expression which is matched against the full
relative path of each file. \fB\-I\fP can specified multiple times and takes a
filename pattern with shell wildcards.  The pattern is applied to the full
relative path but also to each part of the path individually. The exact
semantic of tar's \fB\-\-exclude\fP option is somewhat complicated, see
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full
documentation.

The default regex and patterns for both options can be seen in the output of
the \fB\-\-help\fP command.
.SS "Generic extract options"
.TP 
\fB\-\-no\-copy\fP
Nie kopiuje oryginalnych archiwów obok rozpakowanego pakietu źródłowego.
.TP 
\fB\-\-no\-check\fP
Bez weryfikacji podpisów i sprawdzania sum kontrolnych przed rozpakowaniem.
.TP 
\fB\-\-require\-valid\-signature\fP
Powoduje odmowę rozpakowania pakietu źródłowego, jeśli nie zawiera on
podpisu OpenPGP, który mógłby być zweryfikowany przez klucze użytkownika z
pliku \fItrustedkeys.gpg\fP, jeden z kluczy twórców pakietu, lub jeden z
oficjalnych kluczy Debiana (\fI/usr/share/keyrings/debian\-keyring.gpg\fP oraz
\fI/usr/share/keyrings/debian\-maintainers.gpg\fP).

.SH "FORMATY PAKIETÓW ŹRÓDŁOWYCH"
Jeśli nie wiadomo którego formatu źródeł użyć, powinno się wybrać
prawdopodobnie "3.0 (quilt)" lub "3.0" (native)". Więcej informacji o
wdrażaniu tych formatów w Debianie można znaleźć na stronie
https://wiki.debian.org/Projects/DebSrc3.0.

.SS "Format: 1.0"
Pakiet źródłowy w tym formacie składa się z pliku \fB.orig.tar.gz\fP
powiązanego z plikiem różnic \fB.diff.gz\fP, lub z pojedynczego pliku
\&\fB.tar.gz\fP (w takim przypadku mówi się, że pakiet jest \fInatywny\fP).

\fBRozpakowywanie\fP

Rozpakowanie pakietu natywnego to proste rozpakowanie pojedynczego pliku
archiwum w katalogu docelowym. Rozpakowanie pakietu w stylu Debiana
(non\-native) odbywa się poprzez najpierw rozpakowanie pliku \fB.orig.tar.gz\fP
a następnie nałożenia łatek zawartych w pliku \fB.diff.gz\fP. Czasy modyfikacji
wszystkich łatanych plików są ustawiane na wartość odpowiadającą czasowi
rozpakowania pakietu źródłowego (zapobiega to przesunięciom czasów, które
prowadzą do problemów przy łataniu plików generowanych automatycznie). Plik
różnic (diff) może tworzyć nowe pliki (cały katalog "debian" jest tak
tworzony), ale nie może usuwać plików (pozostawiane są puste pliki o zerowej
długości).

\fBBudowanie\fP

Budowanie pakietu natywnego to proste stworzenie pojedynczego pliku archiwum
z katalogu źródeł. Budowanie pakietu w stylu Debiana (non\-native) obejmuje
rozpakowanie oryginalnego archiwum do oddzielnego katalogu z przyrostkiem
".orig" i regenerację pliku \fB.diff.gz\fP poprzez porównanie \fIkatalogu\fP
pakietu źródłowego z katalogiem ".orig".

\fBOpcje budowania (z \-b):\fP

Buduje pakiet źródłowy. Należy podać jeden lub dwa argumenty, nie będące
opcjami. Pierwszym z nich jest nazwa katalogu zawierającego rozpakowane
źródła. Jeżeli podano drugi argument, to powinien on być nazwą oryginalnego
katalogu ze źródłami lub archiwum tar albo pustym łańcuchem znaków, jeśli
pakiet jest specyficzny dla Debiana i nie ma pliku różnic. Jeżeli nie podano
drugiego argumentu, to \fBdpkg\-source\fP \- w zależności od argumentów \fB\-sX\fP \-
będzie szukał albo archiwum tar z oryginalnymi źródłami
\fIpakiet\fP\fB_\fP\fIwersja_upstream\fP\fB.orig.tar.\fP\fIrozszerzenie\fP (gdzie
\fIrozszerzenie\fP jest jednym z \fBgz\fP,\fBbz2\fP lub \fBlzma\fP),  albo katalogu z
oryginalnymi źródłami \fIkatalog\fP.orig.

\fB\-sa\fP, \fB\-sp\fP, \fB\-sk\fP, \fB\-su\fP oraz \fB\-sr\fP nie nadpiszą istniejących
archiwów tar lub katalogów. Jeśli jest to wymagane, należy użyć \fB\-sA\fP,
\fB\-sP\fP, \fB\-sK\fP, \fB\-sU\fP i \fB\-sR\fP.
.PP
.TP 
\fB\-sk\fP
Określa, że należy spodziewać się oryginalnych źródeł w postaci archiwum
tar, domyślnie
\fIpakiet\fP\fB_\fP\fIwersja\-autora\-pakietu\fP\fB.orig.tar.\fP\fIrozszerzenie\fP.
Pozostawia oryginalne źródła w tym samym miejscu jako plik tar lub kopiuje
je do bieżącego katalogu jeśli jeszcze ich tam nie ma. Archiwum będzie
rozpakowane do \fIkatalogu\fP\fB.orig\fP w celu utworzenia pliku różnic (diff).
.TP 
\fB\-sp\fP
Jak \fB\-sk\fP, ale ponownie usunie katalog po zakończeniu.
.TP 
\fB\-su\fP
Określa, że należy spodziewać się oryginalnych źródeł w postaci katalogu,
domyślnie \fIpakiet\fP\fB\-\fP\fIwersja\-autora\-pakietu\fP\fB.orig\fP, na podstawie
którego \fBdpkg\-source\fP utworzy nowe archiwum oryginalnych źródeł.
.TP 
\fB\-sr\fP
Jak \fB\-su\fP, jednakże usunie katalog po jego użyciu.
.TP 
\fB\-ss\fP
Specifies that the original source is available both as a directory and as a
tarfile. \fBdpkg\-source\fP will use the directory to create the diff, but the
tarfile to create the \fB.dsc\fP.  This option must be used with care \- if the
directory and tarfile do not match a bad source archive will be generated.
.TP 
\fB\-sn\fP
Określa aby nie szukać żadnych oryginalnych źródeł, ani nie generować pliku
różnic. Jeśli jest podany drugi argument, musi on być pustym ciągiem
znaków. Jest to używane dla pakietów specyficznych dla Debiana, które nie
mają oddzielnych źródeł i w związku z tym nie mają debianizujących plików
różnic (diff).
.TP 
\fB\-sa\fP lub \fB\-sA\fP
Określa, że należy szukać oryginalnych źródeł w postaci archiwum tar lub
katalogu. Jeśli podano drugi argument może wskazywać on plik lub katalog,
albo być pustym ciągiem znaków (co jest równoważne użyciu \fB\-sn\fP). Jeśli
znaleziony zostanie plik tar, będzie on rozpakowany w celu utworzenia pliku
różnic, po czym zostanie on usunięty (co jest równoważne \fB\-sp\fP). Jeśli
zostanie znaleziony katalog, będzie on spakowany w celu utworzenia archiwum
źródłowego, po czym zostanie on usunięty (co jest równoważne \fB\-sr\fP).
.TP 
\fB\-\-abort\-on\-upstream\-changes\fP
Proces zwróci błąd, jeśli wygenerowany plik różnic zawiera zmiany w plikach
spoza podkatalogu debian. Opcja ta nie może być użyta w
\fBdebian/source/options\fP, lecz może być użyta w
\fBdebian/source/local\-options\fP.

\fBOpcje rozpakowywania (z \-x):\fP

We wszystkich przypadkach, istniejące oryginalne drzewo ze źródłami będzie
usunięte.
.TP 
\fB\-sp\fP
Jeśli zostanie użyta przy wypakowywaniu, wtedy oryginalne źródła (jeśli są)
pozostaną w formie archiwum tar. Jeśli archiwum nie ma jeszcze w bieżącym
katalogu, lub gdy istnieje ale jest to inny plik, zostanie tam
skopiowane. (\fBJest to zachowanie domyślne\fP).
.TP 
\fB\-su\fP
Rozpakowuje oryginalne drzewo źródeł programu.
.TP 
\fB\-sn\fP
Zapewnia, że oryginalne źródła nie będą kopiowane do bieżącego katalogu ani
rozpakowywane. We wszystkich przypadkach, istniejący katalog ze źródłami
będzie usunięty z bieżącego katalogu.
.PP
Wszystkie spośród opcji \fB\-s\fP\fI\-X\fP się wzajemnie wykluczają. Jeśli zostanie
podana więcej niż jedna, to zostanie użyta ostatnia z nich.
.TP 
\fB\-\-skip\-debianization\fP
Pomija wykorzystanie różnic Debiana (debian diff) do nałożenia łatek na
oryginalne źródła.
.
.SS "Format: 2.0"
Znany również jako wig&pen. Ten format nie jest zalecany do szerokiego
stosowania, zastępuje go format "3.0 (quilt)". Wig&pen był pierwszą
specyfikacją nowej generacji formatu pakietów źródłowych.

Zachowanie dla tego formatu jest takie samo jak dla "3.0 (quilt)" z tą
różnicą, że nie używa jawnej listy łatek. Wszystkie pliki w katalogu
\fBdebian/patches/\fP pasujące do wyrażenia regularnego Perla \fB[\ew\-]+\fP muszą
być prawidłowymi łatkami: są one nakładane podczas rozpakowywania.

Podczas budowania nowego pakietu źródłowego, wszystkie zmiany w stosunku do
kodu źródłowego pochodzącego od autorów programu są zapisywane w łatce o
nazwie \fBzz_debian\-diff\-auto\fP.
.
.SS "Format: 3.0 (native)"
Ten format jest rozszerzeniem natywnego formatu pakietów zdefiniowanego w
formacie w wersji 1.0. Obsługuje wszystkie metody kompresji i domyślnie
ignoruje pliki i katalogi specyficzne dla systemów kontroli wersji, jak
również wiele typów plików tymczasowych (proszę sprawdzić opis domyślnej
wartości opcji \fB\-I\fP w informacjach uzyskiwanych poleceniem \fB\-\-help\fP).
.
.SS "Format: 3.0 (quilt)"
A source package in this format contains at least an original tarball
(\fB.orig.tar.\fP\fIext\fP where \fIext\fP can be \fBgz\fP, \fBbz2\fP, \fBlzma\fP and \fBxz\fP)
and a debian tarball (\fB.debian.tar.\fP\fIext\fP). It can also contain additional
original tarballs (\fB.orig\-\fP\fIcomponent\fP\fB.tar.\fP\fIext\fP).  \fIcomponent\fP can
only contain alphanumeric characters and hyphens ("\-").
.PP
\fBRozpakowywanie\fP
.PP
Najpierw rozpakowywane jest główne oryginalne archiwum tar, następnie
rozpakowywane są dodatkowe oryginalne archiwa tar do podkatalogów nazwanych
od części \fIkomponent\fP z ich nazwy pliku (istniejące katalogi o takich
nazwach są zamieniane). Na końcu rozpakowywane jest archiwum debian, po
uprzednim usunięciu katalogu \fBdebian\fP (jeśli taki istniał). Należy
zauważyć, że archiwum debian musi zawierać podkatalog \fBdebian\fP, ale może
również zawierać pliki binarne poza tym katalogiem (proszę sprawdzić opcję
\fB\-\-include\-binaries\fP).
.PP
All patches listed in \fBdebian/patches/debian.series\fP or
\fBdebian/patches/series\fP are then applied.  If the former file is used and
the latter one doesn't exist (or is a symlink), then the latter is replaced
with a symlink to the former. This is meant to simplify usage of \fBquilt\fP to
manage the set of patches. Note however that while \fBdpkg\-source\fP parses
correctly series files with explicit options used for patch application
(stored on each line after the patch filename and one or more spaces), it
does ignore those options and always expect patches that can be applied with
the \fB\-p1\fP option of \fBpatch\fP. It will thus emit a warning when it
encounters such options, and the build is likely to fail.
.PP
Contrary to \fBquilt\fP's default behaviour, patches are expected to apply
without any fuzz. When that is not the case, you should refresh such patches
with \fBquilt\fP, or \fBdpkg\-source\fP will error out while trying to apply them.
.PP
Similarly to \fBquilt\fP's default behaviour, the patches can remove files too.
.PP
Jeśli podczas rozpakowywania zostały nałożone jakieś łatki, tworzony jest
plik \fB.pc/applied\-patches\fP.
.PP
\fBBudowanie\fP
.PP
All original tarballs found in the current directory are extracted in a
temporary directory by following the same logic as for the unpack, the
debian directory is copied over in the temporary directory, and all patches
except the automatic patch (\fBdebian\-changes\-\fP\fIversion\fP or
\fBdebian\-changes\fP, depending on \fB\-\-single\-debian\-patch\fP) are applied. The
temporary directory is compared to the source package directory. When the
diff is non\-empty, the build fails unless \fB\-\-single\-debian\-patch\fP or
\fB\-\-auto\-commit\fP has been used, in which case the diff is stored in the
automatic patch.  If the automatic patch is created/deleted, it's
added/removed from the series file and from the \fBquilt\fP metadata.

Żadne zmiany w jakimkolwiek pliku binarnym nie mogą być odwzorowane w pliku
zmian, co doprowadzi do niepowodzenia \- chyba, że opiekun pakietu rozmyślnie
zdecydował o włączeniu tak zmodyfikowanego pliku binarnego do archiwum
debian (wskazując go w \fBdebian/source/include\-binaries\fP). Proces budowania
nie powiedzie się także jeśli zostaną znalezione pliki binarne w podkatalogu
debian, chyba że zostały one uprzednio wymienione w
\fBdebian/source/include\-binaries\fP.

Zaktualizowany katalog debian oraz lista zmodyfikowanych plików binarnych są
następnie używane do powtórnego wygenerowania archiwum debian.

The automatically generated diff doesn't include changes on VCS specific
files as well as many temporary files (see default value associated to \fB\-i\fP
option in the \fB\-\-help\fP output). In particular, the \fB.pc\fP directory used by
\fBquilt\fP is ignored during generation of the automatic patch.

Uwaga: \fBdpkg\-source\fP \fB\-\-before\-build\fP (i \fB\-b\fP) upewni się, że drzewo ze
źródłami będzie mieć nałożone wszystkie łatki określone w pliku series
podczas generowania pakietu źródłowego. Czyni to odnajdując niezaaplikowane
łatki (są one wypisane w pliku \fBseries\fP, lecz nie są w
\&\fB.pc/applied\-patches\fP), a jeśli pierwsza łatka z tego zestawu może być
zaaplikowana bez błędów, zostaną zaaplikowane wszystkie. Opcja
\fB\-\-no\-preparation\fP może być użyta, aby wyłączyć to zachowanie.

.PP
\fBZapisywanie zmian\fP
.TP 
\fB\-\-commit\fP [\fIkatalog\fP] [\fInazwa\-łatki\fP] [\fIplik\-łatki\fP]
Generates a patch corresponding to the local changes that are not managed by
the \fBquilt\fP patch system and integrates it in the patch system under the
name \fIpatch\-name\fP. If the name is missing, it will be asked
interactively. If \fIpatch\-file\fP is given, it is used as the patch
corresponding to the local changes to integrate. Once integrated, an editor
is launched so that you can edit the meta\-information in the patch header.

Podanie \fIpliku\-łatki\fP jest przydatne głównie po nieudanym budowaniu, które
pre\-wygenerowało ten plik i na tej podstawie podany plik jest usuwany po
integracji. Proszę zauważyć, że zmiany zawarte w pliku łatki muszą być już
zaaplikowane w drzewie i że pliki zmodyfikowane przez łatkę nie mogą
zawierać uzupełniających, niezapisanych zmian.

Jeśli przy generowaniu łatki wykryte zostaną zmodyfikowane pliki binarne,
zostaną one automatycznie dodane do \fBdebian/source/include\-binaries\fP, przez
co znajdą się one w archiwum debian (dokładnie jak zrobiłoby \fBdpkg\-source
\-\-include\-binaries \-b\fP).
.PP
\fBOpcje budowania\fP
.TP 
\fB\-\-allow\-version\-of\-quilt\-db=\fP\fIwersja\fP
Allow \fBdpkg\-source\fP to build the source package if the version of the
\fBquilt\fP metadata is the one specified, even if \fBdpkg\-source\fP doesn't know
about it. Effectively this says that the given version of the \fBquilt\fP
metadata is compatible with the version 2 that \fBdpkg\-source\fP currently
supports. The version of the \fBquilt\fP metadata is stored in \fB.pc/.version\fP.
.TP 
\fB\-\-include\-removal\fP
Usunięte pliki nie będą ignorowane, ale będą włączone do automatycznie
generowanej łatki.
.TP 
\fB\-\-include\-timestamp\fP
Włączenie czasu modyfikacji w automatycznie generowanej łatce.
.TP 
\fB\-\-include\-binaries\fP
Dodanie wszystkich zmodyfikowanych plików binarnych do archiwum debian. Są
one również dodawane do \fBdebian/source/include\-binaries\fP: dzięki temu będą
domyślnie dodawane przy następnych budowach pakietu, zaś ta opcja nie będzie
już więcej potrzebna.
.TP 
\fB\-\-no\-preparation\fP
Nie próbuje przygotowywać drzewa budowania poprzez nakładanie łatek, które
wyraźnie nie są nałożone.
.TP 
\fB\-\-single\-debian\-patch\fP
Używa \fBdebian/patches/debian\-changes\fP zamiast
\fBdebian/patches/debian\-changes\-\fP\fIwersja\fP dla nazwy automatycznej łatki
generowanej przy budowaniu. Opcja ta jest szczególnie użyteczna, jeśli
pakiet jest zarządzany w VCS, a zestaw łatek nie może być wygenerowana w
sposób pewny. Bieżącego plik różnic z wersją projektu macierzystego powinien
być w zamian przechowywany w pojedynczej łatce. Opcja powinna być
prawdopodobnie umieszczona w \fBdebian/source/local\-options\fP razem z plikiem
\fBdebian/source/local\-patch\-header\fP, wyjaśniającym w jaki sposób najlepiej
przejrzeć zmiany Debiana, np. w używanym VCS.
.TP 
\fB\-\-create\-empty\-orig\fP
Automatycznie tworzy główne oryginalne archiwum jako puste, jeśli go nie ma,
a są dodatkowe archiwa uzupełniające. Opcja ta jest przeznaczona do pakietów
źródłowych, będących po prostu zbiorem oprogramowania różnego pochodzenia
bez programu "głównego".
.TP 
\fB\-\-no\-unapply\-patches, \-\-unapply\-patches\fP
By default, \fBdpkg\-source\fP will automatically unapply the patches in the
\fB\-\-after\-build\fP hook if it did apply them during \fB\-\-before\-build\fP. Those
options allow you to forcefully disable or enable the patch unapplication
process. Those options are only allowed in \fBdebian/source/local\-options\fP so
that all generated source packages have the same behavior by default.
.TP 
\fB\-\-abort\-on\-upstream\-changes\fP
The process fails if an automatic patch has been generated. This option can
be used to ensure that all changes were properly recorded in separate
\fBquilt\fP patches prior to the source package build. This option is not
allowed in \fBdebian/source/options\fP but can be used in
\fBdebian/source/local\-options\fP.
.TP 
\fB\-\-auto\-commit\fP
The process doesn't fail if an automatic patch has been generated, instead
it's immediately recorded in the \fBquilt\fP series.

.PP
\fBOpcje rozpakowywania\fP
.TP 
\fB\-\-skip\-debianization\fP
Pomija rozpakowanie archiwum debian z włączeniem jego zawartości na
oryginalne źródła.
.TP 
\fB\-\-skip\-patches\fP
Nie nakłada łatek po skończeniu rozpakowywania.
.
.SS "Format: 3.0 (custom)"
Ten format jest szczególny. Nie jest prawdziwym formatem pakietu źródłowego,
ale może być użyty do utworzenia pakietu źródłowego zawierającego dowolne
pliki.
.PP
\fBOpcje budowania\fP
.PP
Wszystkie argumenty nie będące opcjami są uważane za pliki, które mają być
zintegrowane z generowanym pakietem źródłowym. Pliki te muszą istnieć i
najlepiej powinny być w bieżącym katalogu. Musi być podany przynajmniej
jeden plik.
.TP 
\fB\-\-target\-format=\fP\fIwartość\fP
\fBRequired\fP. Defines the real format of the generated source package.  The
generated .dsc file will contain this value in its \fBFormat\fP field and not
"3.0 (custom)".
.
.SS "Format: 3.0 (git)"
Jest to format eksperymentalny.
.PP
Pakiet źródłowy w tym formacie składa się z pojedynczej kopii repozytorium
git \fB.git\fP, przechowującego źródła pakietu. Może zawierać również plik
\&\fB.gitshallow\fP, wypisujący wersje do płytkiej kopii gita.
.PP
\fBRozpakowywanie\fP
.PP
Kopia jest tworzona jako repozytorium git do katalogu docelowego. Jeśli
istnieje plik gitshallow, to jest instalowany jako ".git/shallow" wewnątrz
sklonowanego repozytorium git.
.PP
Proszę zauważyć, że domyślnie nowe repozytorium będzie przełączone na tę
samą gałąź co oryginalne źródło (zwykle jest to "master", ale może być
również coś innego). Wszystkie inne gałęzie będą dostępne jako
"remotes/origin/".
.PP
\fBBudowanie\fP
.PP
Nie zagłębiając się dalej, wykonywane są pewne testy aby upewnić się, czy
nie ma żadnych niezatwierdzonych zmian, które nie są ignorowane.
.PP
\fBgit\-bundle\fP(1) jest używany do utworzenia kopii repozytorium
git. Domyślnie dołączane są wszystkie gałęzie i tagi.
.PP
\fBOpcje budowania\fP
.TP 
\fB\-\-git\-ref=\fP\fIodniesienie\fP
Allows specifying a git ref to include in the git bundle. Use disables the
default behavior of including all branches and tags. May be specified
multiple times. The \fIref\fP can be the name of a branch or tag to include. It
may also be any parameter that can be passed to \fBgit\-rev\-list\fP(1). For
example, to include only the master branch, use \fB\-\-git\-ref=\fPmaster. To
include all tags and branches, except for the private branch, use
\fB\-\-git\-ref=\fP\-\-all \fB\-\-git\-ref=\fP^private
.TP 
\fB\-\-git\-depth=\fP\fIliczba\fP
Tworzy płytką kopię (ang. shallow clone) z historią ograniczoną do podanej
liczby wersji.
.SS "Format: 3.0 (bzr)"
Ten format jest eksperymentalny. Generuje pojedyncze archiwum zawierające
repozytorium bzr.
.PP
\fBRozpakowywanie\fP
.PP
Archiwum tar jest rozpakowywane i używany jest bzr aby pobrać aktualną gałąź
kodu.
.PP
\fBBudowanie\fP
.PP
Nie zagłębiając się dalej, wykonywane są pewne testy aby upewnić się, czy
nie ma żadnych niezatwierdzonych zmian, które nie są ignorowane.
.PP
Następnie część katalogu źródeł specyficzna dla systemu kontroli wersji jest
kopiowana do katalogu tymczasowego. Przed tym katalog tymczasowy jest
pakowany do archiwum tar i wykonywane są różne czynności porządkowe, aby
zaoszczędzić miejsce.
.SH DIAGNOSTYKA
.SS "w debian/source/format nie podano formatu źródeł,"
The file \fBdebian/source/format\fP should always exist and indicate the
desired source format. For backwards compatibility, format "1.0" is assumed
when the file doesn't exist but you should not rely on this: at some point
in the future \fBdpkg\-source\fP will be modified to fail when that file doesn't
exist.

Powodem jest to, że format "1.0" nie jest już formatem rekomendowanym;
należy z reguły wybrać któregoś z nowszych formatów ("3.0 (quilt)", "3.0
(native)"), lecz \fBdpkg\-source\fP nie zrobi tego automatycznie za
opiekuna. Aby wciąż używać starego formatu, należy wyrażnie tego zażądać
umieszczając "1.0" w \fBdebian/source/format\fP.
.SS "łatka modyfikuje następujące pliki macierzyste"
Jeżeli używa się formatu "1.0" źródeł, to zwykle złym pomysłem jest
bezpośrednie modyfikowanie plików macierzystych, jako że na końcu zmiany
będą ukryte i w większości nieudokumentowane w pliku .diff.gz. Zamiast tego
należy przechowywać swe zmiany jako łatki w katalogu debian i aplikować je w
trakcie budowania. Aby zapobiec temu złożonemu procesowi, można również użyć
formatu "3.0 (quilt), który oferuje to natywnie.
.SS "niereprezentowalna zmiana w \fIpliku\fP"
Zmiany w źródłach macierzystych są zwykle przechowywane w postaci łatek,
lecz nie wszystkie zmiany mogą być tak reprezentowane: łatki mogą zmieniać
zawartość jedynie plików tekstowym. Jeśli próbuje się zastąpić plik czymś
innego typu (np. zastąpić czysty plik dowiązaniem symbolicznym lub
katalogiem), otrzyma się ten komunikat o błędzie.
.SS "nowo utworzony pusty plik \fIplik\fP nie będzie dołączony do pliku łatki"
Puste pliki nie mogą być tworzone za pomocą plików łatek. W związku z tym,
ta zmiana nie jest przechowywana w pakiecie źródłowym, a to ostrzeżenie o
tym przypomina.
.SS "prawa dostępu \fIprawo\fP pliku \fIplik\fP nie będą dołączone do pliku łatki"
Patch files do not record permissions of files and thus executable
permissions are not stored in the source package. This warning reminds you
of that fact.
.SS "specjalne prawa dostępu \fIprawa\fP pliku \fIplik\fP nie będą dołączone do pliku łatki"
Pliki łatek nie przechowują informacji o uprawnieniach plików i w związku z
tym, zmodyfikowane uprawnienia nie są przechowywane w pakiecie źródłowym. To
ostrzeżenie przypomina o tym fakcie.
.SH "FORMATY PLIKÓW"
.SS debian/source/format
Plik ten zawiera w pojedynczej linii określenie formatu, który powinien
zostać użyty do zbudowania pakietu źródłowego (dostępne formaty opisane są
wyżej). Niedozwolone są początkowe i końcowe znaki spacji.
.SS debian/source/include\-binaries
Plik ten zawiera listę plików binarnych (po jednym w każdej linii), które
powinny być zawarte w archiwum debian. Początkowe i końcowe znaki spacji są
usuwane. Linie rozpoczynające się od "#" są traktowane jak komentarze i są
pomijane, puste linie są ignorowane.
.SS debian/source/options
Plik zawiera listę długich opcji, które powinny być automatycznie dodawane
na początku zestawu opcji wiersza polecenia wywołania \fBdpkg\-source \-b\fP lub
\fBdpkg\-source \-\-print\-format\fP. Do tego pliku świetnie nadają się opcje takie
jak \fB\-\-compression\fP i \fB\-\-compression\-level\fP.
.P
Każda opcja powinna być umieszczona w osobnym wierszu. Puste wiersze i
wiersze zaczynające się od znaku "#" są ignorowane. Początkowe "\-\-" powinno
być usunięte, niedozwolone są opcje któtkie. Wokół symbolu "=" dozwolone są
opcjonalne spacje, a wokół wartości dozwolone są opcjonalne cudzysłowy. Oto
przykład takiego pliku:
.P
  # let dpkg\-source create a debian.tar.bz2 with maximal compression
  compression = "bzip2"
  compression\-level = 9
  # use debian/patches/debian\-changes as automatic patch
  single\-debian\-patch
  # ignore changes on config.{sub,guess}
  extend\-diff\-ignore = "(^|/)(config.sub|config.guess)$"
.P
Uwaga: opcje \fBformat\fP nie są akceptowane w tym pliku, należy w zamian
używać \fBdebian/source/format\fP.
.SS debian/source/local\-options
Dokładnie jak \fBdebian/source/options\fP z tym wyjątkiem, że plik nie jest
dołączany do wygenerowanego pakietu źródłowego. Może być przydatny aby
przechować preferencje opiekuna lub repozytorium VCS, gdzie pakiet źródłowy
jest zarządzany.
.SS "debian/source/local\-patch\-header and debian/source/patch\-header"
Tekst w dowolnej postaci, który zostanie umieszczony na górze łatki
wygenerowanej automatycznie, w formacie "2.0" lub "3.0
(quilt). \fBlocal\-patch\-header\fP nie jest dołączone w generowanym pakiecie
źródłowym, natomiast \fBpatch\-header\fP jest.
.SS debian/patches/series
This file lists all patches that have to be applied (in the given order)  on
top of the upstream source package. Leading and trailing spaces are
stripped. Lines starting with "#" are comments and are skipped. Empty lines
are ignored. Remaining lines start with a patch filename (relative to the
\fBdebian/patches/\fP directory) up to the first space character or the end of
line. Optional \fBquilt\fP options can follow up to the end of line or the
first "#" preceded by one or more spaces (which marks the start of a comment
up to the end of line).
.SH BŁĘDY
Punkt, w którym następuje nadpisywanie pól w porównaniu do pewnych
standardowych ustawień pól wyjściowych jest dość zagmatwany.
.SH "ZOBACZ TAKŻE"
\fBdpkg\-deb\fP(1), \fBdpkg\fP(1), \fBdselect\fP(1).
.SH TŁUMACZE
Piotr Roszatycki <dexter@debian.org>, 1999
.br
Bartosz Feński <fenio@debian.org>, 2004-2005
.br
Robert Luberda <robert@debian.org>, 2006-2008
.br
Wiktor Wandachowicz <siryes@gmail.com>, 2008
.br
Michał Kułach <michal.kulach@gmail.com>, 2012
