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.

       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
       ${Description}  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 -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.

ZOBACZ TAKŻE

       dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1), dpkg-source(1).

TŁUMACZE

       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
       Michał Kułach <michal.kulach@gmail.com>, 2012