Provided by:
dpkg-dev_1.16.0.3ubuntu5_all 
NAZWA
deb-version - format numerow wersji pakietow Debiana
SK/LADNIA
[ epoka:] wersja_upstream [-rewizja_debiana ]
OPIS
Numery wersji uywane dla binarnych i rodlowych pakietow Debiana skladaj
si z trzech czci. S to:
epoka Jest to pojedyncza (typowo niewielka), liczba calkowita 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 bylo pozby si pomylek w numerach wersji
starszych wersji pakietow, oraz poradzi sobie ze zmian
poprzednich schematow numerowania wersji.
wersja_upstream (wersja nadana przez autora)
Glowna cz numeru wersji. Zwykle jest to numer wersji
oryginalnego ("upstream") pakietu, na podstawie ktorego powstal
plik .deb, o ile jest to moliwe. Typowo jest w tym samym
formacie jaki zostal uyty przez autora(ow) pakietu. Moe jednak
zosta przeformatowana aby lepiej pasowa do formatu i schematu
porownywania wersji uywanego przez system zarzdzania pakietami.
Poniej opisane jest zachowanie systemu zarzdzania pakietami
podczas porownywania 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
porownywana w ten sam sposob co wersja_upstream.
Jest to cz opcjonalna. Jeli nie jest uywana, wtedy
wersja_upstream nie moe zawiera dwukropka. Taki format odpowiada
przypadkowi, gdzie oprogramowanie bylo 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 porownywaniu brakujca rewizja_debiana
poprzedza kade jej wystpienie (jednak warto pamita, e jest to
najmniej znaczca cz wumeru wersji).
Algorytm sortowania
System zarzdzania pakietami porownuje wersj_upstream oraz
rewizj_debiana uywajc tego samego algorytmu:
Napisy s porownywane od lewej do prawej.
Najpierw okrelane s pocztkowe czci kadego napisu, skladajce si wylcznie
ze znakow nie bdcych cyframi. Te dwie czci (z ktorych jedna moe by
pusta) s porownywane leksykalnie. Jeli zostanie znaleziona ronica, jest
ona zwracana. Porownanie leksykalne jest porownaniem wartoci ASCII
zmodyfikowanych tak, e wszystkie litery poprzedzaj wszystkie inne znaki
nie bdce literami, a dodatkowo tylda poprzedza wszystko, nawet koniec
czci. W nastpujcym przykladzie czci wystpuj w kolejnoci posortowanej:
"~~", "~~a", "~", cz pusta, "a".
Nastpnie okrelane s pocztki pozostalych czci z kadego napisu, skladajce
si wylcznie z samych cyfr. Wartoci liczbowe tych dwoch czci s
porownywane i jeli zostanie znaleziona ronica, jest ona zwracana jako
wynik porownania. Pusty cig znakow (ktory moe si pojawi jedynie na kocu
jednego lub obu porownywanych napisow) jest przy tym liczony jako zero.
Te dwa kroki (porownywanie i usuwanie pocztkowych napisow bez cyfr oraz
pocztkowych napisow z samymi cyframi) s powtarzane, a zostanie
znaleziona ronica lub oba cigi zostan wyczerpane.
Naley zauway, e celem epok jest umoliwienie pozbycia si pomylek w
numerach wersji pakietow, jak rownie poradzenie sobie ze zmian schematu
numerowania wersji. Nie s one natomiast przeznaczone do radzenia sobie
z numerami wersji zawierajcych cigi znakow, ktorych system zarzdzania
pakietami nie moe zinterpretowa (jak np. "ALPHA" lub "pre-"), czy z inn
dziwn kolejnoci.
OSTRZEENIA
Znak tyldy oraz jego specyficzny sposob sortowania zostaly wprowadzone
w wersji 1.10 dpkg, za niektore inne elementy dpkg-dev uzyskaly
odpowiednie wsparcie dopiero poniej 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 poniejszej, by dowiedzie si o
warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.
T/LUMACZE
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