NAZWA
deb−substvars − zmienne podstawiania źródłowych pakietów Debiana
SKŁADNIA
substvars
OPIS
Zanim dpkg−source, dpkg−gencontrol i dpkg−genchanges zapiszą swoje informacje kontrolne (do źródłowego pliku .dsc w wypadku dpkg−source i na standardowe wyjście w wypadku dpkg−gencontrol i dpkg−genchanges), wykonują podstawienia pewnych zmiennych na pliku wyjściowym.
Podstawienie zmiennej ma postać ${nazwa−zmiennej}. 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 ${} (który nie jest poprawnym podstawieniem) jest zastępowane przez znak $.
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 Package, Source oraz Architecture.
Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline. This is done implicitly when the field is output. For example, if the variable ${Description} is set to "foo is bar.${Newline}foo is great." and if you have the following field:
Description:
foo application
${Description}
.
More text.
It will result in:
Description:
foo application
foo is bar.
foo is great.
.
More text.
Zmienne można ustawić za pomocą opcji −V. Można je także podać w pliku debian/substvars (lub jakimkolwiek innym pliku wskazanym opcją −T). Plik ten składa się z linii w postaci nazwa=wartość. Końcowe spacje w każdej linii, linie puste oraz linie zaczynające się od znaku # (czyli komentarze) są ignorowane.
Dodatkowo dostępne są następujące standardowe zmienne:
Arch |
Bieżąca architektura budowania (z dpkg −−print−architecture). |
source:Version
Wersja pakietu źródłowego
source:Upstream−Version
Oryginalna wersja autora pakietu źródłowego, włączając wersję epoki Debiana jeśli jest.
binary:Version
Wersja pakietu binarnego (może się różnić od source:Version na przykład w przypadku binNMU).
Source−Version
Wersja pakietu źródłowego (z dziennika zmian). Ta zmienna jest obecnie przestarzała, jako że jej znaczenie jest inne niż jej funkcjonalność. Prosimy używać source:Version lub binary:Version, w zależności od wymagań.
Installed−Size
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 dpkg−gencontrol użyje du −k debian/tmp, aby znaleźć jej wartość domyślną.
Extra−Size
Dodatkowa przestrzeń dyskowa, używana podczas instalowania pakietu. Jeśli ta zmienna jest ustawiona, to jej wartość jest dodawana do wartości zmiennej Installed−Size (niezależnie od tego, czy została otwarcie ustawiona, czy ma wartość domyślną), zanim zostania skopiowana do pola Installed−Size pliku kontrolnego.
F:nazwa−pola
Wartość pola wyjściowego nazwa_pola (które musi być podane z użyciem Notacji−Wielbłądziej). Ustawienie takich zmiennych wpływa tylko na miejsca, gdzie są one jawnie rozwijane.
Format |
Wersja formatu pliku .changes wygenerowana przez tę wersję skryptów przygotowujących pakiety źródłowe. Ustawienie tej zmiennej zmienia również zawartość pola Format w pliku .changes. |
Newline, Space, Tab
Każda z tych zmiennych zawiera odpowiadający jej znak.
shlibs:pole−zależności
Ustawienia zmiennych w tej postaci są generowane przez dpkg−shlibdeps.
dpkg:Upstream−Version
Oryginalna wersja dpkg, nadana przez autorów.
dpkg:Version
Pełna wersja programu dpkg.
Jeżeli jest odwołanie do niezdefiniowanej zmiennej, to generowane jest ostrzeżenie i przyjmowana jest pusta wartość zmiennej.
PLIKI
debian/substvars
Lista zmiennych podstawiania i ich wartości.
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.
ZOBACZ TAKŻE
dpkg(1), dpkg−genchanges(1), dpkg−gencontrol(1), dpkg−shlibdeps(1), dpkg−source(1).
AUTOR
Copyright
© 1995−1996 Ian Jackson
Copyright © 2000 Wichert Akkerman
Niniejszy program jest oprogramowaniem wolnym, sprawdź Powszechną Licencję Publiczną GNU w wersji drugiej lub późniejszej, by dowiedzieć się o warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.
TŁUMACZE
Piotr
Roszatycki <dexter [AT] debian.org>, 1999
Bartosz Feński <fenio [AT] debian.org>, 2004-2005
Robert Luberda <robert [AT] debian.org>, 2006-2008
Wiktor Wandachowicz <siryes [AT] gmail.com>, 2008