Manpages

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