Provided by:
dpkg-dev_1.15.8.4ubuntu3_all 
NAZWA
deb-version - format numerw wersji pakietw Debiana
SKADNIA
[ epoka:] wersja_upstream [-rewizja_debiana ]
OPIS
Numery wersji uywane dla binarnych i rdowych pakietw Debiana skadaj si
z trzech czci. S to:
epoka Jest to pojedyncza (typowo niewielka), liczba cakowita bez
znaku. Moe by pominita, w takim przypadku jest przyjmowana jako
zero. Jeli jest pominita, wtedy wersja_upstream nie moe zawiera
adnego dwukropka.
Jest uywana aby mona byo pozby si pomyek w numerach wersji
starszych wersji pakietw, oraz poradzi sobie ze zmian
poprzednich schematw numerowania wersji.
wersja_upstream (wersja nadana przez autora)
Gwna cz numeru wersji. Zwykle jest to numer wersji oryginalnego
("upstream") pakietu, na podstawie ktrego powsta plik .deb, o
ile jest to moliwe. Typowo jest w tym samym formacie jaki zosta
uyty przez autora(w) pakietu. Moe jednak zosta przeformatowana
aby lepiej pasowa do formatu i schematu porwnywania wersji
uywanego przez system zarzdzania pakietami.
Poniej opisane jest zachowanie systemu zarzdzania pakietami
podczas porwnywania uwzgldniajcego wersj_upstream. Cz
wersja_upstream numeru wersji pakietu jest wymagana.
wersja_upstream moe zawiera jedynie znaki alfanumeryczne
("A-Za-z0-9") oraz znaki . + - : ~ (kropk, plus, mylnik,
dwukropek, tyld) i powinna zaczyna si od cyfry. Jeli nie jest
uywana rewizja_debiana, wtedy nie s dozwolone mylniki; jeli za
nie jest uywana epoka, wtedy nie s dozwolone dwukropki.
rewizja_debiana
Ta cz numeru wersji okrela wersj pakietu Debiana bazujcego na
tej samej wersji upstream. Moe zawiera jedynie znaki
alfanumeryczne oraz znaki + . (plus, kropk, tyld) i jest
porwnywana w ten sam sposb co wersja_upstream.
Jest to cz opcjonalna. Jeli nie jest uywana, wtedy
wersja_upstream nie moe zawiera dwukropka. Taki format odpowiada
przypadkowi, gdzie oprogramowanie byo tworzone z myl o zamianie
go w pakiet Debiana, wic jest tylko jedna jego "debianizacja" i
dlatego wskazywanie rewizji nie jest potrzebne.
Powszechnie przyjte jest rozpoczynanie rewizji_debiana od 1 za
kadym razem, gdy wersja_upstream si zwiksza.
Dpkg dzieli numer wersji na czci wzgldem ostatniego mylnika w
napisie (jeli taki jest), aby okreli wersj upstream oraz
rewizj_debiana. Przy porwnywaniu brakujca rewizja_debiana
poprzedza kade jej wystpienie (jednak warto pamita, e jest to
najmniej znaczca cz wumeru wersji).
Algorytm sortowania
System zarzdzania pakietami porwnuje wersj_upstream oraz rewizj_debiana
uywajc tego samego algorytmu:
Napisy s porwnywane od lewej do prawej.
Najpierw okrelane s pocztkowe czci kadego napisu, skadajce si wycznie
ze znakw nie bdcych cyframi. Te dwie czci (z ktrych jedna moe by pusta)
s porwnywane leksykalnie. Jeli zostanie znaleziona rnica, jest ona
zwracana. Porwnanie leksykalne jest porwnaniem wartoci ASCII
zmodyfikowanych tak, e wszystkie litery poprzedzaj wszystkie inne znaki
nie bdce literami, a dodatkowo tylda poprzedza wszystko, nawet koniec
czci. W nastpujcym przykadzie czci wystpuj w kolejnoci posortowanej:
"~~", "~~a", "~", cz pusta, "a".
Nastpnie okrelane s pocztki pozostaych czci z kadego napisu, skadajce
si wycznie z samych cyfr. Wartoci liczbowe tych dwch czci s porwnywane
i jeli zostanie znaleziona rnica, jest ona zwracana jako wynik
porwnania. Pusty cig znakw (ktry moe si pojawi jedynie na kocu jednego
lub obu porwnywanych napisw) jest przy tym liczony jako zero.
Te dwa kroki (porwnywanie i usuwanie pocztkowych napisw bez cyfr oraz
pocztkowych napisw z samymi cyframi) s powtarzane, a zostanie
znaleziona rnica lub oba cigi zostan wyczerpane.
Naley zauway, e celem epok jest umoliwienie pozbycia si pomyek w
numerach wersji pakietw, jak rwnie poradzenie sobie ze zmian schematu
numerowania wersji. Nie s one natomiast przeznaczone do radzenia sobie
z numerami wersji zawierajcych cigi znakw, ktrych system zarzdzania
pakietami nie moe zinterpretowa (jak np. "ALPHA" lub "pre-"), czy z inn
dziwn kolejnoci.
OSTRZEENIA
Znak tyldy oraz jego specyficzny sposb sortowania zostay wprowadzone w
wersji 1.10 dpkg, za niektre inne elementy dpkg-dev uzyskay odpowiednie
wsparcie dopiero pniej w serii 1.10.x.
ZOBACZ TAKE
deb-control(5), deb(5), dpkg(1)
AUTORZY
Copyright (C) 1996,1997,1998 Ian Jackson i Christian Schwarz
Copyright (C) 2007 Frank Lichtenheld
Niniejszy program jest oprogramowaniem wolnym, sprawd Powszechn Licencj
Publiczn GNU w wersji drugiej lub pniejszej, by dowiedzie si o
warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.
TUMACZE
Piotr Roszatycki <dexter@debian.org>, 1999
Bartosz Feski <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008