.\" dpkg manual page - deb-substvars(5) .\" .\" Copyright Š 1995-1996 Ian Jackson .\" Copyright Š 2000 Wichert Akkerman .\" Copyright Š 2009-2010 RaphaĂŤl Hertzog .\" .\" 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\-substvars 5 2009\-07\-15 "Projekt Debian" "programy pomocnicze dpkg" .SH NAZWA deb\-substvars \- zmienne podstawiania źródłowych pakietów Debiana . .SH SKŁADNIA substvars . .SH OPIS Zanim \fBdpkg\-source\fP, \fBdpkg\-gencontrol\fP i \fBdpkg\-genchanges\fP zapiszą swoje informacje kontrolne (do źródłowego pliku \fB.dsc\fP w wypadku \fBdpkg\-source\fP i na standardowe wyjście w wypadku \fBdpkg\-gencontrol\fP i \fBdpkg\-genchanges\fP), wykonują podstawienia pewnych zmiennych na pliku wyjściowym. Podstawienie zmiennej ma postać \fB${\fP\fInazwa\-zmiennej\fP\fB}\fP. Nazwy zmiennych składają się ze znaków alfanumerycznych, myślników oraz dwukropków i zaczynają się od znaku alfanumerycznego. Podstawienia zmiennych są powtarzane dopóty, aż nie będzie nic do podstawienia; pełen tekst pola po podstawieniu jest ponownie skanowany w poszukiwaniu kolejnych podstawień. Po dokonaniu wszystkich podstawień, każde wystąpienie łańcucha \fB${}\fP (który nie jest poprawnym podstawieniem) jest zastępowane przez znak \fB$\fP. Podstawianie zmiennych jest wykonywane na wszystkich polach kontrolnych, jednak niektóre z tych pól są używane oraz wymagane podczas budowania, gdy podstawienie nie zostało jeszcze wykonane. Dlatego nie można używać zmiennych w polach \fBPackage\fP, \fBSource\fP oraz \fBArchitecture\fP. Podstawianie zmiennych ma miejsce na zawartości pól po ich przetworzeniu, tak więc aby rozwinąć zmienną w wiele wierszy nie należy umieszczać spacji po znaku nowego wiersza. Jest to wykonywane jawnie, gdy pole jest wynikiem. Na przykład, jeśli zmienna \fB${Description}\fP jest ustawiona na "foo is bar.${Newline}foo is great." i pole wygląda następująco: Description: foo application ${Description} . More text. To wynikiem będzie: Description: foo application foo is bar. foo is great. . More text. Zmienne można ustawić za pomocą opcji \fB\-V\fP. Można je także podać w pliku \fBdebian/substvars\fP (lub jakimkolwiek innym pliku wskazanym opcją \fB\-T\fP). Plik ten składa się z linii w postaci \fInazwa\fP\fB=\fP\fIwartość\fP. Końcowe spacje w każdej linii, linie puste oraz linie zaczynające się od znaku \fB#\fP (czyli komentarze) są ignorowane. Dodatkowo dostępne są następujące standardowe zmienne: .TP \fBArch\fP Bieżąca architektura budowania (z \fBdpkg \-\-print\-architecture\fP). .TP \fBsource:Version\fP Wersja pakietu źródłowego .TP \fBsource:Upstream\-Version\fP Oryginalna wersja autora pakietu źródłowego, włączając wersję epoki Debiana jeśli jest. .TP \fBbinary:Version\fP Wersja pakietu binarnego (może się różnić od source:Version na przykład w przypadku binNMU). .TP \fBSource\-Version\fP Wersja pakietu źródłowego (z dziennika zmian). Ta zmienna jest obecnie \fBprzestarzała\fP, jako że jej znaczenie jest inne niż jej funkcjonalność. Prosimy używać \fBsource:Version\fP lub \fBbinary:Version\fP, w zależności od wymagań. .TP \fBInstalled\-Size\fP Całkowity rozmiar plików zainstalowanych przez pakiet. Wartość ta jest kopiowana do odpowiadającego jej pola w pliku kontrolnym; ustawienie jej zmodyfikuje wartość tego pola. Jeśli nie ustawiono zmiennej, to \fBdpkg\-gencontrol\fP użyje \fBdu \-k debian/tmp\fP, aby znaleźć jej wartość domyślną. .TP \fBExtra\-Size\fP Dodatkowa przestrzeń dyskowa, używana podczas instalowania pakietu. Jeśli ta zmienna jest ustawiona, to jej wartość jest dodawana do wartości zmiennej \fBInstalled\-Size\fP (niezależnie od tego, czy została otwarcie ustawiona, czy ma wartość domyślną), zanim zostania skopiowana do pola \fBInstalled\-Size\fP pliku kontrolnego. .TP \fBF:\fP\fInazwa\-pola\fP Wartość pola wyjściowego \fInazwa_pola\fP (które musi być podane z użyciem Notacji\-Wielbłądziej). Ustawienie takich zmiennych wpływa tylko na miejsca, gdzie są one jawnie rozwijane. .TP \fBFormat\fP Wersja formatu pliku \fB.changes\fP wygenerowana przez tę wersję skryptów przygotowujących pakiety źródłowe. Ustawienie tej zmiennej zmienia również zawartość pola \fBFormat\fP w pliku \fB.changes\fP. .TP \fBNewline\fP, \fBSpace\fP, \fBTab\fP Każda z tych zmiennych zawiera odpowiadający jej znak. .TP \fBshlibs:\fP\fIpole\-zależności\fP Ustawienia zmiennych w tej postaci są generowane przez \fBdpkg\-shlibdeps\fP. .TP \fBdpkg:Upstream\-Version\fP Oryginalna wersja dpkg, nadana przez autorów. .TP \fBdpkg:Version\fP Pełna wersja programu dpkg. .LP Jeżeli jest odwołanie do niezdefiniowanej zmiennej, to generowane jest ostrzeżenie i przyjmowana jest pusta wartość zmiennej. . .SH PLIKI .TP \fBdebian/substvars\fP Lista zmiennych podstawiania i ich wartości. . .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\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1), \fBdpkg\-shlibdeps\fP(1), \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