.\" dpkg manual page - deb-src-control(5) .\" .\" Copyright Š 2010 Oxan van Leeuwen .\" Copyright Š 2011 RaphaĂŤl Hertzog .\" Copyright Š 2011-2012 Guillem Jover .\" .\" 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 . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH deb\-src\-control 5 2012\-06\-16 "Projekt Debian" Debian .SH NAZWA deb\-src\-control \- format głównego pliku kontrolnego pakietu źródłowego Debiana . .SH SKŁADNIA control . .SH OPIS Każdy pakiet źródłowy Debiana zawiera główny plik "control", który zawiera co najmniej dwa akapity, oddzielone pustym wierszem. Pierwszy zawiera wszystkie ogólne informacje o pakiecie źródłowym, natomiast każdy następny akapit opisuje dokładnie jeden pakiet binarny. Każdy akapit składa się z co najmniej jednego pola. Pole zaczyna się jego nazwą, taką jak \fBPackage\fP lub \fBSection\fP (wielkość znaków nieistotna), po której występuje dwukropek, zawartość pola i nowy wiersz. Dozwolone są również pola składające się z wielu wierszy, ale każdy uzupełniający wiersz, nieposiadający nazwy pola, powinien zaczynać się co najmniej jedną spacją. Zawartość pól wielowierszowych jest zwykle łączona przez narzędzia w jeden wiersz (z wyjątkiem pola \fBDescription\fP, patrz niżej). Aby wstawić puste wiersze w pole wielowierszowe, po spacji należy dopisać kropkę. Wiersze zaczynające się od "\fB#\fP" są traktowane jako komentarze. . .SH "POLA PAKIETU ŹRÓDŁOWEGO" .TP \fBSource:\fP \fInazwa\-pakietu\-źródłowego\fP (wymagane) Wartość tego pola jest nazwą pakietu źródłowego i powinna pasować do nazwy pakietu źródłowego w pliku debian/changelog. Nazwa pakietu może składać się wyłącznie z małych liter (a\-z), cyfr (0\-9), plusów (+), minusów (\-) oraz kropek (.). Nazwy pakietu muszą mieć długość co najmniej dwóch znaków i muszą zaczynać się literą lub cyfrą. .TP \fBMaintainer:\fP \fIpełna\-nazwa e\-mail\fP (wymagane) Powinna być w formacie "Jan Nowak " i zazwyczaj oznacza osobę, która zajmuje się obecnie danym pakietem, a nie autora programu ani pierwotnego paczkującego. .TP \fBUploaders:\fP\fI pełna\-nazwa email\fP Zawiera wszystkie nazwiska i adresy poczty elektronicznej współopiekunów pakietu, w tym samym formacie jak pole Maintainer. Poszczególnych współopiekunów należy rozdzielić przecinkiem. .TP \fBStandards\-Version:\fP\fI oznaczenie\-wersji\fP Opisuje najnowszą wersję standardów (składających się z dokumentu Debian Policy Manual i tekstów, do których się on odwołuje, z pakietu \fBdebian\-policy\fP), z którymi zgodny jest pakiet. .TP \fBDM\-Upload\-Allowed:\fP \fByes\fP|\fBno\fP Pole określa, czy pakiet może zostać zamieszczony przez DM (ang. Debian Maintainer) znajdującego się w polu Maintainer lub Uploaders. Domyślną wartością jest "no". .TP \fBHomepage:\fP\fI URL\fP URL do strony internetowej projektu macierzystego. .TP \fBBugs:\fP\fI URL\fP \fIURL\fP systemu zgłaszania błędów dla tego pakietu. Obecnie używanym formatem jest is \fItyp_bts\fP\fB://\fP\fIadres_bts\fP, na przykład: \fBdebbugs://bugs.debian.org\fP. Pole to zwykle nie jest potrzebne. .TP \fBVcs\-*:\fP\fI URL\fP \fIURL\fP repozytorium systemu kontroli wersji, używanego do zarządzania danym pakietem. Obecnie obsługiwane są: \fBArch\fP, \fBBzr\fP (Bazaar), \fBCvs\fP, \fBDarcs\fP, \fBGit\fP, \fBHg\fP (Mercurial), \fBMtn\fP (Monotone) i \fBSvn\fP (Subversion). Pole to zwykle odwołuje się do najnowszej wersji pakietu np. głównej gałęzi lub pnia. .TP \fBVcs\-Browser:\fP\fI URL\fP \fIURL\fP interfejsu WWW do przeglądania repozytorium systemu kontroli wersji. .TP \fBOrigin:\fP\fI nazwa\fP Nazwa dystrybucji, z której pochodzi pakiet. Pole to z reguły nie jest potrzebne. .TP \fBSection:\fP\fIsekcja\fP Jest to ogólne pole zawierające kategorię pakietu bazowaną na oprogramowaniu, które zawiera. Niektóre częściej występujące sekcje to: "utils", "net", "mail", "text", "x11" itp. .TP \fBPriority:\fP\fI priorytet\fP Ustawia ważność pakietu w stosunku do całego systemu. Najczęściej używane priorytety to: "required" (wymagany), "standard" (standardowy) , "optional" (opcjonalny), "extra" (dodatkowy) itp. W Debianie pola \fBSection\fP i \fBPririty\fP mają ściśle zdefiniowany zbiór akceptowalnych wartości opisany w Zasadach polityki Debiana. Listę tych wartości można znaleźć w najnowszej wersji pakietu \fBdebian\-policy\fP. .TP \fBBuild\-Depends:\fP\fI lista\-pakietów\fP Lista pakietów, które muszą być zainstalowane i skonfigurowane aby zbudować pakiet źródłowy. Zależność na tej liście ma taki efekt, jak umieszczenie jest zarówno w \fBBuild\-Depends\-Arch\fP jak i \fBBuild\-Depends\-Indep\fP, z tym dodatkowym działaniem, że jest ona używana tylko do budowy źródeł. .TP \fBBuild\-Depends\-Arch:\fP\fI lista\-pakietów\fP Podobnie jak \fBBuild\-Depends\fP, lecz obejmuje tylko zależności potrzebne przy budowaniu pakietów niezależnych od architektury. \fBBuild\-Depends\fP są wówczas również instalowane. Pole zostało wprowadzone w wersji 1.16.4 dpkg; aby budować przy użyciu starszych wersji dpkg, powinno się używać \fBBuild\-Depends\fP. .TP \fBBuild\-Depends\-Indep:\fP\fI lista\-pakietów\fP Podobnie jak \fBBuild\-Depends\fP, lecz obejmuje tylko zależności potrzebne przy budowaniu pakietów niezależnych od architektury. \fBBuild\-Depends\fP są wówczas również instalowane. .TP \fBBuild\-Conflicts:\fP\fI lista\-pakietów\fP Lista pakietów, które nie powinny być instalowane podczas budowy pakietu, np. dlatego, że wpływają na używany system budowania. Zależność z tej listy ma taki sam efekt, jak umieszczenie jej zarówno w \fBBuild\-Conflicts\-Arch\fP jak i \fBBuild\-Conflicts\-Indep\fP, z tym dodatkowym działaniem, że jest używana tylko do budowań źródeł. .TP \fBBuild\-Conflicts\-Arch:\fP\fI lista\-pakietów\fP Podobnie jak \fBBuild\-Conflicts\fP, lecz obejmuje tylko zależności potrzebne przy budowaniu pakietów zależnych od architektury. Pole zostało wprowadzone w wersji 1.16.4 dpkg; aby budować przy użyciu starszych wersji dpkg, powinno się używać \fBBuild\-Conflicts\fP. .TP \fBBuild\-Conflicts\-Indep:\fP\fI lista\-pakietów\fP Podobnie jak \fBBuild\-Conflict\fP, lecz ma znaczenie tylko przy budowaniu pakietów niezależnych od architektury. .PP Wartością pól \fBBuild\-Depends\fP, \fBBuild\-Depends\-Arch\fP i \fBBuild\-Depends\-Indep\fP jest lista grup alternatywnych pakietów. Każda grupa jest listą pakietów oddzielonych symbolami pionowej kreski ("|"). Grupy oddzielone są od siebie przecinkami. Przecinki mają znaczenie "I" (koniunkcja), a kreski \- "LUB" (alternatywa), przy czym priorytet koniunkcji jest wyższy. Po każdej nawie pakietu może opcjonalnie występować numer wersji \- podany w nawiasach i architektura \- w nawiasach kwadratowych. Wartościami pól \fBBuild\-Conflicts\fP, \fBBuild\-Conflicts\-Arch\fP i \fBBuild\-Conflicts\-Indep\fP jest lista nazw pakietów, rozdzielonych przecinkami, gdzie przecinek oznacza operator "I". Podawanie pakietów alternatywnych za pomocą znaku potoku "|" nie jest obsługiwane. Po każdej nazwie pakietu, opcjonalnie, może zostać podana wersja \- w nawiasach i architektura \- w nawiasach kwadratowych. Numer wersji może zaczynać się od ">>", co oznacza, że każda późniejsza wersja pakietu będzie odpowiednia; można także podawać lub pomijać wersję zmian Debiana (po znaku myślnika). Akceptowalne relacje są następujące: ">>" \- większy niż, "<<" \- mniejszy niż, ">=" \- większy lub równy, "<=" \- mniejszy lub równy oraz "=" \- równy. Określenie architektury może składać się z jednej lub więcej nazw architektur, oddzielonych białym znakiem. Przed każdą nazwą można dodać wykrzyknik, oznaczający "NIE". Proszę zauważyć, że zależności wobec pakietów z zestawu \fBbuild\-essential\fP mogą być pominięte, nie da się również deklarować wobec nich konfliktów. Lista tych pakietów znajduje się w pakiecie build\-essential. .SH "POLA PAKIETÓW BINARNYCH" .LP Proszę zauważyć, że w akapicie binarnym można podać również pola \fBPriority\fP, \fBSection\fP i \fBHomepage\fP \- przesłonią one wówczas ogólną wartość z pakietu źródłowego. .TP \fBPackage:\fP \fInazwa\-pakietu\-binarnego\fP (wymagane) To pole jest używane do podania nazwy pakietu binarnego. Stosują się to te same zasady, co wobec nazwy pakietu źródłowego. .TP \fBArchitecture:\fP \fIarchitektura\fP|\fBall\fP|\fBany\fP (wymagane) Architektura określa typ sprzętu, na jakim działa dany pakiet. W przypadku pakietów działających na wszystkich architekturach, należy użyć wartości \fBany\fP. Do pakietów niezależnych od architektury, takich jak powłoka i skrypty Perla lub dokumentacja, właściwym wyborem jest \fBall\fP. Aby ograniczyć pakiet do określonego zestawu architektur, należy je podać, oddzielając kolejne spacją. Można również podać w tej liście maski architektur (patrz \fBdpkg\-architecture\fP(1), aby dowiedzieć się o nich więcej). .TP \fBPackage\-Type:\fP \fBdeb\fP|\fBudeb\fP To pole definiuje typ pakietu. "udeb" odnosi się do pakietów o zmniejszonych rozmiarach, używanych przez instalator Debiana. "deb" jest wartością domyślną i jest ona przyjmowana, gdy pole nie zostanie użyte. W przyszłości możliwe jest dodanie kolejnych typów. .TP .PD 0 \fBSubarchitecture:\fP\fI wartość\fP .TP .PD 0 \fBKernel\-Version:\fP\fI wartość\fP .TP .PD 0 \fBInstaller\-Menu\-Item:\fP\fI wartość\fP Pola te są używane przez debian\-installer (instalator Debiana) i zwykle nie są potrzebne. Plik /usr/share/doc/debian\-installer/devel/modules.txt z pakietu \fBdebian\-installer\fP zawiera więcej informacji. .TP .PD 0 \fBEssential:\fP \fByes\fP|\fBno\fP .TP .PD 0 \fBMulti\-Arch:\fP \fBsame\fP|\fBforeign\fP|\fBallowed\fP .TP .PD 0 \fBTag:\fP\fI lista\-znaczników\fP .TP .PD 0 \fBDescription:\fP \fIkrótki\-opis\fP (wymagane) Pola te są opisane na stronie podręcznika \fBdeb\-control\fP(5), ponieważ są one dokładnie kopiowane do pliku kontrolnego pakietu binarnego. .TP .PD 0 \fBDepends:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBPre\-Depends:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBRecommends:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBSuggests:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBBreaks:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBEnhances:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBReplaces:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBConflicts:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBProvides:\fP\fI lista\-pakietów\fP .TP .PD 0 \fBBuilt\-Using:\fP\fI lista\-pakietów\fP .br (Rozszerza) Pola te deklarują zależności pomiędzy pakietami. Są one opisane na stronie podręcznika \fBdeb\-control\fP(5) i w pakiecie \fBdebian\-policy\fP. .SH "POLA DEFINIOWANE PRZEZ UŻYTKOWNIKA" Istnieje możliwość dodawania dodatkowych do pliku kontrolnego. Narzędzia będą je ignorować. Jeśli pola te mają być kopiowane do plików wyjściowych, takich jak pakiety binarne, konieczne jest użycie następującej składni: nazwa musi się zaczynać od X, po którym występuje co najmniej jedna z liter B, C, S i minus. Jeśli używana jest litera B, to pole pojawi się w pliku kontrolnych pakietu binarnego (patrz \fBdeb\-control\fP(5)), w przypadku litery S, w pliku kontrolnym pakietu źródłowego, zgodnie z \fBdpkg\-source\fP(1), a litera C spowoduje pojawienie się pola w pliku kontrolnym wysyłki (.changes). Proszę zauważyć, że przedrostki X[BCS]\- są usuwane, gdy dane pola są kopiowane do plików wyjściowych. Pole \fBXC\-Approved\-By\fP pojawi się jako \fBApproved\-By\fP w pliku .changes i nie pojawi się w plikach kontrolnych pakietu źródłowego, ani binarnego. Proszę wziąć pod uwagę, że pola zdefiniowane przez użytkownika będą używały globalnej przestrzeni nazw, co może w przyszłości kolidować z oficjalnie rozpoznawanymi polami. Aby zapobiec takiej potencjalnej sytuacji, można poprzedzić takie pola przedrostkiem \fBPrivate\-\fP, np. \fBXB\-Private\-New\-Field\fP, co dodatkowo spowoduje, że \fBdpkg\-deb\fP nie będzie ostrzegał przed nierozpoznanymi polami. .SH PRZYKŁAD .\" .RS .nf # Komentarz Source: dpkg Section: admin Priority: required Maintainer: Dpkg Developers # to pole będzie skopiowane do pakietu binarnego i źródłowego XBS\-Upstream\-Release\-Status: stable Homepage: http://wiki.debian.org/Teams/Dpkg Vcs\-Browser: http://git.debian.org/?p=dpkg/dpkg.git Vcs\-Git: git://git.debian.org/git/dpkg/dpkg.git Standards\-Version: 3.7.3 Build\-Depends: pkg\-config, debhelper (>= 4.1.81), libselinux1\-dev (>= 1.28\-4) [!linux\-any] Package: dpkg\-dev Section: utils Priority: optional Architecture: all # to jest pole użytkownika w pakiecie binarnym XB\-Mentoring\-Contact: Raphael Hertzog Depends: dpkg (>= 1.14.6), perl5, perl\-modules, cpio (>= 2.4.2\-2), bzip2, lzma, patch (>= 2.2\-1), make, binutils, libtimedate\-perl Recommends: gcc | c\-compiler, build\-essential Suggests: gnupg, debian\-keyring Conflicts: dpkg\-cross (<< 2.0.0), devscripts (<< 2.10.26) Replaces: manpages\-pl (<= 20051117\-1) Description: Debian package development tools This package provides the development tools (including dpkg\-source) required to unpack, build and upload Debian source packages. . Most Debian source packages will require additional tools to build; for example, most packages need make and the C compiler gcc. .fi .\" .RE .SH "ZOBACZ TAKŻE" \fBdeb\-control\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-source\fP(1) .SH "TŁUMACZE" Piotr Roszatycki , 1999 .br Bartosz Feński , 2004-2005 .br Robert Luberda , 2006-2008 .br Wiktor Wandachowicz , 2008 .br Michał Kułach , 2012