2.6 Osnove Git - Označevanje

Izpisovanje obstoječih oznak v Gitu je precej enostavno. Samo vpišite git tag (z možnostjo po izbiri -l ali --list):

Ta ukaz izpiše oznake v abecednem vrstnem redu; vrstni red, v katerem se pojavijo, nima neke prave pomembnosti.

Oznake, ki se prilegajo določenemu vzorcu, lahko tudi iščete. Izvorni repozitorij Git na primer vsebuje več kot 500 oznak. Če vas zanima pogledati samo serijo 1.8.5, lahko poženete to:

Git podpira dva tipa oznak: enostavne in anotirane.

Enostavna oznaka (angl. lightweight tag) je zelo podobna veji, ki se ne spremeni — je samo kazalec na določeno potrditev.

Anotirane oznake so po drugi strani shranjene kot polni objekti v podatkovni bazi Git. Imajo kontrolne vsote; vsebujejo ime, e-pošto in datum označevalca; imajo sporočilo oznake; in lahko so podpisane in preverjene z GNU Privacy Guard (GPG). V splošnem je priporočljivo, da ustvarjate anotirane oznake, da imate lahko vse te informacije; vendar če želite začasno oznako, ali zaradi kakšnega razloga ne želite ohraniti ostalih informacij, so na voljo tudi enostavne oznake.

Ustvarjanje anotirane oznake v Gitu je enostavno. Najenostavnejši način je določiti -a, ko poženete ukaz tag:

-m določa sporočilo označevanja, ki je shranjeno skupaj z oznako. Če ne določite sporočila za anotirano oznako, Git zažene vaš urejevalnik, da ga lahko vpišete vanj.

Z uporabo ukaza git show lahko pogledate podatke oznake skupaj s potrditvijo, ki je bila označena:

To pokaže informacije označitelja, datum potrditve, ko je bila označena, in sporočilo anotacije pred prikazom informacij potrditve.

Drug način označitve potrditve je enostavna oznaka. To je v osnovi kontrolna vsota potrditve shranjena v datoteki — ne ohrani se nobena druga informacija. Da ustvarite enostavno oznako, ne dodajte možnosti -a, -s ali -m, samo podajte ime oznake:

Tokrat, če poženete git show na oznaki, ne boste videli dodatnih informacij oznake. Ukaz samo prikazuje potrditev:

Potrditve lahko označite tudi za tem, ko ste se prestavili preko njih. Predpostavimo, da je vaša zgodovina potrditev videti takole:

Sedaj predpostavimo, da ste pozabili označiti projekt pri v1.2, ki je bil pri potrditvi »Update rakefile«. Lahko jo dodate za tem. Da označite to potrditev, na koncu ukaza določite kontrolno vsoto potrditve (ali del nje):

Vidite lahko, da ste označili potrditev:

Privzeto, ukaz git push ne prenese oznak na oddaljene strežnike. Morali boste eksplicitno poslati oznake na deljeni strežnik za tem, ko ste jih naredili. Ta proces je enak deljenju oddaljenih vej — lahko poženete git push origin <tagname>.

Če imate veliko oznak, ki jih želite poslati naenkrat, lahko uporabite tudi možnost --tags pri ukazu git push. To bo na oddaljeni strežnik preneslo vse vaše oznake, ki še niso tam.

Sedaj, ko nekdo drug klonira ali prenese iz vašega repozitorija, bo dobil tudi vse vaše oznake.

Da izbrišete oznako na svojem lokalnem repozitoriju, lahko uporabite git tag -d <tagname>. Na primer, našo enostavno oznako zgoraj bi lahko odstranili takole:

Bodite pozorni, saj to ne odstrani oznake iz nobenega oddaljenega strežnika. Obstajata dve pogosti variaciji za brisanje oznake iz oddaljenega strežnika.

Prva variacija je git push <remote> :refs/tags/<tagname>:

Način za interpretacijo zgornjega je to prebrati kot, vrednost null pred znakom dvopičja je poslan na oddaljeno ime oznake, kar jo ustrezno izbriše.

Drugi (in bolj intuitiven) način za brisanje oddaljene oznake je:

Če želite pogledati različice datotek, na katere oznaka kaže, lahko naredite git checkout določene oznake, vendar vam to vaš repozitorij da v »stanje ločene glave« (angl. detached HEAD state), kar ima določene stranske učinke:

Če v »stanju ločene glave« (angl. detached HEAD state) naredite spremembe in nato ustvarite potrditev, bo ostala oznaka enaka, vendar vaša nova potrditev ne bo pripadala nobeni veji in bo nedosegljiva, razen preko točne zgoščene vrednosti potrditve. Torej, če morate narediti spremembe — na primer, da popravljate hrošča na starejši verziji — boste na splošno želeli ustvariti vejo:

Če to naredite in naredite potrditev, bo vaša veja version2 malenkost drugačna od vaše oznake v2.0.0, saj ste se premaknili s spremembami naprej, torej bodite previdni.