![]() |
deb-substvars(5) |
![]() |
deb−substvars − zmienne podstawiania ¼ród³owych pakietów Debiana
substvars
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.
debian/substvars
Lista zmiennych podstawiania i ich warto¶ci.
Punkt, w którym nastêpuje nadpisywanie pól w porównaniu do pewnych standardowych ustawieñ pól wyj¶ciowych jest do¶æ zagmatwany.
dpkg(1), dpkg−genchanges(1), dpkg−gencontrol(1), dpkg−shlibdeps(1), dpkg−source(1).
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.
Piotr
Roszatycki <dexter@debian.org>, 1999
Bartosz Feñski <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008
![]() |
deb-substvars(5) | ![]() |