TortoiseSVN beží na systéme Windows Vista alebo novšom a je k dispozícii v 32-bitovej aj 64-bitovej verzii. Inštalátor pre 64-bitový Windows obsahuje aj 32-bitové rozšírenia. Čo znamená, že pre získanie kontextovej ponuky TortoiseSVN a prekrytí v 32-bitových aplikáciách nemusíte inštalovať 32-bitovú verziu osobitne.

Podpora Windows 98, Windows ME a Windows NT4 bola vo verzii 1.2.0 zrušená a podpora Windows 2000 a XP až do SP2 bola zrušená vo verzii 1.7.0. Podpora pre Windows XP s SP3 bola v 1.9.0 zrušená. V prípade potreby si môžete stiahnuť a nainštalovať staršie verzie.

TortoiseSVN sa dodáva s ľahko použiteľným inštalátorom. Dvakrát kliknite na inštalačný súbor a postupujte podľa pokynov. O zvyšok sa postará inštalátor. Po inštalácii nezabudnite reštartovať.

K dispozícii sú jazykové balíčky, ktoré prekladajú užívateľské rozhranie TortoiseSVN do mnohých rôznych jazykov. Skontrolujte, prosím, Dodatok G, Jazykové balíčky a kontrola pravopisu pre ďalšie informácie o tom, ako ich nainštalovať.

Ak narazíte na problémy počas alebo po inštalácie TortoiseSVN, prečítajte si naše online FAQ na adrese https://tortoisesvn.net/faq.html .

Pre skutočný projekt budete mať úložisko nastavené niekde v bezpečí a server Subversion ho bude ovládať. Na účely tohto tutoriálu budeme používať funkciu miestneho úložiska Subversion, ktorá umožňuje priamy prístup k úložisku vytvorenému na vašom pevnom disku bez potreby servera.

Najskôr vytvorte vo svojom počítači nový prázdny priečinok. Môže prejsť kamkoľvek, ale v tomto tutoriáli to nazveme C:\svn_repos. Teraz kliknite pravým tlačidlom myši na nový priečinok a z kontextovej ponuky vyberte TortoiseSVN → Tu vytvoriť úložisko.... Úložisko sa potom vytvorí vo vnútri priečinka a je pripravené na použitie. Vytvoríme predvolenú štruktúru interných priečinkov kliknutím na tlačidlo Vytvoriť štruktúru priečinkov.

Teraz máme úložisko, ktoré je však momentálne úplne prázdne. Predpokladajme, že máme sústavu súborov v priečinku C:\Projekty\Widget1, ktorú chceme pridať. Prejdite na priečinok Widget1 v Prieskumníkovi a kliknite naň pravým tlačidlom myši. Teraz vyberte TortioiseSVN → Importovať..., ktorý vyvolá dialógové okno:

Obrázok 1.2. Dialógové okno importu

Na úložisko Subversion sa odkazuje adresou URL, ktorá nám umožňuje určiť úložisko kdekoľvek na internete. V tomto prípade musíme ukázať na svoje vlastné lokálne úložisko, ktoré má URL file: ///c:/svn_repos/trunk a ku ktorému pridáme vlastný názov projektu Widget1. Upozorňujeme, že za nimi sú tri lomky file: a že lomky sa používajú v celom texte.

Ďalšou dôležitou vlastnosťou tohto dialógového okna je textové políčko Importovať správu, ktoré vám umožní zadať správu popisujúcu, čo robíte. Keď sa pozriete do histórie projektu, tieto správy o odovzdaní sú cenným sprievodcom o tom, aké zmeny a prečo boli urobené. V tomto prípade môžeme povedať niečo jednoduché ako “Import projektu Widget1”. Kliknite na OK a priečinok je pridaný do vášho úložiska.

Teraz, keď máme v našom úložisku projekt, musíme vytvoriť pracovnú kópiu, ktorú budeme používať na každodennú prácu. Upozorňujeme, že akt importu priečinka tento priečinok automaticky nezmení na funkčnú kópiu. Termín Subversion na vytvorenie novej pracovnej kópie je Overenie . Chystáme sa overiť priečinok Widget1 v našom úložisku do vývojového priečinka na počítači s názvom C:\Projects\Widget1-Dev. Vytvorte tento priečinok, kliknite naň pravým tlačidlom myši a vyberte TortoiseSVN → Overiť.... V takom prípade zadajte adresu URL úložiska file:///c:/svn_repos/trunk/Widget1 a kliknite na OK. Náš vývojový priečinok je potom naplnený súbormi z úložiska.

Všimnete si, že vzhľad tohto priečinka sa líši od nášho pôvodného priečinka. Každý súbor má v ľavom dolnom rohu zelenú značku zaškrtnutia. Toto sú ikony stavu TortoiseSVN, ktoré sa nachádzajú iba v pracovnej kópii. Zelený stav označuje, že súbor nie je zmenený od verzie v úložisku.

Čas sa pustiť do práce. V priečinku Widget1-Dev začneme upravovať súbory - povedzme, že urobíme zmeny v priečinku Widget1.c a ReadMe.txt. Všimnite si, že prekrytia ikony na týchto súboroch sa teraz zmenili na červenú, čo znamená, že boli vykonané lokálne zmeny.

Aké sú však zmeny? Pravým tlačidlom myši kliknite na jeden zo zmenených súborov a vyberte možnosť TortoiseSVN → Odlišnosti. Spustí sa nástroj na porovnávanie súborov TortoiseSVN, ktorý vám presne ukáže, ktoré riadky sa zmenili.

Obrázok 1.3. Prehliadač odlišností súborov

Fajn, takže sme spokojní so zmenami, poďme aktualizovať úložisko. Táto akcia sa označuje ako Odovzdať zmeny. Kliknite pravým tlačidlom myši na ikonu priečinok Widget1-Dev a vyberte TortoiseSVN → Odovzdať. Dialógové okno potvrdenia obsahuje zoznam zmenených súborov, každý so zaškrtávacím políčkom. Možno si budete chcieť zvoliť iba časť týchto súborov, ale v takom prípade vykonáme zmeny v obidvoch súboroch. Zadajte správu, v ktorej popíšete, čoho sa zmena týka a kliknite na OK. Dialógové okno priebehu zobrazuje súbory, ktoré sa nahrávajú do úložiska a ste hotoví.

S vývojom projektu budete musieť pridávať nové súbory - povedzme, že do nich pridáte niekoľko nových funkcií Extras.c a pridáte odkaz na existujúci Makefile. Kliknite pravým tlačidlom myši na priečinok TortoiseSVN → Pridať. Dialógové okno Pridať teraz zobrazuje všetky súbory bez verzie a môžete si vybrať, ktoré chcete pridať. Ďalším spôsobom pridávania súborov by bolo kliknutie pravým tlačidlom myši na samotný súbor a výber TortoiseSVN → Pridať .

Keď teraz prejdete na odovzdanie priečinka, nový súbor sa zobrazí ako Pridané a existujúci súbor ako Zmenený. Dvojitým kliknutím na zmenený súbor môžete skontrolovať, aké zmeny boli vykonané.

Jednou z najužitočnejších funkcií TortoiseSVN je dialógové okno záznamu. Zobrazí sa zoznam všetkých odovzdaní, ktoré ste vykonali v súbore alebo priečinku a podrobné správy o odovzdaní, ktoré ste zadali (urobili ste správu o odovzdaní podľa návrhu? Ak nie, teraz vidíte, prečo je to dôležité).

Obrázok 1.4. Dialóg záznamu

OK, tak som tu trochu podvádzal a použil som snímku obrazovky z úložiska TortoiseSVN.

Horný panel ukazuje zoznam odovzdaných revízií spolu so počiatočnou správou o odovzdaní. Ak vyberiete jednu z týchto revízií, na strednom paneli sa zobrazí úplná správa protokolu pre danú revíziu a na dolnom paneli sa zobrazí zoznam zmenených súborov a priečinkov.

Každý z týchto panelov má kontextovú ponuku, ktoré vám poskytuje viacero spôsobov použitia týchto informácií. Na spodnom paneli môžete použiť dvojklik na súbor, aby ste presne videli, aké zmeny sa v tejto revízii vykonali. Prečítaním “Dialógové okno záznamu revízií” získate celý príbeh.

Jednou z funkcií všetkých systémov kontroly revízií je, že vám umožňujú vrátiť späť zmeny, ktoré ste vykonali predtým. Ako by ste čakali, TortoiseSVN uľahčuje prístup k nim.

Ak sa chcete zbaviť zmien, ktoré ste ešte neodovzdali a resetovať súbor do pôvodného stavu pred začatím úprav, TortoiseSVN → Vrátiť je tvoj priateľ. Ten zahodí vaše zmeny (pre každý prípad do koša) a vráti sa k potvrdenej verzii, s ktorou ste začali. Ak sa chcete zbaviť iba niektorých zmien, môžete použitím TortoiseMerge zobraziť rozdiely a selektívne vrátiť zmenené riadky.

Ak chcete vrátiť späť účinky konkrétnej revízie, začnite dialógom záznamu a vyhľadajte príslušnú revíziu. Vyberte Kontextová ponuka → Vrátiť zmeny od tejto revízie a tieto zmeny sa vrátia späť.

Zvážte tento scenár: Predpokladajme, že máme dvoch spolupracovníkov, Harryho a Sally. Každý z nich sa rozhodne upraviť rovnaký súbor úložiska súčasne. Ak Harry najskôr uloží svoje zmeny do úložiska, je možné, že (o chvíľu neskôr) ich Sally mohla omylom prepísať svojou novou verziou súboru. Zatiaľ čo Harryho verzia súboru sa nestratí navždy (pretože si systém pamätá každú zmenu), všetky Harryho urobené zmeny nebudú prítomné v novšej verzii súboru Sally, pretože nikdy nevidela Harryho zmeny. Harryho práca je stále skutočne stratená - alebo prinajmenšom chýba v najnovšej verzii súboru - a pravdepodobne náhodne. To je iste tá situácia, ktorej sa chceme vyhnúť!

Obrázok 2.2. Problém, ktorému sa treba vyhnúť

Mnoho systémov na správu verzií používa model zamknúť-upraviť-odomknúť na riešenie tohto problému, čo je veľmi jednoduché riešenie. V takomto systéme úložisko umožňuje zmeniť súbor naraz iba jednej osobe. Najprv musí Harry zamknúť súbor, skôr ako v ňom bude môcť robiť zmeny. Zamknutie súboru je ako požičanie si knihy z knižnice; ak Harry zamkol súbor, potom Sally v ňom nemôže robiť žiadne zmeny. Ak sa pokúsi zamknúť súbor, úložisko zamietne požiadavku. Jediné, čo môže urobiť, je prečítať si súbor a počkať, kým Harry dokončí svoje zmeny a uvoľní svoj zámok. Keď Harry odomkne priečinok, jeho úkon je ukončený a teraz ho môže Sally zamknúť a upraviť.

Obrázok 2.3. Riešenie Zamknúť-Upraviť-Odomknúť

Problémom modelu zamknúť-upraviť-odomknúť je, bohužiaľ je trochu obmedzújci a často vedie k odradeniu užívateľov:

Subversion, CVS a ďalšie systémy na správu verzií používajú modul kopírovať-upraviť-zlúčiť ako alternatívu k zamykaniu. V tomto modeli klient každého používateľa načíta úložisko a vytvára osobné údaje pracovnej kópie súboru alebo projektu. Používatelia potom pracujú paralelne a upravujú svoje súkromné kópie. Nakoniec sa súkromné kópie zlúčia do novej finálnej verzie. Systém správy verzií často pomáha pri zlúčení, ale za správne uskutočnenie je v konečnom dôsledku zodpovedný človek.

Tu je príklad. Povedzme, že Harry a Sally vytvoria pracovné kópie toho istého projektu skopírované z úložiska. Pracujú súčasne a vykonávajú zmeny v rovnakom súbore A v rámci svojich kópií. Sally najskôr uloží svoje zmeny do úložiska. Keď sa Harry pokúsi svoje zmeny uložiť neskôr, úložisko ho informuje, že jeho súbor A je zastaralý. Inými slovami, tento súbor A v úložisku sa od posledného skopírovania nejako zmenil. Harry teda požiada svojho klienta o zlúčenie akékoľvek nových zmien z úložiska do jeho pracovnej kópie súboru A. Je pravdepodobné, že sa zmeny Sally nekryjú s tými jeho; takže akonáhle má obe sústavy zmien integrované, uloží svoju pracovnú kópiu späť do úložiska.

Obrázok 2.4. Riešenie Kopírovať-Upraviť-Zlúčiť

Obrázok 2.5. ...pokračovanie Kopírovať-Upraviť-Zlúčiť

Ale čo keď sa zmeny urobené Sally kryjú sa s Harryho zmenami? Čo potom? Táto situácia sa nazýva konflikt a zvyčajne to nie je veľký problém. Keď Harry požiada svojho klienta, aby zlúčil najnovšie zmeny v úložisku do svojej pracovnej kópie, jeho kópia súboru A je nejakým spôsobom označená ako konfliktná: bude schopný vidieť obidve sady konfliktných zmien, medzi ktorými si môže ručne vybrať. Softvér nedokáže automaticky vyriešiť konflikty; iba ľudia sú schopní pochopiť a urobiť potrebné inteligentné rozhodnutia. Keď Harry ručne vyrieši kryjúce sa zmeny (možno diskusiou o konflikte so Sally!), môže bezpečne uložiť zlúčený súbor späť do úložiska.

Model kopírovania, úpravy a zlúčenia môže znieť trochu chaoticky, ale v praxi beží mimoriadne hladko. Používatelia môžu pracovať paralelne a nikdy na seba nečakať. Keď pracujú na rovnakých súboroch, ukázalo sa, že väčšina ich súbežných zmien sa vôbec neprekrýva; konflikty sú zriedkavé. A čas potrebný na riešenie konfliktov je oveľa menší ako čas stratený uzamykacím systémom.

Nakoniec to všetko závisí od jedného zásadného faktora: komunikácie používateľov. Keď používatelia zle komunikujú, narastajú syntaktické aj konflikty významu. Žiadny systém nemôže prinútiť používateľov dokonale komunikovať a žiadny systém nedokáže zistiť konflikty významu. Takže nemá zmysel nechať sa opájať falošným prísľubom, že uzamykací systém nejako zabráni konfliktom; v praxi sa zdá, že blokovanie brzdí produktivitu viac ako čokoľvek iné.

Existuje jedna bežná situácia, keď model uzamknutia, úpravy a odomknutia vyjde lepšie, a to je prípad, keď máte nezmeniteľné súbory. Napríklad ak vaše úložisko obsahuje niektoré grafické obrázky a dvaja ľudia ho menia súčasne, neexistuje žiadny spôsob, ako by sa tieto zmeny spojili. Harry alebo Sally prídu o svoje zmeny.

Subversion štandardne používa riešenie kopírovanie-úprava-zlúčenie a v mnohých prípadoch je to všetko, čo kedy budete potrebovať. Od verzie 1.2 však Subversion podporuje aj zamykanie súborov, takže ak máte nezmeniteľné súbory alebo ak vás vedenie jednoducho prinúti k politike uzamknutia, Subversion bude stále poskytovať potrebné funkcie.

O pracovných kópiách ste už čítali; teraz si ukážeme, ako ich klient Subversion vytvára a používa.

Pracovná kópia Subversion je obyčajný strom priečinkov vo vašom lokálnom systéme, ktorý obsahuje kolekciu súborov. Tieto súbory môžete ľubovoľne upravovať a ak sa jedná o súbory zdrojových kódov, môžete z nich obvyklým spôsobom zostaviť svoj program. Vaša pracovná kópia je vaša vlastná súkromná pracovná oblasť: Subversion nikdy nebude obsahovať zmeny iných ľudí ani nesprístupní vaše vlastné zmeny ostatným, pokiaľ im to výslovne nepoviete.

Po vykonaní zmien v pracovnej kópii a overení ich správneho fungovania vám Subversion poskytne príkazy zverejnenia vašich zmien ostatným ľuďom, ktorí s vami pracujú na vašom projekte (zápisom do úložiska). Ak iní ľudia zverejnia svoje vlastné zmeny, Subversion vám poskytne príkazy na zlúčenie týchto zmien do vášho pracovného priečinka (čítaním z úložiska).

Pracovná kópia obsahuje aj niekoľko súborov navyše, ktoré vytvoril a udržiava Subversion, aby im pomohol vykonávať tieto príkazy. Pracovná kópia obsahuje najmä podpriečinok s názvom .svn , tiež známy ako pracovná kópia administratívny priečinok . Súbory v tomto administratívnom priečinku pomáhajú programu Subversion rozpoznať, ktoré súbory obsahujú nepublikované zmeny a ktoré súbory sú zastaralé, pokiaľ ide o prácu ostatných. Pred 1.7 Subversion udržiavané .svn administratívne podpriečinky v každom priečinku verzie vašej pracovnej kópie. Subversion 1.7 má úplne odlišný prístup a každá pracovná kópia má teraz iba jeden administratívny podpriečinok, ktorý je bezprostredným potomkom koreňa tejto pracovnej kópie.

Typické úložisko Subversion často obsahuje súbory (alebo zdrojové kódy) pre niekoľko projektov; obvykle je každý projekt podpriečinkom v strome súborového systému úložiska. V tomto usporiadaní bude pracovná kópia používateľa obvykle zodpovedať konkrétnemu podstromu úložiska.

Predpokladajme napríklad, že máte úložisko, ktoré obsahuje dva softvérové projekty.

Obrázok 2.6. Súborový systém úložiska

Inými slovami, koreňový priečinok úložiska má dva podpriečinky: paint a calc .

Ak chcete získať pracovnú kópiu, musíte overiť nejaký podstrom úložiska. (Termín overiť môže to znieť, akoby to malo niečo spoločné so zamykaním alebo rezervovaním zdrojov, ale nie je to tak; jednoducho vám vytvorí súkromnú kópiu projektu.)

Predpokladajme, že v ňom urobíte zmeny v button.c . Keďže .svn priečinok si pamätá dátum zmeny súboru a pôvodný obsah, Subversion môže zistiť, že ste súbor zmenili. Subversion však vaše zmeny nezverejní, kým im to výslovne nepoviete. Akt zverejnenia vašich zmien je všeobecne známejší ako odovzdanie (alebo overenie ) zmien v úložisku.

Ak chcete zverejniť svoje zmeny ostatným, môžete použiť Subversion odovzdať príkaz.

Teraz vaše zmeny v button.c boli odovzdané do úložiska; ak si iný užívateľ overí pracovnú kópiu /calc, uvidí vaše zmeny v najnovšej verzii súboru.

Predpokladajme, že máte spolupracovníčku Sally, ktorá si pozrela pracovnú kópiu /calc v rovnakom čase. Keď odovzdáte svoju zmenu button.c, pracovná kópia Sally zostáva nezmenená; Subversion upravuje pracovné kópie iba na žiadosť používateľa.

Sally môže požiadať Subversion o aktualizáciu projektu aktualizovaním svojej pracovnej kópie použitím príkazu Subversion aktualizovať. Vaše zmeny sa zapracujú do jej pracovnej kópie, ako aj do všetkých ďalších, ktoré boli odovzdané od jej overenia.

Všimnite si, že Sally nemusela určovať, ktoré súbory má aktualizovať; Subversion využíva informácie v priečinku .svn a ďalšie informácie v úložisku, aby sa rozhodol, ktoré súbory je potrebné aktualizovať.

K úložiskám Subversion je možné pristupovať rôznymi spôsobmi - na lokálnom disku alebo cez rôzne sieťové protokoly. Umiestnením úložiska je však vždy adresa URL. Schéma adresy URL označuje spôsob prístupu:

Adresy URL Subversion väčšinou používajú štandardnú syntax, ktorá umožňuje špecifikovať názvy serverov a čísla portov ako súčasť adresy URL. The file: // metóda prístupu sa zvyčajne používa na miestny prístup, aj keď ju možno použiť s cestami UNC k sieťovému hostiteľovi. URL má preto formu file://hostname/path/to/repos. Pre miestny stroj je to hostname časť adresy URL musí byť buď neprítomná, alebo localhost. Z tohto dôvodu sa lokálne cesty zvyčajne zobrazujú s tromi lomkami, file:///path/to/repos .

Taktiež užívatelia systému file:// na platformách Windows bude musieť používať neoficiálne “štandardnú” syntax pre prístup k úložiskám, ktoré sú na rovnakom stroji, ale na inej jednotke ako je aktuálna pracovná jednotka klienta. Kde bude fungovať ktorákoľvek z dvoch nasledujúcich syntaxí cesty URL X je jednotka, na ktorej sa nachádza úložisko:

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...
      

Upozorňujeme, že adresa URL používa bežné lomky, aj keď natívna (nie URL) forma cesty v systéme Windows používa spätné lomky.

K úložisku FSFS máte prístup cez zdieľanie v sieti, ale je to neodporúčané z rôznych dôvodov:

Operácia SVN odovzdať môže publikovať zmeny v ľubovoľnom počte súborov a priečinkov ako jednu čiastkovú transakciu. V pracovnej kópii môžete meniť obsah súborov, vytvárať, odtraňovať, premenovávať a kopírovať súbory a priečinky a potom vykonať celú sústavu zmien ako celok.

V úložisku sa s každým potvrdením zaobchádza ako s čiastkovou transakciou: buď dôjde ku všetkým zmenám odovzdania, alebo k žiadnej z nich. Subversion si zachováva túto atomárnosť navzdory zlyhaniu programu, zlyhaniu systému, problémom so sieťou a akciám iných používateľov.

Zakaždým, keď úložisko prijme odovzdanie, vytvorí sa nový stav stromu súborového systému, ktorý sa nazýva revízia . Každej revízii je priradené jedinečné prirodzené číslo, o jedno väčšie ako číslo predchádzajúcej revízie. Počiatočná revízia čerstvo vytvoreného úložiska má číslovanie nula a pozostáva iba z prázdneho koreňového priečinka.

Príjemným spôsobom vizualizácie úložiska je séria stromov. Predstavte si pole čísel revízií, začínajúce od 0, ktoré sa tiahnu zľava doprava. Každé číslo revízie má pod sebou zavesený strom súborového systému a každý strom je “snímka” spôsobu, akým sa úložisko staralo o každé odovzdanie.

Obrázok 2.7. Úložisko

Je dôležité si uvedomiť, že pracovné kópie nie vždy zodpovedajú akejkoľvek jednej revízii v úložisku; môžu obsahovať súbory z niekoľkých rôznych revízií. Predpokladajme napríklad, že ste si skontrolovali pracovnú kópiu z úložiska, ktorého posledná revízia je 4:

calc/Makefile:4
integer.c:4
button.c:4
      

V súčasnosti tento pracovný priečinok presne zodpovedá revízii 4 v úložisku. Predpokladajme však, že urobíte zmenu v súbore button.c a odovzdéte túto zmenu. Za predpokladu, že sa neuskutočnili žiadne ďalšie odovzdania, vytvorí sa vaše odovzdanie revíziu 5 úložiska a vaša pracovná kópia bude teraz vyzerať takto:

calc/Makefile:4
integer.c:4
button.c:5
      

Predpokladajme, že v tomto okamihu sa Sally odovzdáva zmeny súboru integer.c , vytvorí revíziu 6. Ak použijete príkaz SVN aktualizácia, aby bola vaša pracovná kópia aktuálna, bude vyzerať takto:

calc/Makefile:6
integer.c:6
button.c:6
      

Zmena, vykonaná Sally v súbore integer.c sa objaví vo vašej pracovnej kópii a vaša zmena bude stále prítomná v súbore button.c. V tomto príklade je text z Makefile je identický v revíziách 4, 5 a 6, ale Subversion označí vašu pracovnú kópiu Makefile revíziou 6, čo značí, že je stále aktuálna. Takže po vašom vyčistení aktualizácie na vrchu pracovnej kópie bude všeobecne zodpovedať presne jednej revízii v úložisku.

Pre každý súbor v pracovnom priečinku Subversion zaznamená dve základné informácie v administratívnej oblasti .svn /:

Na základe týchto informácií môže Subversion rozhovorom s úložiskom zistiť, v ktorom z nasledujúcich štyroch stavov sa pracovný súbor nachádza:

Teraz máte nové úložisko umiestnené na D:\SVN\MyNewRepository.

Pre prístup k lokálnemu úložisku potrebujete cestu k tomuto priečinku. Pamätajte, že Subversion očakáva všetky cesty úložiska vo forme file:///C:/SVNRepository/. Všimnite si použitie lomiek v celom texte.

Ak chcete získať prístup k úložisku umiestnenému v zdieľanej sieti, môžete použiť mapovanie jednotiek alebo cestu UNC. Pre cesty UNC je formulár file://ServerName/path/to/repos/ . Upozorňujeme, že tu sú iba dve úvodné lomky.

Pred SVN 1.2 sa cesty UNC museli uvádzať v nejasnejšej podobe file:///\ServerName/path/to/repos. Táto forma je stále podporovaná, ale neodporúča sa.

Aj keď teoreticky je možné umiestniť úložisko FSFS na zdieľanie v sieti a umožniť mu prístup viacerým používateľom protokolom file://, toto je určite nie je odporúčané. V skutočnosti vás dôrazne od toho odrádzame a nepodporujeme takéto použitie z rôznych dôvodov:

Prístup file:// je určený iba pre lokálny prístup samostatného užívateľa, najmä na testovanie a ladenie. Keď chcete skutočne zdieľať úložisko musíte nastaviť správny server a nie je to ani zďaleka také ťažké, ako si myslíte. Prečítaním “Prístup do úložiska” nájdete pokyny pre výber a nastavenie servera.

Pred importom údajov do úložiska by ste si mali najskôr premyslieť, ako chcete svoje údaje usporiadať. Ak použijete jedno z odporúčaných usporiadaní, budete to mať neskôr oveľa jednoduchšie.

Existuje niekoľko štandardných odporúčaných spôsobov usporiadania úložiska. Väčšina ľudí vytvára kmeňový priečinok na udržiavanie “hlavná línie” vývoja, priečinok vetiev, ktorý obsahuje kópie vetiev, priečinok príznakov, ktorý obsahuje kópie príznakov. Ak úložisko obsahuje iba jeden projekt, ľudia si často vytvárajú tieto priečinky najvyššej úrovne:

/trunk
/branches
/tags
    

Pretože toto rozloženie je tak bežne používané, pri vytváraní nového úložiska aplikáciou TortoiseSVN ponúkne vytvorenie štruktúry priečinkov aj pre vás.

Ak úložisko obsahuje viac projektov, ľudia často indexujú svoje rozloženie podľa vetiev:

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

...alebo podľa projektu:

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

Indexovanie podľa projektu má zmysel, ak projekty spolu úzko nesúvisia a každý z nich sa kontroluje individuálne. Pre súvisiace projekty, kde môžete overiť všetky projekty naraz, alebo kde sú všetky projekty spojené do jedného distribučného balíka, je často lepšie indexovať podľa vetiev. Týmto spôsobom máte k dispozícii iba jeden kmeňový server na overenie a vzťahy medzi podprojektami sú ľahšie viditeľné.

Ak prijmete najvyššiu úroveň prístupu /trunk /tags /branches, nedá sa povedať, že musíte skopírovať celý kmeň pre každú vetvu a príznak. V niektorých ohľadoch ponúka táto štruktúra väčšiu flexibilitu.

Pre nesúvisiace projekty môžete radšej použiť samostatné úložiská. Keď vykonáte zmeny, zmení sa iba číslo revízie celého úložiska, nie číslo revízie projektu. Zdieľanie úložiska s 2 nesúvisiacimi projektmi môže znamenať veľké medzery v číslach revízií. Projekty Subversion a TortoiseSVN sa objavujú na rovnakej adrese hostiteľa, ale sú to úplne samostatné úložiská, ktoré umožňujú nezávislý vývoj a nedochádza k nejasnostiam v číslach zostavenia.

Tieto bežné usporiadania môžete samozrejme ignorovať. Môžete vytvoriť akýkoľvek druh variácie, čo bude pre vás alebo váš tím najlepšie vyhovovať. Pamätajte, že čokoľvek si vyberiete, nejde o trvalý záväzok. Svoje úložisko môžete kedykoľvek usporiadať. Pretože vetvy a značky sú obyčajné priečinky, TortoiseSVN ich môže presúvať alebo premenovávať, ako chcete.

Prechod z jedného rozloženia na druhé je iba otázkou vydania série pohybov na strane servera; Ak sa vám nepáči, ako sú veci v úložisku organizované, jednoducho pohrajte sa s priečinkami.

Takže ak ste vo svojom úložisku ešte nevytvorili základnú štruktúru priečinkov, mali by ste to urobiť teraz. Existujú dva spôsoby, ako to dosiahnuť. Ak si chcete jednoducho vytvoriť štruktúru /trunk /tags /branches môžete na vytvorenie troch priečinkov (v troch samostatných potvrdeniach) použiť prehliadač úložiska. Ak chcete vytvoriť hlbšiu hierarchiu, je jednoduchšie najskôr vytvoriť štruktúru priečinkov na disku a importovať ich v jednom potvrdení, napríklad takto:

Upozorňujeme, že názov priečinka, ktorý importujete, sa v úložisku nezobrazuje, iba jeho obsah. Napríklad vytvorte nasledujúcu štruktúru priečinkov:

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags
      

ImportC:\Temp\New do koreňového úložiska, ktorý potom bude vyzerať takto:

/trunk
/branches
/tags
      

Obrázok 4.1. Prekrytie ikon zobrazované v Prieskumníkovi

Jedna z najviditeľnejších vlastností TortoiseSVN sú prekrytia ikon, ktoré sa objavia na súboroch vašej pracovnej kópie. Tieto vám ukazujú, ktoré súbory boli zmenené. Pozrite si “Prekrytie ikon”, aby ste mali prehľad čo rôzne prekrytia znamenajú.

Obrázok 4.2. Kontextová ponuka pre priečinok pod správoi verzie

Všetky príkazy TortoiseSVN sa vyvolávajú z kontextovej ponuky prieskumníka Windows. Väčšina sú priamo viditeľné, keď kliknite pravým tlačidlom myši na súbor alebo priečinok. Dostupné príkazy závisia od toho, či je súbor alebo priečinok alebo jeho nadradený priečinok pod kontrolou verzie alebo nie. Ponuku TortoiseSVN môžete vidieť aj ako súčasť ponuky súborov programu Explorer.

V niektorých prípadoch môžete vidieť niekoľko záznamov TortoiseSVN. Toto nie je chyba!

Obrázok 4.3. Ponuka súborov Prieskumníka pre skratku vo verziovom priečinku

Tento príklad je pre bezverziovú skratku vo verziovom priečinku a v nachádzajú sa v ponuke súborov Prieskumníka tri položky pre TortoiseSVN. Jedna je pre priečinok, druhá pre samotnú skratku a tretia pre objekt, na ktorý skratka ukazuje. Aby ste ich mohli lepšie rozlíšiť, majú ikony v pravom dolnom rohu indikátor, ktorý ukazuje, či je položka ponuky pre súbor, priečinok, skratku alebo pre viac vybraných položiek.

Obrázok 4.4. Ťahajte ponuku pravým pre priečinok pod správou verzie

Ostatné príkazy sú k dispozícii ako manupilátory ťahania, ak ťaháte pravým súbory alebo priečinky na nové miesto vo vnútri pracovných kópií alebo keď ťaháte pravým bezverziový súbor alebo priečinok do priečinka so správou verzií.

Niektoré bežné operácie majú známe skratky systému Windows, ale nezobrazujú sa na tlačidlách ani v ponukách. Ak nemôžete prísť na to, ako urobiť niečo očividné, ako je napríklad obnovenie pohľadu, skontrolujte to tu.

Ak je úložisko, do ktorého sa pokúšate dostať, chránené heslom, zobrazí sa dialógové okno autentifikácie.

Obrázok 4.5. Dialógové okno autentifikácie

Zadajte svoje užívateľské meno a heslo. Toto zaškrtávacie políčko spôsobí, že TortoiseSVN uloží prihlasovacie údaje do predvoleného priečinka Subversion: %APPDATA%\Subversion\auth v troch podpriečinkoch:

Ak chcete vyčistiť zásobník autentifikácie, môžete to urobiť zo stránky Uložené údaje dialógového okna nastavení TortoiseSVN. TlačidloVyčistiť všetko vyčistí autentifikačné údaje zo zásobníka pre všetky úložiská. Tlačidlo Vyčistiť... zobrazí však dialógové okno, v ktorom môžete zvoliť, ktoré údaje z autentifikácie uložené v zásobníku sa majú vyčistiť. Odkazujú na “Nastavenia Uložené údaje” .

Niektorí ľudia radi odstraňujú autentifikačné údaje pri odhlásení zo systému Windows alebo pri vypnutí. Spôsob, ako to urobiť, je použiť vypínací skript na odstránenie priečinka %APPDATA%\Subversion\auth, napr.

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"
      

Popis spôsobu inštalácie týchto skriptov nájdete na stránke http://www.windows-help-central.com/windows-shutdown-script.html.

Viac informácií o tom, ako nastaviť váš server na autentifikáciu a riadenie prístupu, nájdete na “Prístup do úložiska”.

Mnoho dialógov TortoiseSVN obsahuje veľa informácií, ktoré je možné zobraziť, ale často je užitočné maximalizovať iba výšku alebo iba šírku, než maximalizovať vyplnenie obrazovky. Kvôli pohodliu na to existujú skratky tlačidla Maximalizovať. Použite prostredné tlačidlo myši na vertikálnu maximalizáciu a pravé tlačidlo myši pre horizontálnu maximalizáciu.

Ak importujete do existujúceho úložiska, ktoré už obsahuje niektoré projekty, bude o štruktúre úložiska už rozhodnuté. Ak importujete údaje do nového úložiska, mali by ste si urobiť čas a rozmyslieť si, ako budú usporiadané. Pre ďalšie rady si prečítajte “Rozloženie úložiska”.

Táto časť popisuje príkaz importu Subversion, ktorý bol navrhnutý na import hierarchie priečinkov do úložiska v jednej dávke. Aj keď robí svoju prácu, má niekoľko nedostatkov:

Z týchto dôvodov odporúčame, aby ste príkaz import vôbec nepoužívali, ale radšej sa riadili dvojkrokovou metódou popísanou v “Import na miesto”, pokiaľ nevykonávate jednoduchý krok vytvorenia počiatočnej štruktúry /kmeň/príznaky/vetvy vo svojom úložisku. Keďže ste tu, takto funguje základný import...

Pred importom projektu do úložiska by ste mali:

Teraz v priečinku Prieskumník Windows vyberte priečinok najvyššej úrovne štruktúry priečinkov projektu kliknutím pravého tlačidla myši otvoríte kontextovú ponuku. Vyberte príkaz TortoiseSVN → Import..., čo vyvolá dialógové okno:

Obrázok 4.6. Dialógové okno importu

V tomto dialógovom okne musíte zadať adresu URL umiestnenia úložiska, kam chcete importovať svoj projekt. Je veľmi dôležité si uvedomiť, že lokálny priečinok, ktorý importujete, sa sám neobjaví v úložisku, iba jeho obsah. Napríklad ak máte štruktúru:

C:\Projects\Widget\source
C:\Projects\Widget\doc
C:\Projects\Widget\images
      

a importujete C:\Projects\Widget do http://mydomain.com/svn/trunk potom vás možno prekvapí, že vaše podpriečinky idú priamo do trunk skôr ako budú v podpriečinku Widget. Musíte zadať podpriečinok ako súčasť adresy URL, http://mydomain.com/svn/trunk/Widget-X. Upozorňujeme, že príkaz importu automaticky vytvorí podpriečinky v úložisku, ak neexistujú.

Správa o importe sa používa ako správa záznamu.

V predvolenom nastavení sú súbory a priečinky, ktoré zodpovedajú vzorom globálneho ignorovania nie sú importované. Na prepísanie tohto správania môžete použiť zaškrtávacie políčko Zahrnúť ignorované súbory. Viac informácií o nastavení vzore globálneho ignorovania nájdete v časti “Všeobecné nastavenia” .

Hneď ako stlačíte OK TortoiseSVN importuje celý strom priečinkov vrátane všetkých súborov do úložiska. Projekt je teraz uložený v úložisku pod správou verzií. Upozorňujeme, že importovaný priečinok NIE je pod správou verzií! Ak chcete získať správu verzií pracovnej kópie musíte vykonať overenie práve importovanej verzie. Alebo čítajte ďalej a zistíte, ako importovať priečinok na určené miesto.

Za predpokladu, že už máte úložisko a chcete doň pridať novú štruktúru priečinkov, postupujte podľa týchto krokov:

Niekedy musíte mať pod správou verzií súbor, ktorý obsahuje špecifické údaje užívateľa. To znamená, že máte súbor, ktorý musí každý vývojár/užívateľ upraviť tak, aby vyhovoval jeho lokálnemu nastaveniu. Verziovanie takéhoto súboru je však zložité, pretože každý používateľ by zakaždým odovzdával svoje zmeny do úložiska.

V takýchto prípadoch odporúčame použiť šablónu súborov. Vytvoríte súbor, ktorý obsahuje všetky údaje, ktoré vaši vývojári budú potrebovať, pridáte tento súbor do správy verzií a necháte vývojárov tento súbor overiť. Potom musí každý vývojár urobiť kópiu tohto súboru a premenuje túto kópiu. Potom už nie je problém s úpravou kópie.

Ako príklad si môžete pozrieť skript zostavenia TortoiseSVN. Volá súbor s názvom default.build.user ktorý v úložisku neexistuje. Iba súbor default.build.user.tmpl. default.build.user.tmpl je súbor šablóny, z ktorého musí každý vývojár vytvoriť kópiu a premenovať tento súbor na default.build.user. Do tohto súboru sme pridali komentáre, aby používatelia videli, ktoré riadky musia upraviť a zmeniť podľa svojho lokálneho nastavenia, aby fungovali.

Aby sme nenarušili užívateľov, pridali sme aj súbor default.build.user do zoznamu ignorovaných nadradených priečinkov, t. j. nastavili sme vlastnosť Subversion svn: ignore pre zahrnutie tohto názvu súboru. Takto sa pri každom odovzdaní nezobrazí ako bezverziový.

Môžete si zvoliť hĺbku overenia, čo vám umožní určiť hĺbku rekurzie v podradených priečinkoch. Ak chcete iba niekoľko častí veľkého stromu, môžete overiť iba priečinok najvyššej úrovne a potom vybrané priečinky aktualizovať rekurzívne.

Pre ľahký výber iba tých položiek, ktoré chcete overiť a vynútiť si zachovanie iba tých položiek výslednej pracovnej kópie, kliknite na tlačidlo Vybrať položky.... Otvorí sa nové dialógové okno, kde môžete overiť všetky požadované položky v pracovnej kópii a zrušiť zaškrtnutie všetkých položiek, ktoré nechcete. Výsledná pracovná kópia je potom známa ako roztrúsené overenie. Aktualizácia takejto pracovnej kópie neprinesie chýbajúce súbory a priečinky, ale iba aktualizuje to, čo už v pracovnej kópii máte.

Ak overujete roztrúsenú pracovnú kópiu (t. j. zvolíte niečo iné ako plne rekurzívne (pre hĺbku overenia), môžete ľahko pridať alebo odstrániť podpriečinky neskôr použitím jednej z nasledujúcich metód.

Táto funkcia je veľmi užitočná, ak chcete overiť iba časti veľkého stromu, ale chcete pohodlne aktualizovať jednu pracovnú kópiu. Predpokladajme, že máte veľký strom, ktorý má podpriečinky Projekt01 až Project99 a chcete iba overiť Projekt03, Projekt25 a Projekt76/SubProj. Použite tieto kroky:

Ak je vaša pracovná kópia aktuálna a nedochádza k žiadnym konfliktom, ste pripravení odovzdať svoje zmeny. Potom vyberte ľubovoľný súbor alebo priečinok, ktorý chcete odovzdať, potom vyberte ponuku TortoiseSVN → Odovzdať....

Obrázok 4.8. Dialóg odovzdania

Dialógové okno odovzdania vám ukáže všetky zmenené súbory vrátane pridaných, odstránených a bezverziových súborov. Ak nechcete, aby bol zmenený súbor odovzdaný, zrušte jeho zaškrtnutie. Ak chcete zahrnúť bezverziový súbor, zaškrtnite tento súbor a pridajte ho do odovzdania.

Ak chcete rýchlo zaškrtnúť alebo zrušiť zaškrtnutie typov súborov, ako sú všetky verziové súbory alebo všetky upravené súbory, kliknite na riadok položky tesne nad zoznamom zobrazených položiek.

Informácie o vyfarbení a prekrytí položiek podľa ich stavu nájdete v časti “Lokálny a vzdialený stav” .

Položky, ktoré boli prepnuté na inú cestu úložiska, sú označené aj použitím príznaku (s). Možno ste niečo zmenili pri práci na vetve a zabudli ste prepnúť späť na kmeň stromu. Toto je váš varovný signál!

Dvojitým kliknutím na akýkoľvek upravený súbor v dialógovom okne odovzdania sa spustí nástroj externých odlišností pre zobrazenie vašich zmien. Kontextová ponuka vám poskytne viac možností, ako je znázornené na snímke obrazovky. Súbory odtiaľto môžete tiež pretiahnuť do inej aplikácie, napríklad do textového editora alebo IDE.

Položky môžete vybrať alebo zrušiť ich výber kliknutím na zaškrtávacie políčko naľavo od položky. Pre priečinky, ktoré môžete použiť Shift- vybrať pre vytvorenie rekurzívnej akcie.

Stĺpce zobrazené na spodnom paneli sú prispôsobiteľné. Ak kliknite pravým tlačidlom myši na ktorúkoľvek hlavičku stĺpca uvidíte kontextovú ponuku, ktorá vám umožní si zvoliť, ktoré stĺpce sa majú zobraziť. Šírku stĺpca môžete tiež zmeniť ťahaním manipulátora, ktorý sa zobrazí, keď presuniete myš nad okraje stĺpca. Tieto prispôsobenia sú zachované, takže nabudúce uvidíte rovnaké hlavičky.

Keď odovzdáte zmeny, predvolene všetky zámky držané na súboroch, sú po úspešnom odovzdaní automaticky vypustené. Ak chcete tieto zámky zachovať, uistite sa, že je zaškrtnuté políčko Zachovať zámky. Predvolený stav tohto zaškrtávacieho políčka je prevzatý z no_unlock v konfiguračnom súbore Subversion. Prečítajte si “Všeobecné nastavenia” pre informáciu o tom, ako upraviť konfiguračný súbor Subversion.

Dialóg odovzdania podporuje funkciu zoznamu zmien Subversion, ktorá pomáha pri zoskupovaní súvisiacich súborov. O tejto funkcii sa dozviete viac v časti “Zoznamy zmien” .

Niekedy chcete vykonať zmeny v súbore iba čiastočne. Takáto situácia sa zvyčajne stáva, keď na niečom pracujete, ale potom je potrebné vykonať neodkladnú opravu, ktorá sa stane v rovnakom súbore, na ktorom pracujete.

Kliknite pravým tlačidlom myši na súbor a použite kontextovú ponuku → Obnoviť po odovzdaní. Takto sa vytvorí kópia súboru, aký je. Potom môžete súbor upraviť, napr. v textovom editore a vrátiť späť všetky zmeny, ktoré nechcete vykonať. Po uložení týchto zmien môžete súbor potvrdiť.

Po dokončení odovzdania sa kópia súboru automaticky obnoví a vy máte súbor so všetkými zmenami, ktoré neboli vrátené späť.

Niekedy máte verziové súbory, ktoré sa často menia, ale ktoré naozaj nechcete odovzdať. Niekedy to naznačuje chybu v procese zostavovania - prečo sú tieto súbory označené verziou? mali by ste používať súbory šablón? Ale občas je to nevyhnutné. Klasickým dôvodom je, že vaše IDE zmení časovú pečiatku v súbore projektu zakaždým, keď ho vytvoríte. Súbor projektu musí byť verziový, pretože obsahuje všetky nastavenia zostavenia, ale nemusí byť potvrdený iba preto, že sa zmenila časová značka.

Aby sme pomohli v nepríjemných prípadoch, ako je tento, vyhradili sme si zoznam zmien nazývaný ignore-on-commit. Akýkoľvek súbor pridaný do tohto zoznamu zmien nebude automaticky zrušený v dialógovom okne odovzdania. Stále môžete potvrdiť zmeny, ale musíte ich zvoliť manuálne v dialógovom okne odovzdania.

Nezabudnite vložiť správu záznamu, ktorá popisuje vykonané zmeny. To vám pomôže zistiť, čo sa stalo a kedy, keď budete neskôr prechádzať správy záznamu projektu. Správa môže byť ľubovoľná; veľa projektov obsahuje pokyny pre to, čo by malo byť zahrnuté, jazyk, ktorý sa má používať a niekedy dokonca prísny formát.

Na svoje správy záznamu môžete použiť jednoduché formátovanie použití konvencie podobnej konvencii používanej v e-mailoch. Pre použitie štýlov textu, použite *text* pre tučné písmo, _text_pre podčiarknuté a ^text^ pre kurzívu.

Obrázok 4.9. Kontrola pravopisu v dialógovom okne odovzdania

TortoiseSVN obsahuje kontrolu pravopisu, ktorá vám pomôže spravovať správy záznamu. To zvýrazní všetky nesprávne napísané slová. Použitím kontextovej ponuky získate prístup k navrhovaným opravám. Samozrejme, že to nevie každý odborný výraz, ktorý robíte, takže správne napísané slová sa niekedy ukážu ako chyby. Ale nebojte sa. Môžete ich jednoducho pridať do svojho osobného slovníka použitím kontextovej ponuky.

Okno správy záznamu obsahuje tiež názov a funkciu automatického dokončovania funkcií. Toto používa regulárne výrazy na extrahovanie názvov tried a funkcií z (textových) súborov, ktoré odovzdávate, ako aj samotných názvov súborov. Ak slovo, ktoré píšete, sa zhoduje s čímkoľvek v zozname (po napísaní minimálne 3 znakov alebo stlačení Ctrl+medzerník) sa zobrazí rozvinovacia ponuka, ktorá vám umožní vybrať si celý názov. Regulárne výrazy dodávané s TortoiseSVN sa nachádzajú v priečinku bin pri inštalácii TortoiseSVN. Môžete tiež definovať svoje vlastné regulárne výrazy a uložiť ich do %APPDATA%\TortoiseSVN\autolist.txt. Váš súkromný automatický zoznam samozrejme nebude prepísaný pri aktualizácii svojej inštalácie TortoiseSVN. Ak vám regulárne výrazy nie sú známe, pozrite sa na úvod na https://en.wikipedia.org/wiki/Regular_expression a online dokumentáciu a manuál na stránke http://www.regular-expressions.info/.

Správny výsledok regulárneho výrazu môže byť zložitý, takže aby ste si mohli zoradiť vhodný výraz, existuje testovacie dialógové okno, ktoré vám umožňuje zadať výraz a potom ho vložiť zadaním názvov súborov. Spustíte ho z príkazového riadku príkazom TortoiseProc.exe /command:autotexttest .

Okno správy záznamu obsahuje tiež možnosti úryvkov správy odovzdania. Tieto úryvky sa zobrazia v rozvinovacej ponuke automatického dopĺňania po zadaní skratky úryvku. Po výbere úryvku v rozvinovacej ponuke automatického dopĺňania sa vloží celý text úryvku. Úryvky dodané s TortoiseSVN sú ukladané v priečinku bin pri inštalácii TortoiseSVN. Môžete tiež definovať svoje vlastné úryvky a uložiť ich do %APPDATA%\TortoiseSVN\snippet.txt. # je znak komentára. Nové riadky je možné vkladať tak, že ich ukončíte takto: \n a \r. Ak chcete vložiť spätnú lomku, vyviaznite z toho takto: \\.

Môžete znovu používať predtým zadané správy záznamu. Stačí kliknúť na Posledné správy pre zobrazenie zoznamu posledných správ, ktoré ste zadali pre túto pracovnú kópiu. Počet uložených správ je možné upraviť v dialógovom okne nastavení TortoiseSVN.

Všetky uložené správy o potvrdení môžete vymazať z priečinka Uložené dáta stránka s nastaveniami TortoiseSVN, alebo môžete jednotlivé správy vymazať zvnútra Posledné správy dialógové okno pomocou Odstrániť kľúč.

Ak chcete zahrnúť zaškrtnuté cesty do svojej správy záznamu, môžete v ovládacom prvku úprav použiť príkaz kontextová ponuka → Prilepiť zoznam názvov súborov.

Ďalším spôsobom, ako vložiť cesty do správy záznamu, je jednoduché pretiahnutie súborov zo zoznamu súborov do ovládacieho prvku úpravy.

Po stlačení OK sa zobrazí dialógové okno s priebehom odovzdania.

Obrázok 4.10. Dialógové okno priebehu zobrazujúce prebiehajúce odovzdanie

Dialógové okno priebehu používa farebné značenie zvýraznenie rôznych akcií odovzdania

Toto je predvolená farebná schéma, ale tieto farby môžete prispôsobiť použitím dialógového okna nastavenia. Pre viac informácií si prečítajte “Nastavenia farieb TortoiseSVN”.

Konflikt súboru nastane, keď dvaja alebo viacerí vývojári zmenili rovnakých pár riadkov súboru. Pretože Subversion o vašom projekte nič nevie, riešenie konfliktov prenecháva vývojárom. Konfliktná oblasť v textovom súbore je označená takto:

<<<<<<< názov súboru
vaše zmeny
=======
kód zlúčený z úložiska
>>>>>>> revízia
      

Taktiež pre každý konfliktný súbor Subversion umiestni do vášho adresára ďalšie tri súbory:

Môžete spustiť externý nástroj na zlučovanie alebo editor konfliktov pomocou TortoiseSVN → Upraviť konflikty alebo môžete na vyriešenie konfliktu použiť ľubovoľný textový editor. Mali by ste sa rozhodnúť, ako by mal kód vyzerať, vykonať potrebné zmeny a uložiť súbor. Použitie nástroja na zlučovanie, ako je TortoiseMerge alebo jedného z ďalších populárnych nástrojov, je vo všeobecnosti ľahšou voľbou, pretože zvyčajne predstavuje súbory zahrnuté v 3-panelovom zobrazení a nemusíte sa obávať označenia konfliktu. Ak používate textový editor, mali by ste vyhľadávať riadky začínajúce reťazcom <<<<<<<.

Potom vykonajte príkaz TortoiseSVN → Vyriešiť a vykonajte svoje úpravy v úložisku. Upozorňujeme, že príkaz Vyriešiť konflikt skutočne nevyrieši. Iba odstráni súbory filename.ext.mine a filename.ext.r*, ktoré vám umožnia vykonať zmeny.

Ak máte konflikty s binárnymi súbormi, Subversion sa nepokúsi zlúčiť samotné súbory. Miestny súbor zostane nezmenený (presne tak, ako ste ho naposledy zmenili) a máte súbory filename.ext.r*. Ak chcete svoje zmeny zahodiť a uchovať si verziu úložiska, stačí použiť príkaz Vrátiť. Ak si chcete uchovať svoju verziu a prepísať verziu úložiska, použite príkaz Vyriešené a potom odovzdajte svoju verziu.

Príkaz Vyriešené môžete použiť pre viac súborov, ak kliknete pravým tlačidlom myši na nadradený priečinok a vyberiete TortoiseSVN → Vyriešené... Zobrazí sa dialógové okno so zoznamom všetkých konfliktných súborov v danom priečinku a môžete si vybrať, ktoré z nich chcete označiť ako vyriešené.

Ku konfliktu vlastností dôjde, keď dvaja alebo viacerí vývojári zmenili to isté vlastníctvo. Rovnako ako v prípade obsahu súborov, konflikt môžu vyriešiť iba vývojári.

Ak musí jedna zo zmien prepísať druhú, vyberte možnosť Vyriešiť použitím miestneho vlastníctva alebo Vyriešiť použitím vzdialeného vlastníctva. Ak je potrebné zmeny zlúčiť, vyberte možnosťRučne upraviť vlastníctvo, vytrieďte, aká by mala byť hodnota vlastnosti a označte ju ako vyriešenú.

Konflikt stromu nastane, keď vývojár presunul/premenoval/odstránil súbor alebo priečinok, ktorý iný vývojár tiež presunul/premenoval/odstránil alebo práve upravil. Existuje mnoho rôznych situácií, ktoré môžu vyústiť do konfliktu stromov a všetky si vyžadujú rôzne kroky na vyriešenie konfliktu.

Keď sa súbor lokálne odstráni v Subversion, vymaže sa aj z lokálneho súborového systému, takže aj keď je súčasťou konfliktu stromov, nemôže zobraziť konfliktné prekrytie a na jeho vyriešenie nemôžete kliknúť pravým tlačidlom myši. Namiesto použitia dialógu Skontrolujte úpravy pristúpte k možnosti Upraviť konflikty.

TortoiseSVN vám môže pomôcť nájsť správne miesto na zlúčenie zmien, ale na vyriešenie konfliktov môže byť potrebná ďalšia práca. Pamätajte, že po aktualizácii bude funkčný ZÁKLAD (BASE) vždy obsahovať revíziu každej položky tak, ako bola v úložisku v čase aktualizácie. Ak po aktualizácii vrátite zmenu, vráti sa späť do stavu úložiska, nie do stavu, v akom to bolo, keď ste začali robiť vlastné miestne zmeny.

Obrázok 4.12. Prekrytie ikon zobrazované v Prieskumníkovi

Teraz, keď máte overenú pracovnú kópiu z úložiska Subversion, môžete svoje súbory vidieť v prieskumníkovi Windows so zmenenými ikonami. To je jeden z dôvodov, prečo je TortoiseSVN taký populárny. TortoiseSVN pridáva ku každej ikone súboru takzvanú ikonu prekrytia, ktorá prekrýva ikonu pôvodného súboru. Ikona prekrytia sa líši v závislosti od stavu Subversion súboru.

Čerstvo overená pracovná kópia má ako prekrytie zelenú značku zaškrtnutia. To znamená, že stav Subversion je normálny .

Hneď ako začnete upravovať súbor, stav sa zmení na upravený a prekrytie ikony sa potom zmení na červený výkričník. Takto môžete ľahko zistiť, ktoré súbory sa zmenili od poslednej aktualizácie pracovnej kópie a je potrebné ich odovzdať.

Ak počas aktualizácie nastane konflikt potom sa ikona zmení na žltý výkričník.

Ak ste nastavili vlastnosť súbor na svn:needs-lock, Subversion nastaví súbor iba na čítanie, kým nezískate zámok pre daný súbor. Súbory iba na čítanie majú toto prekrytie, aby ste vedeli, že pred ich úpravou potrebujete získať zámok.

Ak ponecháte zámok na súbore a stav Subversion je normálny, toto prekrytie ikonou vám pripomenie, že ak zámok nepoužívate, mali by ste ho uvoľniť, aby ostatní mohli vykonávať zmeny súboru.

Táto ikona zobrazuje, že niektoré súbory alebo priečinky v aktuálnom priečinku boli naplánované na odstránenie zo správy verzie alebo v priečinku chýba súbor pod správou verzie.

Znamienko plus informuje o tom, že súbor alebo priečinok bol naplánovaný na pridaný do správy verzie.

Znak čiary informuje o tom, že sa jedná o ignorovaný súbor alebo priečinok pre účely správy verzií. Toto prekrytie je voliteľné.

Táto ikona zobrazuje súbory a priečinky, ktoré nepodliehajú správe verzií, ale neboli ignorované. Toto prekrytie je voliteľné.

V skutočnosti môžete zistiť, že nie všetky tieto ikony sa vo vašom systéme používajú. Je to preto, že počet prekrytí povolených systémom Windows je veľmi obmedzený a ak používate aj starú verziu TortoiseCVS, nie je k dispozícii dostatok slotov na prekrytie. TortoiseSVN sa snaží byť “Dobrým občanom (TM)” a obmedzuje použitie prekrytí, aby mali šancu aj iné aplikácie.

Teraz, keď je v okolí viac klientov Tortoise (TortoiseCVS, TortoiseHg, ...), sa limit ikon stáva skutočným problémom. Aby sme to obišli, projekt TortoiseSVN zaviedol spoločnú zdieľanú sadu ikon načítanú ako DLL, ktorú môžu používať všetci klienti Tortoise. Overte si u svojho poskytovateľa klienta, či už bol integrovaný :-)

Pre popis toho, ako prekrytia ikon zodpovedajú stavu Subversion a ďalšie technické podrobnosti si prečítajte “Prekrytie ikon”.

Obrázok 4.13. Stránka vlastností prieskumníka, karta Subversion

Niekedy chcete mať o súbore/priečinku podrobnejšie informácie, ako len prekrytie ikon. Všetky informácie, ktoré Subversion poskytuje, môžete získať v dialógovom okne vlastností prieskumníka. Stačí zvoliť súbor alebo priečinok a zvoliť ponuku Windows → Vlastnosti v kontextovej ponuke (poznámka: toto je položka ponuky bežných vlastností, ktorú poskytuje prieskumník, nie tá v pod-ponuke TortoiseSVN!). V dialógovom okne vlastností TortoiseSVN pridala novú stránku vlastností pre súbory/priečinky pod správou Subversion, kde vidíte všetky relevantné informácie o vybranom súbore/priečinku.

Obrázok 4.14. Skontrolovať zmeny

Často je veľmi užitočné vedieť, ktoré súbory ste zmenili a tiež ktoré súbory zmenili a potvrdili iní. To je miesto, kde príkaz TortoiseSVN → Skontrolovať úpravy... príde vhod. V tomto dialógovom okne sa zobrazia všetky súbory, ktoré sa vo vašej pracovnej kópii akýmkoľvek spôsobom zmenili, ako aj všetky bezverziové súbory, ktoré môžete mať.

Ak kliknete na ikonu Skontrolovať úložisko potom môžete tiež si prezrieť zmeny v úložisku. Týmto spôsobom si môžete pred aktualizáciou skontrolovať, či existuje možný konflikt. Môžete taktiež aktualizovať vybrané súbory z úložiska bez aktualizácie celého priečinka. Predvolene tlačidlo Skontrolovať úložisko vyvolá iba vzdialený stav s hĺbkou overenia pracovnej kópie. Ak chcete vidieť všetky súbory a priečinky v úložisku, aj tie, ktoré ste neoverili, musíte pridržať Shift pri kliknutí na tlačidlo Skontrolovať úložisko.

Dialógové okno používa na zvýraznenie stavu farebné kódovanie.

Toto je predvolená farebná schéma, ale tieto farby môžete prispôsobiť použitím dialógového okna nastavenia. Pre viac informácií si prečítajte “Nastavenia farieb TortoiseSVN”.

Ikony prekrytia sa používajú aj na označenie ďalších stavov. Snímka obrazovky nižšie zobrazuje všetky možné prekrytia, ktoré sa v prípade potreby zobrazia.

Prekrytia sa zobrazujú pre nasledujúce stavy:

Položky, ktoré boli prepnuté na odlišnú cestu úložiska, sú tiež označené značkou (s). Možno ste niečo zmenili pri práci na vetve a zabudli ste prepnúť späť na kmeň stromu. Toto pre vás varovný signál! Kontextová ponuka vám ich umožní znova prepnúť späť na normálnu cestu.

V kontextovej ponuke dialógového okna môžete zobraziť rozdiel medzi zmenami. Skontrolujte lokálne zmeny vyrobené vami pomocou kontextovej ponuky → Porovnať s bázou. Overte zmeny úložiska vykonané inými používateľmi použitím kontextovej ponuky → Zobraziť odlišnosti ako zjednotené odlišnosti .

Môžete tiež vrátiť zmeny v jednotlivých súboroch. Ak ste súbor omylom odstránili, zobrazí sa ako chýbajúci a môžete použiť Navrátiť pre jeho opätovné navrátenie.

Bezverziové a ignorované súbory odtiaľto môžete poslať do koša použitím kontextovej ponuky → Odstrániť. Ak chcete súbory natrvalo odstrániť (obísť odpadkový kôš), pridržte klávesu Shift pri kliknutí na Odstrániť.

Ak chcete súbor podrobne preskúmať, môžete ho odtiaľ presunúť do inej aplikácie, napríklad do textového editora alebo IDE, alebo môžete kópiu uložiť jednoduchým presunutím do priečinka v Prieskumníku.

Stĺpce sú prispôsobiteľné. Ak kliknite pravým tlačidlom myši v ktorejkoľvek hlavičke stĺpca uvidíte kontextovú ponuku, ktorá vám umožní si vybrať, ktoré stĺpce sa majú zobraziť. Šírku stĺpca môžete tiež zmeniť ťahaním manipulátora, ktorý sa zobrazí, keď presuniete myš nad okraje stĺpca. Tieto prispôsobenia sú zachované, takže nabudúce uvidíte rovnaké hlavičky.

Ak pracujete na niekoľkých nesúvisiacich úlohách naraz, môžete tiež zoskupiť súbory do zoznamov zmien. Pre viac informácií si prečítajte “Zoznamy zmien”.

V dolnej časti dialógového okna vidíte súhrn rozsahu revízií úložiska, ktoré sa používajú vo vašej pracovnej kópii. Toto sú odovzdané, nie aktualizované revízie; predstavujú rozsah revízií naposledy odovzdaných súborov, nie revízie ich aktualizácie. Upozorňujeme, že zobrazený rozsah revízií sa vzťahuje iba na zobrazené položky, nie na celú pracovnú kópiu. Ak chcete vidieť tieto informácie pre celú pracovnú kópiu, musíte skontrolovať Zobraziť neupravené súbory začiarkavacie políčko.

Často sa chcete nahliadnuť do svojich súborov, aby ste sa pozreli, čo ste zmenili. Môžete to dosiahnuť výberom súboru, ktorý sa zmenil, a výberom položky Odlišnosť z kontextovej ponuky TortoiseSVN. Spustí sa externý prehliadač odlišností, ktorý potom porovná aktuálny súbor s pôvodnou kópiou ( BASE) bázovou revíziou, ktorá bola uložená po poslednej overení alebo aktualizácii.

Obrázok 4.18. Dialógové okno Záznamu revízií

Existuje niekoľko miest, z ktorých môžete zobraziť dialógové okno Záznamu:

Ak úložisko nie je k dispozícii, zobrazí sa dialógové okno Chcete prejsť do režimu offline? opísané v časti “Režim offline (bez pripojenia)” .

Horný panel má stĺpec Akcie obsahujúci ikony sumarizujúce, čo sa urobilo v danej revízii. Existujú štyri rôzne ikony, z ktorých každá je zobrazená v samostatnom stĺpci.

Ak revízia upravila súbor alebo priečinok, ikona upravenésa zobrazuje v prvom stĺpci.

Ak revízia pridala súbor, alebo priečinok, v druhom stĺpci je zobrazená ikona pridané.

Ak revízia odstránila súbor alebo priečinok, ikona odstránené je zobrazená v treťom stĺpci.

Ak revízia nahradila súbor alebo priečinok, ikona nahradené je zobrazená vo štvrtom stĺpci.

Ak revízia presunula alebo premenovala súbor alebo priečinok, ikona presunuté je zobrazená vo štvrtom stĺpci.

Ak revízia nahradila súbor alebo priečinok jeho presunutím/premenovaním, ikona nahradené presunuté je zobrazená vo štvrtom stĺpci.

Ak revízia zlúčila súbor alebo priečinok, zlúčené je zobrazená vo štvrtom stĺpci.

Ak revízia opätovne zlúčila súbor alebo priečinok,opätovne zlúčené je zobrazená vo štvrtom stĺpci.

Obrázok 4.19. Dialógové okno Záznamu revízií - horný panel s kontextovou ponukou

Horný panel dialógového okna Záznamu má kontextovú ponuku, ktoré umožňuje prístup k viacerým informáciám. Niektoré z týchto položiek ponuky sa zobrazia iba vtedy, keď sa zobrazí záznam pre súbor a niektoré iba vtedy, keď sa zobrazí záznam pre priečinok.

Obrázok 4.20. Dialógové okno nastavení spolupracovníka kódu

Obrázok 4.21. Kontextová ponuka horného panela pre 2 vybrané revízie

Ak vyberiete dve revízie naraz (použitím zvyčajného modifikátora Ctrl), kontextová ponuka sa zmení a poskytne vám menej možností:

Ak vyberiete dve alebo viac revízií (obvyklými modifikátormi Ctrl alebo Shift), kontextová ponuka bude obsahovať položku Vrátiť všetky zmeny, ktoré boli vykonané vo vybraných revíziách. Toto je najjednoduchší spôsob, ako vrátiť skupinu revízií naraz.

Môžete sa tiež rozhodnúť zlúčiť vybrané revízie do inej pracovnej kópie, ako je opísané vyššie.

Ak majú všetky vybrané revízie rovnakého autora, môžete súčasne upraviť autora všetkých týchto revízií.

Obrázok 4.22. Dolný panel dialógu Záznamu s kontextovou ponukou

Spodný panel dialógového okna Záznamu má tiež kontextovú ponuku, ktorá vám to povolí

Keď je v dolnom paneli dialógového okna Záznamu vybraných viac súborov, kontextová ponuka sa zmení na nasledovné:

Obrázok 4.23. Dolný panel dialógového okna Záznamu s kontextovou ponukou, keď je vybraných viac súborov.

Dialógové okno Záznam nemusí vždy obsahovať všetky zmeny, ktoré boli vykonané z viacerých dôvodov:

Ak chcete vidieť viac správ záznamu, kliknite na ikonu Ďalších 100 pre načítanie ďalších 100 správ záznamu. Môžete to opakovať toľkokrát, koľkokrát je potrebné.

Vedľa tohto tlačidla je multifunkčné tlačidlo, ktoré si pamätá poslednú možnosť, ktorú ste použili. Kliknutím na šípku zobrazíte ďalšie ponúkané možnosti.

Použite Zobraziť rozsah... ak si chcete prezrieť konkrétny rozsah revízií. Dialógové okno vás potom vyzve na zadanie začiatočnej a konečnej revízie.

Použite Ukázať všetko ak chcete vidieť všetky správy záznamu HEAD hneď späť od revízie 1.

Ak chcete aktualizovať najnovšiu verziu pre prípad, že by v otvorenom dialógovom okne záznamu boli nejaké ďalšie odovzdania, stlačte klávesu F5.

Ak chcete obnoviť zásobník záznamu, stlačte klávesy Ctrl-F5.

Pretože dialógové okno protokolu zobrazuje protokol z HEAD, nie z aktuálnej revízie pracovnej kópie, často sa stáva, že sa zobrazia správy záznamu pre obsah, ktorý ešte nebol vo vašej pracovnej kópii aktualizovaný. Aby sme to sprehľadnili, správa o odovzdaní, ktorá zodpovedá revízii, ktorú máte v pracovnej kópii, je zobrazená tučným písmom.

Keď zobrazíte záznam pre priečinok, zvýraznená revízia je najvyššou revíziou, ktorá sa kdekoľvek v danom priečinku nachádza, čo si vyžaduje prehľadanie pracovnej kópie. Indexové prehľadávanie prebieha v samostatnom vlákne, aby sa oneskorilo zobrazovanie protokolu, ale výsledné zvýraznenie priečinkov sa nemusí zobraziť okamžite.

Subversion 1.5 a novší vedie záznamy o zlúčení použitím vlastností. To nám umožňuje získať podrobnejšiu históriu zlúčených zmien. Napríklad ak vyvíjate novú funkciu na pobočke a potom zlúčite túto vetvu späť do kmeňa, vývoj funkcie sa zobrazí v protokole kmeňa ako jediné odovzdanie pre zlúčenie, aj keď počas vývoja vetvy mohlo byť 1 000 odovzdaní .

Obrázok 4.24. Dialógové okno záznamu zobrazujúce revízie sledovania zlúčenia

Ak chcete vidieť podrobnosti o tom, ktoré revízie boli zlúčené ako súčasť tohto odovzdania, použite zaškrtávacie políčko Zahrnúť zlúčené revízie. Týmto sa správy záznamu znova načítajú, ale tiež sa budú prekladať správy záznamu z revízií, ktoré boli zlúčené. Zlúčené revízie sú zobrazené sivou farbou, pretože predstavujú zmeny vykonané v inej časti stromu.

Zlučovanie samozrejme nikdy nie je jednoduché! Počas vývoja funkcií na vetve pravdepodobne dôjde k občasnému zlúčeniu späť z kmeňa, aby sa pobočka udržala synchronizovaná s kódom hlavnej línie. História zlúčenia vetvy teda bude obsahovať aj ďalšiu vrstvu histórie zlúčenia. Tieto rôzne vrstvy sa zobrazujú v dialógovom okne záznamu použitím úrovní odsadenia.

Vlastnosti revízií sú úplne odlišné od vlastností Subversion každej položky. Revprops sú popisné položky, ktoré sú spojené s jedným konkrétnym číslom revízie v úložisku, ako napríklad správa záznamu, dátum odovzdania a meno odovzdávajúceho (autor).

Niekedy možno budete chcieť zmeniť správu, ktorú ste už raz zadali, možno preto, že sa v nej nachádza pravopisná chyba, alebo chcete správu vylepšiť alebo zmeniť z iných dôvodov. Alebo chcete zmeniť autora potvrdenia, pretože ste zabudli nastaviť autentifikáciu alebo...

Subversion vám umožňuje kedykoľvek zmeniť vlastnosti revízie. Ale keďže také zmeny nie je možné vrátiť späť (tieto zmeny nemajú verziu), táto funkcia je v predvolenom nastavení zakázaná. Aby to fungovalo, musíte nastaviť pre-revprop-change hák. Prečítajte si kapitolu Skripty háku v knihe Subversion Book, kde nájdete podrobnosti o tom, ako to urobiť. Prečítajte si “Skripty háku na strane servera” pre nájdenie ďalších poznámok k implementácii hákov na počítači so systémom Windows.

Po nastavení servera požadovanými háčikmi môžete zmeniť autora a správu protokolu (alebo akúkoľvek inú revprop) akejkoľvek revízie pomocou kontextovej ponuky na hornom paneli dialógového okna Protokol. Protokolovú správu môžete tiež upraviť pomocou kontextovej ponuky na strednom paneli.

Ak chcete obmedziť zobrazovanie správ záznamu iba na tie, ktoré vás zaujímajú a neprechádzať stovkami zoznamov, môžete použiť riadiace filtre v hornej časti dialógového okna Záznam. Riadenie dátumu začatia a ukončenia umožňujú obmedziť výstup na známy rozsah dátumov. Vyhľadávacie pole umožňuje zobraziť iba správy, ktoré obsahujú konkrétnu frázu.

Kliknutím na ikonu vyhľadávania vyberte, v ktorých informáciách chcete hľadať a vyberte režim regulárneho výrazu. Spravidla budete potrebovať iba jednoduché hľadanie čiastkových reťazcov, ale ak potrebujete flexibilnejšie vyhľadávať výrazy, môžete použiť regulárne výrazy. Ak umiestnite kurzor myši nad rámček, popis nástroja poskytne tipy, ako používať funkcie regulárneho výrazu alebo funkcie podreťazca. Filter funguje tak, že kontroluje, či sa váš reťazec filtra zhoduje s položkami záznamu a potom iba s tými, ktoré sa zhodujú so zobrazeným reťazcom filtra.

Jednoduché vyhľadávanie čiastkových reťazcov funguje podobným spôsobom ako mechanizmus vyhľadávania. Reťazce, ktoré chcete vyhľadať, sú oddelené medzerami a všetky reťazce sa musia zhodovať. Môžete použiť vpredu znak - na určenie, že konkrétny podreťazec nebol nájdený (invertovať zhodu pre tento výraz) a môžete použiť znak ! na začiatku výrazu pre invertovanie zhody celého výrazu. Môžete použiť vpredu znak + pre určenie zahrnutia čiastkového reťazca, aj keď bol predtým vylúčený znakom -. Upozorňujeme, že poradie zahrnutia/vylúčenia je tu významné. Môžete použiť úvodzovky na obklopenie reťazca, ktorý musí obsahovať medzery a ak chcete vyhľadať doslovné úvodzovky, môžete použiť ako úvodzovku dve úvodzovky. Všimnite si, že znak spätnej lomky nie je používaný ako únikový znak a nemá žiadny zvláštny význam pri jednoduchom vyhľadávaní čiastkových reťazcov. Príklady na objasnenie:

Alica Bob -Eva
      

vyhľadá reťazce obsahujúce Alica aj Bob, ale nie Eva

Alica -Bob +Eva
      

vyhľadá reťazce, ktoré obsahujú Alica, ale nie Bob, alebo reťazce, ktoré obsahujú Eva.

-Case +SpecialCase
      

vyhľadá reťazce, ktoré neobsahujú veľké a malé písmená, ale stále obsahujú reťazce, ktoré obsahujú špeciálne písmená.

! Alica Bob
      

vyhľadá reťazce, ktoré neobsahujú Alica ani Bob

! -Alica -Bob
      

pamätáš si De Morganovu vetu? NOT (NOT Alice AND NOT Bob) sa redukuje na (Alice OR Bob).

„Alica a Bob“
      

hľadá doslovný výraz“Alica a Bob”

""
      

hľadá kdekoľvek v texte dvojité úvodzovky

"Alica hovorí Bobovi ""ahoj"
      

hľadá doslovný výraz“Alica hovorí Bobovi "ahoj"” .

Opis použitia vyhľadávania použitím regulárneho výrazu je nad rámec tejto príručky, ale online dokumentáciu a návod nájdete na stránke http://www.regular-expressions.info/.

Upozorňujeme, že tieto filtre pôsobia na už načítané správy. Nekontrolujú sťahovanie správ z úložiska.

Môžete tiež filtrovať názvy ciest v dolnom paneli použitím zaškrtávacieho políčka Zobraziť iba ovplyvnené cesty. Budú ovplyvnené tie cesty, ktoré obsahujú cestu použitú na zobrazenie záznamu. Ak načítate záznam pre priečinok, znamená to čokoľvek v tomto priečinku alebo v ňom. Pre súbor to znamená iba jeden súbor. Zoznam ciest zvyčajne zobrazuje všetky ďalšie cesty, ktoré sú ovplyvnené rovnakým odovzdaním, ale sivou farbou. Ak je políčko zaškrtnuté, tieto cesty sú skryté.

Niekedy vaše pracovné postupy budú vyžadovať, aby sa správy záznamu riadili konkrétnym formátom, čo znamená, že text popisujúci zmeny nie je viditeľný v skrátenom súhrne zobrazenom na hornom paneli. Vlastnosť tsvn: logsummary možno použiť na extrakciu časti správy záznamu, ktorá sa má zobraziť v hornom paneli. Ako zistiť túto vlastnosť si prečítajte v časti “Vlastnosti projektu TortoiseSVN”.

Tlačidlo Štatistiky zobrazí okno so zaujímavými informáciami o revíziách zobrazených v dialógovom okne Záznam. To ukazuje, koľko autorov na tom pracovalo, koľko odovzdaní urobili, priebeh za týždeň a oveľa viac. Teraz môžete na prvý pohľad vidieť, kto pracoval najtvrdšie a kto sa flákal ;-)

Stránka odovzdania podľa autora

Obrázok 4.25. Histogram odovzdania podľa autora

Tento graf ukazuje, ktorí autori boli na projekte aktívni, ako jednoduchý histogram, skladaný histogram alebo koláčový graf.

Obrázok 4.26. Koláčový graf odovzdania podľa autorov

Ak je niekoľko významných autorov a mnoho menších prispievateľov, počet drobných segmentov môže sťažiť čítanie grafu. Posuvník v dolnej časti umožňuje nastaviť hranicu (aké percento z celkových odovzdaní), pod ktorou je akákoľvek aktivita zoskupená do kategórie Ostatné.

Stránka odovzdania podľa dátumu

Obrázok 4.27. Graf odovzdaní podľa dátumu

Táto stránka poskytuje grafické znázornenie projektovej činnosti z hľadiska počtu odovzdaní a autora. Toto poskytuje určitú predstavu o tom, odkedy sa na projekte pracuje a kto kedy pracoval.

Ak je niekoľko autorov, v grafe sa zobrazí veľa riadkov. Tu sú k dispozícii dva zobrazenia: normálne, kde aktivita každého autora je relatívna k základnej línii, a stohované, kde aktivita každého autora je relatívna k línii pod ním. Druhá možnosť zabráni prekríženiu riadkov, čo môže uľahčiť čítanie grafu, ale menej dobre vidieť výstup jedného autora.

V predvolenom nastavení sa v analýze rozlišujú veľké a malé písmená, takže sa jedná o používateľov PeterEgan a PeteRegan sú považovaní za rôznych autorov. V mnohých prípadoch však používateľské mená nerozlišujú veľké a malé písmená a niekedy sa zadávajú nekonzistentne, takže možno budete chcieť autorom DavidMorgan a davidmorgan zaobchádzať ako s rovnakou osobou. Použite zaškrtávacie políčko Nerozlišovať veľké a malé písmená autorov na riadenie, ako sa s nimi zaobchádza.

Štatistiky sa týkajú rovnakého obdobia ako dialógové okno Záznam. Ak sa zobrazuje iba jedna revízia, štatistika vám toho veľa nepovie.

Obrázok 4.28. Prejdite do dialógového okna offline

Ak server nie je dosiahnuteľný a máte povolené ukladanie do záznamu, môžete použiť dialógové okno a graf revízií v režime offline. Využíva sa na pre údaje zo zásobníka, ktoré vám umožňujú pokračovať v práci, aj keď informácie nemusia byť aktuálne alebo dokonca úplné.

Tu máte tri možnosti:

Zaškrtnutím políčka Nastaviť ako predvolené zabránite opätovnému zobrazeniu tohto dialógového okna a vždy vyberie ďalšiu možnosť vami vyberanú. Stále môžete predvolené nastavenie zmeniť (alebo odstrániť) aj keď to urobíte z ponuky TortoiseSVN → Nastavenia.

Ak chcete znova overiť, či server neobsahuje novšie správy záznamu, môžete zobrazenie jednoducho obnoviť použitím klávesy F5. Ak používate zásobník záznamu (predvolene povolené), skontrolujú sa tým v úložisku novšie správy a načítajú sa iba nové správy. Ak bol zásobník záznamu v režime bez pripojenia, pokúsi sa tiež vrátiť späť po pripojení.

Ak používate zásobník záznamu a myslíte si, že sa obsah správy alebo autor mohli zmeniť, môžete použiť klávesy Shift-F5 alebo Ctrl-F5 pre opätovné načítanie zobrazených správ zo servera a aktualizovať zásobník záznamov. Upozorňujeme, že to ovplyvní iba aktuálne zobrazené správy a nevyvolá to neplatnosť celého zásobníka daného úložiska.

Ak ste nakonfigurovali rozdielny nástroj tretej strany, môžete použiť Shift pri výbere príkazu Porovnať odlišnosti pre použitie alternatívneho nástroja. O konfigurácii ďalších nástrojov na porovnanie odlišností sa dozviete viac prečítaním časti “Nastavenie Externé programy”.

Niekedy v počas práce na projekte môžete zmeniť zakončenie riadku CRLF na LF, alebo môžete zmeniť odsadenie časti. Toto však bohužiaľ označí veľký počet riadkov ako zmenené, aj keď sa význam kódu nezmení. Tieto možnosti pomôžu zvládnuť tieto zmeny, pokiaľ ide o porovnanie a použitie odlišností. Tieto nastavenia uvidíte v priečinku v dialógových oknách Zlúčiť a Vyvodiť zodpovednosť, ako aj v nastaveniach pre TortoiseMerge.

Ignorovať konce riadkov vylúči zmeny, ktoré sú spôsobené iba odlišnosťou v štýle konca riadku.

Porovnať biele znaky zahrnie všetky zmeny v odsadení a vložených medzerách ako pridané/odstránené riadky.

Ignorovať zmeny bielych znakov vylúči zmeny, ktoré sú spôsobené výhradne zmenou množstva alebo typu bielych znakov, napríklad zmenou odsadenia alebo zmenou tabelátorov na medzery. Pridanie bieleho znaku tam, kde predtým nebol, alebo úplné odstránenie bieleho znaku sa stále zobrazuje ako zmena.

Ignorovať všetky biele znaky vylúči všetky zmeny týkajúce sa iba bielych znakov.

Prirodzene, každý riadok so zmeneným obsahom je vždy zahrnutý do odlišnosti.

Obrázok 4.29. Dialógové okno Porovnanie revízií

Keď v prehliadači úložiska vyberiete dva stromy alebo keď v dialógovom okne záznamu vyberiete dve revízie priečinka, môžete použiť kontextovú ponuku → Porovnať revízie .

Toto dialógové okno zobrazuje zoznam všetkých súborov, ktoré sa zmenili a umožňuje vám ich porovnávať alebo vyvodiť zodpovednosť jednotlivo použitím kontextovej ponuky.

Môžete exportovať zmeny stromu, čo je užitočné, ak potrebujete niekomu inému poslať svoju stromovú štruktúru projektu, ktorá obsahuje iba zmenené súbory. Táto operácia funguje iba s vybranými súbormi, takže musíte vybrať súbory, ktoré vás zaujímajú - zvyčajne to znamená všetky - a potom kontextovou ponukou → Exportovať výber do.... Zobrazí sa výzva na zadanie umiestnenia na uloženie zmien stromu.

Môžete tiež exportovať zoznam zmenených súborov na textový súbor použitím kontextovej ponuky → Uložiť zoznam vybraných súborov do....

Ak chcete exportovať zoznam súborov a akcie (upravené, pridané, odstránené) tiež, môžete to urobiť použitím kontextovej ponuky → Skopírovať výber do schránky.

Tlačidlo v hornej časti vám umožňuje zmeniť smer porovnávania. Môžete si zobraziť, aké zmeny je potrebné dostať z bodu A do bodu B, alebo ak chcete, z bodu B do bodu A.

Tlačidlá so zapnutými číslami revízií je možné použiť na zmenu iného rozsahu revízií. Keď zmeníte rozsah, automaticky sa aktualizuje zoznam položiek, ktoré sa medzi týmito dvoma revíziami líšia.

Ak je zoznam názvov súborov veľmi dlhý, môžete použitím vyhľadávacieho poľa zmenšiť zoznam na názvy súborov, ktoré obsahujú konkrétny text. Upozorňujeme, že sa používa jednoduché textové vyhľadávanie, takže ak chcete obmedziť zoznam na zdrojové súbory C, mali by ste ich zadať .c radšej než * .c.

Existuje mnoho dostupných nástrojov na porovnanie odlišností textových súborov, vrátane nášho vlastného TortoiseMerge, ale často zisťujeme, že chceme vidieť, ako sa zmenil aj obrazový súbor. Preto sme vytvorili TortoiseIDiff.

Obrázok 4.30. Prehliadač odlišností obrázkov

TortoiseSVN → Porovnanie odlišností pre ktorýkoľvek z bežných formátov súborov obrázkov začne TortoiseIDiff zobrazovať odlišnosti v obrázku. V predvolenom nastavení sa obrázky zobrazujú vedľa seba, ale použitím ponuky Zobraziť alebo na paneli nástrojov môžete namiesto toho prepnúť na zobrazenie zhora nadol. Ak chcete, môžete obrázky prekryť a predstierať, že používate svetelnú skrinku.

Prirodzene môžete obrázok aj priblížiť, oddialiť a posúvať okolo. Obrázok môžete tiež jednoducho posúvať ťahaním doľava. Ak vyberiete možnosť Vzájomne prepojiť obrázky, potom sú prepojené ovládacie prvky posuvu (posuvníky, koliesko myši) na oboch obrázkoch.

Informačné pole s obrázkom zobrazuje podrobnosti o obrázkovom súbore, napríklad veľkosť v pixeloch, rozlíšenie a farebnú hĺbku. Ak vám toto políčko prekáža, použite Zobraziť → Informácie o obrázku pre jeho skrytie. Rovnaké informácie môžete získať v popise nástroja, ak umiestnite kurzor myši na záhlavie obrázka.

Keď sú obrázky prekryté, relatívna intenzita obrázkov (alfa zmiešavanie) sa ovláda posuvníkom na ľavej strane. Kliknutím kdekoľvek v posuvníku nastavíte zmiešavanie priamo, alebo môžete pretiahnutím posuvníkom interaktívne zmeniť zmiešavanie. Ctrl+Shift-koliesko zmení zmiešavanie.

Tlačidlo nad posuvníkom prepína medzi 0 % a 100% zmiešaním. Ak na tlačidlo kliknete dvakrát, zmiešavanie sa prepne automaticky každú sekundu, kým na tlačidlo znova nekliknete. To môže byť užitočné pri hľadaní viacerých malých zmien.

Niekedy chcete vidieť skôr odlišnosť ako zmiešanie. Možno máte obrazové súbory pre dve verzie dosky s plošnými spojmi a chcete zistiť, ktoré stopy sa zmenili. Ak deaktivujete režim miešania alfa kanálov, rozdiel sa zobrazí ako XOR hodnôt farieb pixelov. Nezmenené oblasti budú obyčajne biele a zmeny budú sfarbené.

Ak chcete porovnať odlišnosti netextových dokumentov, musíte zvyčajne použiť softvér použitý na vytvorenie dokumentu, ktorý rozumie formátu súboru. Pre bežne používané sústavy Microsoft Office a Open Office existuje určitá podpora odlišností v prezeraní a TortoiseSVN obsahuje skripty, ktoré ich pri správnom nastavení vyvolávajú pri správnych nastaveniach, keď porovnávate odlišnosti súborov so známymi príponami. Na stránke môžete skontrolovať, ktoré prípony súborov sú podporované a pridať svoje vlastné TortoiseSVN → Nastavenia a kliknutím na Pokročilé v sekcii Externé programy.

Ak nástroje, ktoré poskytujeme, nerobia to, čo potrebujete, vyskúšajte ďalší z mnohých dostupných s otvoreným zdrojom alebo komerčných programov. Každý má svojich favoritov a tento zoznam nie je v žiadnom prípade úplný, ale tu je niekoľko, nad ktorými by ste mohli uzvažovať:

Informácie o tom, ako nastaviť TortoiseSVN na používanie týchto nástrojov si prečítajte v časti “Nastavenie Externé programy”.

Vzory ignorovania Subversion využívajú zovšeobecnenie súborov, techniku, ktorá sa pôvodne v Unixe používala na špecifikáciu súborov s použitím meta-znakov ako zástupných znakov. Nasledujúce znaky majú osobitný význam:

Pri porovnávaní vzorov sa rozlišujú veľké a malé písmená, čo môže vo Windows spôsobiť problémy. Necitlivosť na malé a veľké písmená môžete vynútiť spárovaním znakov, napríklad ignorovaním *.tmp bez ohľadu na prípad, môžete použiť vzor ako *.[Tt] [Mm] [Pp] .

Ak chcete oficiálnu definíciu zovšeobecnenia, nájdete ju v špecifikáciách IEEE pre prostredie príkazového jazyka Poznámka zodpovedajúceho vzoru .

Použite TortoiseSVN → Vymazať na odstránenie súborov, alebo priečinkov zo Subversion.

Keď použijete TortoiseSVN → Vymazať na súbor alebo priečinok, okamžite sa odstráni z pracovnej kópie a pri ďalšom odovzdaní sa označí na odstránenie v úložisku. Nadradený priečinok položky zobrazí ikonu prekrytia “upravené”. Až do vykonania zmeny môžete súbor získať späť použitím ponuky TortoiseSVN → Vrátiť v nadradenom priečinku.

Ak chcete vymazať položku z úložiska, ale ponechať ju lokálne ako bezverziový súbor/priečinok, použite Rozšírenú kontextovú ponuku → Odstrániť (zachovať lokálne). Musíte pridržať Shift pri kliknutí pravým tlačidlom myši na položku na paneli zoznamu prieskumníka (pravý panel), aby ste to videli v rozšírenej kontextovej ponuke.

Ak je položka vymazaná prieskumníkom namiesto použitia kontextovej ponuky TortoiseSVN, dialógové okno odovzdania zobrazí tieto položky ako chýbajúce a umožní vám ich pred odovzdaním tiež odstrániť zo správy verzie. Ak však aktualizujete svoju pracovnú kópiu, Subversion zistí chýbajúcu položku a nahradí ju najnovšou verziou z úložiska. Ak potrebujete vymazať súbor pod správou verzie, použite vždy ponuku TortoiseSVN → Vymazať, aby Subversion nemusel hádať, čo vlastne chcete robiť.

Ak chcete jednoducho premenovať súbor alebo priečinok na mieste, použite kontextovú ponuku → Premenovať... Zadajte nový názov položky a máte hotovo.

Ak chcete presunúť súbory vnútri vašej pracovnej kópie, napríklad do iného podpriečinka, použite ťahaj a pusť pri stlačí pravého tlačidla myši:

Ďalším spôsobom presunutia alebo kopírovania súborov je použitie príkazov Windows Kopírovať/Prilepiť. Vyberte súbory, ktoré chcete kopírovať, kliknite na nich pravým tlačidlom myši a vyberte kontexovú ponuku → Kopírovať z kontextovej ponuky prieskumníka. Potom prejdite do cieľového priečinka, kliknite naňho pravým tlačidlom myši a vyberte ponuku TortoiseSVN → Prilepiť. Pre presun súborov vyberte kontextovú ponuku → Vystrihnúť namiesto kontextovej ponuky → Kopírovať.

Na presun položiek môžete tiež použiť prehľadávač úložiska. Pre získanie ďalších informácií si prečítajte časť “Prehliadač úložiska”.

Ak archív už obsahuje dva súbory s rovnakým názvom, ktoré sa však líšia iba v prípade (napr. TEST.TXT a test.txt ), nebudete môcť aktualizovať ani overiť rodičovský priečinok klientom Windows. Zatiaľ čo Subversion podporuje názvy súborov, pri ktorých sa rozlišujú veľké a malé písmená, Windows nie.

To sa niekedy stane, keď dvaja ľudia odovzdajú zo samostatných pracovných kópií súbory, ktoré majú rovnaký názov, ale s rozdielnou veľkosťou písma. Môže sa to stať aj vtedy, keď sa súbory odovzdávajú zo systému so súborovým systémom, v ktorom sa rozlišujú veľké a malé písmená, napríklad Linux.

V takom prípade sa musíte rozhodnúť, ktorý z nich si chcete ponechať a vymazať (alebo premenovať) ten druhý z úložiska.

Vaše priateľské IDE niekedy za vás premenuje súbory v rámci úkonu refaktoringu a samozrejme to Subversion nepovie. Ak sa pokúsite odovzdať zmeny, Subversion vidí starý názov súboru ako chýbajúci a nový ako bezverziový súbor. Môžete jednoducho skontrolovať nový názov súboru, aby ste ho mohli pridať, ale stratili by ste sledovanie histórie, pretože Subversion nevie, že súbory súvisia.

Lepším spôsobom je upozorniť Subversion, že táto zmena je vlastne premenovaním a môžete to urobiť v rámci dialógov Odovzdať a Skontrolovať úpravy. Jednoducho vyberte starý názov (chýbajúci) aj nový názov (bezverziový) a použite kontextovú ponuku → Opraviť presun spárujete tieto dva súbory ako premenované.

Zvyčajne nastavíte svoj zoznam ignorovaných položiek tak, aby boli všetky vygenerované súbory v Subversion ignorované. Čo však v prípade, že chcete vyčistiť všetky tieto ignorované položky, aby ste dosiahli čisté zostavu? Spravidla by ste to nastavili vo svojom makefile, ale ak ladíte makefile alebo meníte systém zostavenia, je užitočné mať k dispozícii spôsob vyčistenia paluby.

TortoiseSVN poskytuje práve takúto možnosť Rozšírená kontextová ponuka → Odstrániť bezverziové položky. Musíte pridržať Shift pri kliknutí pravým tlačidlom myši na priečinok v paneli zoznamu prieskumníka (pravý panel), aby ste to videli v rozšírenej kontextovej ponuke. Vytvorí sa dialógové okno so zoznamom všetkých bezverziových súborov kdekoľvek v pracovnej kópii. Potom môžete vybrať alebo zrušiť výber položiek, ktoré sa majú odstrániť.

Na odstránenie týchto položiek sa použije kôš, takže ak tu urobíte chybu a odstránite súbor, ktorý by mal byť verziový, môžete ho stále obnoviť.

Obrázok 4.37. Stránka vlastností Subversion

Vlastnosti Subversion môžete čítať a nastavovať z dialógového okna Vlastnosti systému Windows, ale aj z okna TortoiseSVN → Vlastnosti a v zoznamoch stavu TortoiseSVN z kontextovej ponuky → Vlastnosti.

V Subversion môžete pridať svoje vlastné vlastnosti alebo niektoré vlastnosti so zvláštnym významom. Tieto začínajú svn:. svn:externals je takou vlastnosťou; pozrite si ako zaobchádzať s externými v časti “Externé položky” .

Viac informácií o vlastnostiach v Subversion nájdete na Špeciálne vlastnosti.

Pridávanie a úprava vlastností

Obrázok 4.38. Pridávanie vlastností

Ak chcete pridať novú vlastnosť, najskôr kliknite na Nová.... V ponuke vyberte požadovaný názov vlastnosti a potom vyplňte požadované informácie v dialógovom okne konkrétnej vlastnosti. Tieto konkrétne dialógové okná vlastností sú podrobnejšie opísané v časti “Editory vlastností” .

Ak chcete pridať vlastnosť, ktorá nemá vlastné dialógové okno, zvoľtePokročilé z ponuky Nová.... Potom buď vyberte existujúcu vlastnosť v rozvinovacom poli alebo zadajte názov vlastnej vlastnosti.

Ak chcete použiť vlastnosť na viac položiek naraz, vyberte v prehľadávači súbory alebo priečinky a potom vyberte kontextovú ponuku → Vlastnosti .

Ak chcete použiť vlastnosť na každý súbor a priečinok v hierarchii pod aktuálnym priečinkom, zaškrtnite políčko Rekurzívne.

Ak chcete upraviť existujúcu vlastnosť, vyberte ju zo zoznamu existujúcich vlastností a potom kliknite na Upraviť... .

Ak chcete odstrániť existujúcu vlastnosť, vyberte ju zo zoznamu existujúcich vlastností a potom kliknite na Odstrániť .

Vlastnosť svn:externals sa dá použiť na načítanie ďalších projektov z rovnakého úložiska alebo úplne iného úložiska. Viac informácií nájdete v časti “Externé položky” .

Upraviť vlastnosti pri revízii HEAD

Pretože vlastnosti sú verziové, nemôžete upravovať vlastnosti predošlých revízií. Ak sa pozriete na vlastnosti z dialógového okna záznamu alebo z revízie inej ako HEAD v prehľadávači úložiska, zobrazí sa zoznam vlastností a hodnôt, ale bez ovládacích prvkov úprav.

TortoiseSVN má niekoľko vlastných zvláštnych vlastností, ktoré začínajú na tsvn:.

TortoiseSVN sa dá integrovať s niektorými nástrojmi na sledovanie chýb. Toto používa vlastnosti projektu, ktoré začínajú na bugtraq:. Pre ďalšie informácie si prečítajte “Integrácia so systémami sledovania chýb/sledovačmi problémov”.

Môže sa tiež integrovať s niektorými webovými prehľadávačmi archívov a používať vlastnosti projektu, ktoré začínajú webviewer:. Pre ďalšie informácie si prečítajte “Integrácia s prehliadačmi úložiska založených na webe”.

Keď do pracovnej kópie pridáte nové podpriečinky pouziťím TortoiseSVN, všetky vlastnosti projektu prítomné v nadradenom priečinku sa automaticky pridajú aj do nového podradeného priečinka.

Niektoré vlastnosti musia používať konkrétne hodnoty alebo musia byť naformátované konkrétnym spôsobom, aby sa mohli použiť na automatizáciu. S cieľom pomôcť so správnym formátovaním ponúka TortoiseSVN dialógové okná úprav pre niektoré konkrétne vlastnosti, ktoré zobrazujú možné hodnoty alebo rozdeľujú vlastnosť na jednotlivé komponenty.

Externý obsah

Obrázok 4.40. Stránka vlastnosti svn:externals

Vlastnosť svn:externals je možné použiť na načítanie iných projektov z rovnakého úložiska alebo úplne iného úložiska, ako je opísané v časti “Externé položky”.

Musíte definovať názov podpriečinka, v ktorom je externý priečinok rezervovaný a URL Subversion externej položky. Môžete si skontrolovať externé zariadenie pri jeho revízii HEAD, takže keď sa externá položka zmení v úložisku, vaša pracovná kópia dostane tieto zmeny pri aktualizácii. Ak však chcete, aby externý odkazoval na konkrétny stabilný bod, môžete určiť konkrétnu revíziu, ktorá sa má použiť. V takom prípade možno budete chcieť zadať rovnakú revíziu ako naviazanú revíziu. Ak bude externá položka v budúcnosti niekedy premenovaná, Subversion nebude môcť aktualizovať túto položku vo vašej pracovnej kópii. Zadaním revízie kolíka poviete Subversion, aby hľadala položku, ktorá mala tento názov pri naviazanej revízii a nie pri HEAD.

Tlačidlo Hľadať HEAD revíziu načíta HEAD revíziu každej externej adresy URL a zobrazí túto HEAD revíziu v stĺpci úplne vpravo. Keď je známa revízia HEAD, jednoduché kliknutie pravým tlačidlom myši na externé zariadenie vám dá príkaz na naviazanie vybraných externých používateľov s ich explicitnou revíziou HEAD. V prípade, že revízia HEAD ešte nie je známa, príkaz pravým tlačidlom myši najskôr načíta revíziu HEAD.

Kľúčové slová SVN

Obrázok 4.41. Stránka vlastnosti svn:keywords

Vyberte kľúčové slová, ktoré chcete rozšíriť do svojho súboru.

Štýl EOL

Obrázok 4.42. Stránka vlastnosti svn:eol-style

Vyberte štýl konca riadku, ktorý chcete použiť a TortoiseSVN použije správnu hodnotu vlastnosti.

Integrácia sledovača problémov

Obrázok 4.43. Stránka vlastnosti tsvn:bugtraq

Veľkosti správ záznamu

Obrázok 4.44. Stránka vlastnosti veľkosť správy záznamu

Tieto 3 vlastnosti riadia formátovanie správ záznamu. Prvé 2 deaktivujú OK v dialógových oknách na potvrdenie alebo uzamknutie, kým správa nedosiahne minimálnu dĺžku. Pozícia okraja zobrazuje značku v danej šírke stĺpca ako pomôcku pre projekty, ktoré majú vo svojich protokolových správach obmedzenú šírku. Nastavením hodnoty na nulu sa vlastnosť odstráni.

Jazyk projektu

Obrázok 4.45. Stránka vlastnosti jazyka

V dialógovom okne odovzdania vyberte jazyk, ktorý sa má použiť na kontrolou pravopisu správy záznamu. Súbor rozvinovacieho poľa nadobudne účinnosť po kliknutí pravým tlačidlom myši na paneli správ záznamu a výbere Prilepiť zoznam súborov. Stav Subversion sa predvolene zobrazuje vo vašom miestnom jazyku. Keď je toto políčko zaškrtnuté, stav je vždy uvedený v angličtine, pre projekty, ktoré vyžadujú správy záznamu iba v angličtine.

Typ MIME

Obrázok 4.46. Stránka vlastnosti svn:mime-type

svn:needs-lock

Obrázok 4.47. Stránka vlastností svn:needs-lock

Táto vlastnosť jednoducho riadi, či bude súbor zaškrtnutý iba na čítanie, ak pre neho nie je v pracovnej kópii uzamknutý žiadny zámok.

svn:executable

Obrázok 4.48. Stránka vlastnosti svn:executable

Táto vlastnosť riadi, či bude súboru po spustení v systéme Unix/Linux zaškrtnutý stav spustiteľného súboru. Nemá to žiadny vplyv na zaškrtnutie v systéme Windows.

Šablóny správ záznamu zlúčenia

Kedykoľvek sú revízie zlúčené do pracovnej kópie, TortoiseSVN vygeneruje správu záznamu zo všetkých zlúčených revízií. Tie sú potom k dispozícii na webe Nedávne správy v dialógovom okne odovzdania.

Vygenerovanú správu môžete prispôsobiť použitím nasledujúcich vlastností:

Obrázok 4.49. Šablóny dialóg vlastností dialóg záznamu

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

Táto vlastnosť určuje prvú časť vygenerovanej správy záznamu. Môžu byť použité nasledujúce kľúčové slová:

{revisions}

Zoznam zlúčených revízií oddelený čiarkami, napr. 3, 5, 6, 7

{revisionsr}

Ako {revisions}, ale pri každej revízii predchádza znak r, napr. r3, r5, r6, r7

{revrange}

Zoznam zlúčených revízií oddelený čiarkami, podľa možnosti zoskupený do rozsahov, napr. 3, 5-7

{mergeurl}

Zdrojová adresa URL zlúčenia, t. j. odkiaľ sú revízie zlúčené.

Predvolená hodnota pre tento reťazec je Zlúčené revízie {revrange} z {mergeurl}: s novým riadkom na konci.

tsvn:mergelogtemplatemsg

Táto vlastnosť určuje, ako by mal vyzerať text pre každú zlúčenú revíziu. Môžu byť použité nasledujúce kľúčové slová:

{msg}

Správa záznamu zlúčenej revízie tak, ako bola zadaná.

{msgoneline}

Ako {msg}, ale všetky nové riadky sú nahradené medzerou pre zobrazenie celej správy záznamu v jednom riadku.

{author}

Autor zlúčenej revízie.

{rev}

Samotná zlúčená revízia.

{bugids}

ID chyby zlúčenej revízie, ak existuje.

tsvn:mergelogtemplatemsgtitlebottom

Táto vlastnosť určuje pozíciu reťazca názvu zadaného výrazom tsvn:mergelogtemplatetitle alebo tsvn:mergelogtemplatereversetitle. Ak je vlastnosť nastavená na Áno alebo PRAVDA, potom reťazec názvu je pripojený dole a nie hore.

Dôležité

Toto funguje, iba ak sú zlúčené revízie už v zásobníku záznamov. Ak ste deaktivovali zásobník záznamov alebo ste ho pred zlúčením nezobrazili ako prvý, vygenerovaná správa nebude obsahovať žiadne informácie o zlúčených revíziách.

Povedzme, že ste si overili pracovnú kópiu /project1 do D:\dev\project1. Vyberte priečinok D:\dev\project1 , kliknite pravým tlačidlom myši a vyberte si ponuku Windows → Vlastnosti z kontextovej ponuky. Zobrazí sa dialógové okno Vlastnosti. Potom prejdite na kartu Subversion. Tam môžete nastaviť vlastnosti. Kliknite Vlastnosti .... V dialógovom okne vlastností dvakrát kliknite na svn:externals ak už existuje, alebo kliknite na tlačidlo Nová... a vyberte externé z ponuky. Ak chcete pridať nové externé zariadenie, kliknite na tlačidlo Nová... a potom vyplňte požadované informácie v zobrazenom dialógovom okne.

Ak chcete, aby miestna cesta obsahovala medzery alebo iné špeciálne znaky, môžete ju uzavrieť do úvodzoviek alebo môžete použiť znak \ (spätná lomka) ako znak významu štýlu unixového prostredia predchádzajúci ktorémukoľvek špeciálnemu znaku. To samozrejme tiež znamená, že musíte používať znak / (lomka) ako oddeľovač cesty. Toto správanie je nové v Subversion 1.6 a nebude fungovať so staršími klientmi.

Ak je externý projekt v rovnakom úložisku, všetky zmeny, ktoré v ňom vykonáte, sa zahrnú do zoznamu odovzdania, keď budete potvrdzovať svoj hlavný projekt.

Ak je externý projekt v inom úložisku, všetky zmeny, ktoré vykonáte v externom projekte, sa zobrazia alebo označia pri odovzdaní hlavného projektu, ale tieto externé zmeny musíte vykonať osobitne.

Ak v systéme používate absolútne adresy URL definície svn:externals a musíte premiestniť svoju pracovnú kópiu (t. j. ak sa zmení adresa URL vášho úložiska), potom sa vaše externé súbory nezmenia a už nebudú fungovať.

Aby sa takýmto problémom predišlo, klienti Subversion verzie 1.5 a vyššej podporujú relatívne externé adresy URL. Podporované sú štyri rôzne spôsoby určenia relatívnej adresy URL. V nasledujúcich príkladoch predpokladajme, že máme dva úložiská: jedno na adrese http://example.com/svn/repos-1 a ďalšie na http://example.com/svn/repos-2. Máme vykonať overenie z http://example.com/svn/repos-1/project/trunk do C:\Working a vlastnosť svn:externals je nastavená na kmeni.

V prípade potreby môžete tiež určiť naviazanú a operatívnu revíziu ak sú požadované pre adresu URL. Ak sa chcete dozvedieť viac o naviazaných a operatívnych revíziách, prečítajte si zodpovedajúca kapitola v knihe Subversion.

Ak potrebujete ďalšie informácie o tom, ako TortoiseSVN narába s vlastnosťami prečítajte si “Nastavenia Projektu”.

Viac sa dozviete o rôznych metódach prístupu k bežným podprojektom v časti “Zahrnúť spoločný podprojekt”.

Od verzie Subversion 1.6 môžete do svojej pracovnej kópie pridať externé súbory jedného súboru použitím rovnakej syntaxe ako pre priečinky. Existujú však určité obmedzenia.

Externý súbor sa chová v mnohých ohľadoch ako každý iný verziový súbor, ale nemožno ho presunúť ani vymazať použitím bežných príkazov; vlastnosť svn:externals namiesto toho musí byť upravená.

Ak už máte pracovnú kópiu súborov alebo priečinkov, ktoré chcete zahrnúť ako externé v inej pracovnej kópii, môžete ich jednoducho pridať pomocou funkcie Ťahaj a pusť z prieskumníka systému Windows.

Jednoducho súbor alebo priečinok ťahajte pri stlačenom pravom tlačidle z jednej pracovnej kópie na miesto, kde ho chcete zahrnúť ako externý. Po uvoľnení tlačidla myši sa zobrazí kontextová ponuka: SVN Pridať ako externý sem ak kliknete na túto položku kontextovej ponuky, vlastnosť svn:externals sa pridá automaticky. Všetko, čo musíte urobiť, je vykonať zmeny vlastností a aktualizovať ich, aby boli tieto externé súbory správne zahrnuté do vašej pracovnej kópie.

Ak ste importovali svoj projekt s odporúčanou štruktúrou priečinkov, vytvorenie verzie pobočky alebo príznaku je veľmi jednoduché:

Obrázok 4.50. Dialóg vetvy/príznaku

Vyberte priečinok vo svojej pracovnej kópii, ktorý chcete skopírovať do vetvy alebo príznaku a potom vyberte príkaz TortoiseSVN → Vetva/príznak....

Predvolená cieľová adresa URL pre novú vetvu bude zdrojová adresa URL, na ktorej je založená vaša pracovná kópia. Túto adresu URL budete musieť upraviť na novú cestu k svojej vetve/príznaku. Takže namiesto

http://svn.collab.net/repos/ProjectName/trunk
      

teraz môžete použiť niečo ako

http://svn.collab.net/repos/ProjectName/tags/Release_1.10
      

Ak si nepamätáte, aké pomenovanie ste použili naposledy, kliknutím pravým tlačidlom otvoríte prehľadávač úložiska, aby ste si mohli prezrieť existujúcu štruktúru úložiska.

Teraz musíte zvoliť zdroj kópie. Tu máte tri možnosti:

Ak chcete, aby sa vaša pracovná kópia automaticky prepínala do novovytvorenej vetvy, zaškrtnite políčko Prepnúť pracovnú kópiu na novú vetvu/príznak. Ak to však urobíte, najskôr sa ubezpečte, že vaša pracovná kópia neobsahuje úpravy. Ak sa tak stane, tieto zmeny sa pri prepnutí zlúčia do vetvy pracovnej kópie.

Ak vaša pracovná kópia obsahuje ďalšie projekty s vlastnosťou svn:externals, tieto externé položky budú uvedené v spodnej časti dialógového okna vetvy/príznaku. Pre každú externú adresu sa zobrazí cieľová cesta a zdrojová adresa URL.

Ak sa chcete ubezpečiť, že nový príznak je vždy v konzistentnom stave, skontrolujte všetky externé stránky, aby ich revízie mali pripnuté. Ak neskontrolujete externé komponenty a tieto externé komponenty odkazujú na revíziu HEAD, ktorá sa v budúcnosti môže zmeniť, kontrolou nového príznaku sa skontroluje, či sa HEAD revízia externá a vášho príznaku už nemusí skompilovať. Pri vytváraní príznaku je preto vždy dobré upraviť externé na explicitné revízie.

Externé zdroje sa automaticky pripnú buď k aktuálnej revízii HEAD, alebo k revízii bázy pracovnej kópie, v závislosti od zdroja vetvy/príznaku:

Stlačte OK pre odovzdanie novej kópie do úložiska. Nezabudnite uviesť správu záznamu. Upozorňujeme, že kópia je vytvorená vnútri úložiska.

Upozorňujeme, že pokiaľ ste sa nerozhodli prepnúť svoju pracovnú kópiu na novovytvorenú vetvu, vytvorenie vetvy alebo príznaku neovplyvní vašu pracovnú kópiu. Aj keď vytvoríte vetvu zo svojej pracovnej kópie, tieto zmeny sa vykonajú v novej vetve, nie v kmeni, takže vaša pracovná kópia môže byť stále označený ako upravená vzhľadom ku kmeňu.

Môžete tiež vytvoriť vetvu alebo príznak bez pracovnej kópie. Ak to chcete urobiť, otvorte prehľadávač úložiska. Môžete tam presunúť priečinky na nové miesto. Musíte pridržať Ctrl pri vytváraní kópie ťahaním, inak sa priečinok presunie, nie skopíruje.

Priečinok môžete pretiahnuť aj stlačenom pravom tlačidle myši. Po uvoľnení tlačidla myši môžete si z kontextovej ponuky vybrať, či chcete priečinok presunúť alebo skopírovať. Ak chcete vytvoriť vetvu alebo príznak, musíte priečinok samozrejme skopírovať a nie ho presunúť.

Ďalším spôsobom je dialógové okno záznamu. Môžete zobraziť dialógové okno záznamu napr. pre kmeň, vyberte revíziu (buď HEAD revíziu úplne hore alebo predošlú revíziu), kliknutím na ňu pravým tlačidlom myši a vyberte vytvoriť vetvu/príznak z revízie....

...to je (nie naozaj) otázka. Zatiaľ čo overenie stiahne všetko z požadovanej vetvy v úložisku do vášho pracovného priečinka, TortoiseSVN → Prehodiť... prenesie iba zmenené údaje do vašej pracovnej kópie. Dobré pre zaťaženie siete, dobré pre vašu trpezlivosť. :-)

Aby ste mohli pracovať s vašou čerstvo vygenerovanou vetvou alebo príznakom, máte k dispozícii niekoľko spôsobov, ako s nimi pracovať. Môžete:

Obrázok 4.51. Dialógové okno prehodenia

Aj keď Subversion sám nerozlišuje medzi príznakmi a vetvami, spôsob, akým sa zvyčajne používajú, sa trochu líši.

Obrázok 4.52. Sprievodca zlúčením - výber rozsahu revízií

V poli Z: zadajte úplnú adresu priečinka vetvy alebo príznaku obsahujúceho zmeny, ktoré chcete preniesť do svojej pracovnej kópie. Môžete tiež kliknúť na ... pre prehľadanie úložiska a nájdenie požadovanej vetvy. Ak predtým máte zlúčenie z tejto vetvy, stačí použiť rozvinovací zoznam, ktorý zobrazuje históriu predtým použitých adries URL.

Ak zlučujete z premenovanej alebo odstránenej vetvy, budete sa musieť vrátiť k revízii, kde táto vetva stále existovala. V tomto prípade budete tiež musieť určiť túto revíziu ako naviazanú revíziu v rozsahu zlúčených revízií (pozri nižšie), inak zlúčenie zlyhá, keď nenájdete túto cestu na HEAD.

V poli Rozsah revízií na zlúčenie zadajte zoznam revízií, ktoré chcete zlúčiť. Môže to byť jedna revízia, zoznam konkrétnych revízií oddelených čiarkami alebo rozsah revízií oddelených pomlčkou alebo ich ľubovoľná kombinácia.

Ak potrebujete určiť naviazanú revíziu pre zlúčenie, pridajte naviazanú revíziu na koniec revízií, napr. 5-7, 10@3. V uvedenom príklade by sa zlúčili revízie 5, 6, 7 a 10, pričom 3 by bola naviazanou revíziou.

Najjednoduchší spôsob, ako zvoliť požadovaný rozsah revízií, je kliknúť na Zobraziť záznam, ako budú uvedené posledné zmeny s komentármi záznamu. Ak chcete zlúčiť zmeny z jednej revízie, jednoducho ju vyberte. Ak chcete zlúčiť zmeny z niekoľkých revízií, vyberte tento rozsah (obvyklým spôsobom modifikátorom Shift). Kliknite na OK a naplní sa zoznam čísel revízií, ktoré sa majú zlúčiť.

Ak chcete zlúčiť zmeny späť zo svojej pracovnej kópie, ak chcete vrátiť späť zmenu, ktorá už bola vykonaná, vyberte revízie, ktoré sa majú vrátiť a uistite sa, že je zaškrtnuté políčko Reverzné zlúčenie.

Ak ste už zlúčili niektoré zmeny z tejto vetvy, dúfajme, že si všimnete poslednú revíziu zlúčenú do správy záznamu, keď ste vykonali zmenu. V takom prípade môžete použiť Zobraziť záznam pre pracovnú kópiu na vysledovanie tejto správy záznamu. Pamätajte, že revízie považujeme za sústavu zmien, mali by ste použiť revíziu po koncovom bode posledného zlúčenia ako začiatočný bod tohto zlúčenia. Napríklad ak ste naposledy zlúčili revízie 37 až 39, východiskovým bodom pre toto zlúčenie by mala byť revízia 40.

Ak používate funkcie Subversion na trasovanie zlúčenia, nemusíte si pamätať, ktoré revízie už boli zlúčené - Subversion to za vás zaznamená. Ak necháte rozsah revízií prázdny, zahrnú sa všetky revízie, ktoré ešte neboli zlúčené. Nájdete via prečítaním časti “Sledovanie zlučovania”.

Keď sa použijete trasovanie zlúčenia, dialógové okno záznamu zobrazí predtým zlúčené revízie a revízie staršie ako pred skopírovaním vetvy, t. j. pred skopírovaním vetvy. Zaškrtávacie políčko Skryť nezlučiteľné revízie umožňuje úplne odfiltrovať tieto revízie, takže uvidíte iba revízie, ktoré môžete zlúčiť.

Ak zmeny môžu robiť iní ľudia, buďte pri použití revízie HEAD opatrní. Nemusí sa to vzťahovať na revíziu, na ktorú myslíte, ak niekto cudzí vykonal odovzdanie po vašej poslednej aktualizácii.

Ak necháte rozsah revízií prázdny alebo máte prepínač všetky revízie zaškrtnutý, potom Subversion zlúči všetky zatiaľ nezlúčené revízie. Toto sa nazýva reintegrácia alebo automatické zlúčenie.

Existujú určité podmienky, ktoré sa vzťahujú na zlúčenie alebo reintegráciu. Najskôr musí server podporovať sledovanie zlúčenia. Pracovná kópia musí byť nekonečne hlboká (žiadne roztrúsené overenia) a nesmie obsahovať žiadne miestne úpravy, prehodené položky alebo vetvy, ktoré boli aktualizované na iné verzie ako HEAD. Všetky zmeny v kmeni vykonané počas vývoja vetvy musia byť zlúčené do vetvy (alebo označené ako zlúčené). Rozsah revízií na zlúčenie sa vypočíta automaticky.

Kliknite na tlačidlo Ďalej a prejdite do “Možnosti zlúčenia” .

Obrázok 4.53. Sprievodca zlúčením - Zlúčenie stromu

Ak používate túto metódu na zlúčenie funkčnej vetvy späť do kmeňa, musíte spustiť sprievodcu zlúčením z pracovnej kópie kmeňa.

V poli Z: zadajte celú adresu URL priečinka kmeňa. Môže to znieť zle, ale nezabudnite, že kmeň je východiskový bod, do ktorého chcete pridať zmeny vetvy. Môžete tiež kliknúť ... na prehliadanie úložiska.

V poli Do: zadajte úplnú adresu priečinka funkčnej vetvy.

V oboch poliach Z revízie a Do revízie zadajte číslo poslednej revízie, pri ktorej boli tieto dva stromy synchronizované. Ak ste si istí, že nikto iný vykonáva odovzdanie, môžete v obidvoch prípadoch použiť revíziu HEAD. Ak existuje šanca, že od tejto synchronizácie mohol niekto iný vykonať odovzdanie, použite číslo konkrétnej revízie, aby ste nestratili novšie provízie.

Môžete tiež použiť Zobraziť záznam na výber revízie.

Táto stránka sprievodcu vám umožňuje určiť rozšírené možnosti pred začatím procesu zlúčenia. Väčšinou stačí použiť predvolené nastavenie.

Môžete určiť hĺbku, ktorá sa má použiť na zlúčenie, t. j. ako hlboko do vašej pracovnej kópie má zlúčenie ísť. Použité pojmy hĺbky sú opísané v časti “Hĺbka overenia”. Predvolená hĺbka je Pracovná kópia, ktorá využíva existujúce nastavenie hĺbky a je takmer vždy to, čo chcete.

Väčšinou chcete zlúčením zohľadniť históriu súboru, aby sa zlúčili zmeny týkajúce sa spoločného predka. Niekedy bude možno potrebné zlúčiť súbory, ktoré možno súvisia, ale nie vo vašom úložisku. Napríklad môžete mať importované verzie 1 a 2 knižnice tretej strany do dvoch samostatných priečinkov. Aj keď logicky súvisia, Subversion o tom nevie, pretože vidí iba importované dechtové lopty. Ak sa pokúsite zlúčiť odlišnosti medzi týmito dvoma stromami, uvidíte úplné odstránenie a úplné pridanie. Ak chcete, aby Subversion používal iba odlišnosti založené na ceste a nie odlišnosti založené na histórii, zaškrtnite políčko Ignorovať predkov. Prečítajte si viac o tejto téme v knihe Subversion, časť Všímať si alebo ignorovať predkov .

Môžete určiť spôsob, akým sa bude zaobchádzať s ukončením riadkov a zmenami bielych znakov. Tieto možnosti sú popísané v časti “Ukončenia riadkov a biele znaky”. Predvolené správanie je považovať všetky biele znaky a odlišnosti medzi riadkami ako skutočné zmeny na zlúčenie.

Zaškrtávacie políčko je označené Vynútiť zlúčenie sa používa na zabránenie konfliktu stromov, pri ktorom prichádzajúce odstránenie ovplyvňuje súbor, ktorý je buď lokálne upravený, alebo je bezverziový. Ak je súbor odstránený, neexistuje žiadny spôsob, ako ho obnoviť a preto táto možnosť nie je predvolene zaškrtnutá.

Ak používate trasovanie zlúčenia a chcete označiť revíziu ako zlúčenú, bez skutočného zlúčenia na tomto mieste, zaškrtnite políčko Zaznamenať iba zlúčenie. Môžete to urobiť z dvoch možných dôvodov. Je možné, že zlúčenie je pre algoritmy zlúčenia príliš komplikované, takže zmeníte kód ručne a potom označíte zmenu ako zlúčenú, aby si to algoritmus sledovania zlúčenia bral do úvahy. Alebo budete chcieť zabrániť zlúčeniu konkrétnej revízie. Označenie ako už zlúčené zabráni tomu, aby k zlúčeniu došlo u klientov podporujúcich sledovanie zlúčenia.

Teraz je všetko nastavené, stačí kliknúť na tlačidlo Zlúčiť. Ak chcete zobraziť náhľad výsledkov Testovať zlúčenie simuluje operáciu zlúčenia, ale vôbec neupravuje pracovnú kópiu. Ukáže vám zoznam súborov, ktoré sa zmenia skutočným zlúčením a zaznamená súbory, ktoré v konflikte môžu nastať. Pretože trasovanie zlúčenia značne komplikuje proces zlúčenia, neexistuje zaručený spôsob, ako vopred zistiť, či sa zlúčenie dokončí bez konfliktov, takže súbory označené v testovacom zlúčení ako konfliktné sa môžu v skutočnosti zlúčiť bez akýchkoľvek problémov.

Dialógové okno priebehu zlúčenia zobrazuje každú fázu zlúčenia vrátane zahrnutých rozsahov revízií. Môže to znamenať ešte jednu revíziu, než ste čakali. Napríklad, ak ste požiadali o zlúčenie revízie 123, zobrazí sa dialógové okno o priebehu “Zlúčenie revízií 122 až 123”. Aby ste to pochopili, musíte si uvedomiť, že program Zlúčiť úzko súvisí s programom Porovnať odlišnosti. Proces zlúčenia funguje tak, že sa vygeneruje zoznam rozdielov medzi dvoma bodmi v úložisku a tieto rozdiely sa použijú na vašu pracovnú kópiu. Dialógové okno priebehu jednoducho zobrazuje začiatočný a koncový bod odlišnosti.

Zlúčenie je teraz dokončené. Je dobré sa pozrieť na zlúčenie a zistiť, či je podľa očakávaní. Zlúčenie je zvyčajne dosť komplikované. Konflikty často vznikajú, ak sa vetva posunula ďaleko od kmeňa.

Pre klientov a servery Subversion pred 1.5 sa neukladajú žiadne informácie o zlúčení a zlúčené revízie sa musia sledovať ručne. Keď ste zmeny otestovali a vykonali ste odovzdanie tejto revízie, mala by vaša správa záznamu odovzdania vždy obsahovať čísla revízií, ktoré boli prenesené do zlúčenia. Ak chcete neskôr použiť ďalšie zlúčenie, budete potrebovať vedieť, čo ste už zlúčili, pretože nechcete preniesť zmenu viackrát. Viac informácií o tomto nájdete na Osvedčené postupy pre zlúčenie v knihe Subversion.

Ak je na vašom serveri a všetkých klientoch spustený server Subversion 1.5 alebo novší, zariadenie na sledovanie zlúčenia zaznamená zmeny zlúčených revízií a zabráni viacnásobnému zlúčeniu revízií. To vám uľahčuje život, pretože môžete jednoducho zakaždým zlúčiť celý rozsah revízií a vedieť, že v skutočnosti budú zlúčené iba nové revízie.

Spravovanie vetvy je dôležité. Ak chcete túto vetvu udržiavať v aktualizovanom stave s kmeňom, mali by ste ich často zlučovať, aby sa vetva a kmeň nevzdiaľovali od seba príliš ďaleko. Samozrejme, stále by ste sa mali vyhnúť opakovanému zlučovaniu zmien, ako je vysvetlené vyššie.

Subversion 1.5 priniesol možnosti na sledovanie zlúčenia. Keď zlúčite zmeny z jedného stromu do druhého, uloží sa zlúčené čísla revízií a tieto informácie sa dajú použiť na niekoľko rôznych účelov.

Informácie o sledovaní zlúčenia sú uložené vo vlastnosti svn:mergeinfo klienta pri uskutočňovaní zlúčenia. Keď dôjde k zlúčeniu, server uloží tieto informácie do databázy a keď požadujete informácie o zlúčení, zázname alebo vyvodení zodpovednosti, server môže príslušne odpovedať. Aby systém fungoval správne, musíte zabezpečiť aktualizáciu servera, úložiska a všetkých klientov. Skorší klienti nebudú uchovávať vlastnosť svn:mergeinfo a staršie servery nebudú poskytovať informácie požadované novými klientmi.

Viac informácií o sledovaní zlúčenia získate od spoločnosti Subversion Dokumentácia na sledovanie zlúčenia .

Zlúčenie nemusí vždy prebehnúť hladko. Niekedy dôjde ku konfliktu. TortoiseSVN vám týmto procesom pomôže zobrazením dialógu zlúčiť konflikt.

Obrázok 4.54. Dialógové okno Zlúčiť konflikt

Je pravdepodobné, že niektoré zo zmien sa spoja hladko, zatiaľ čo iné lokálne zmeny sú v rozpore so zmenami, ktoré sú už v úložisku potvrdené. Všetky zmeny, ktoré je možné zlúčiť, sa zlúčia. Dialógové okno Zlúčiť konflikt vám poskytuje rôzne spôsoby riešenia konfliktov.

V prípade normálnych konfliktov, ku ktorým dôjde v dôsledku zmien v obsahu súboru alebo jeho vlastnostiach, sa v dialógovom okne zobrazia tlačidlá, ktoré vám umožňujú zvoliť, ktoré z konfliktných častí sa majú zachovať alebo odmietnuť.

Ak dôjde ku konfliktu stromov, najskôr pozrite si časť “Konflikty stromov” o rôznych druhoch konfliktov stromov a o tom, ako a prečo k nim môže dôjsť.

Na vyriešenie konfliktov stromov po zlúčení sa zobrazí dialógové okno s rôznymi možnosťami riešenia konfliktu:

Obrázok 4.55. Dialógové okno Konflikt zlúčenia stromov

Pretože existujú rôzne možné konfliktné situácie v strome, v dialógovom okne sa zobrazia tlačidlá na ich vyriešenie v závislosti od konkrétneho konfliktu. Texty a štítky tlačidiel vysvetľujú, čo robí voľba riešenia konfliktu. Ak si nie ste istí, buď zrušte dialógové okno, alebo použite tlačidlo Odložiť pre neskoršie vyriešenie konfliktu.

Keď vyvíjate novú funkciu v samostatnej vetve, je dobré po dokončení tejto funkcie vypracovať politiku opätovnej integrácie. Ak prebiehajú ďalšie práce na kmeni zároveň môžete zistiť, že sa rozdiely časom stanú výraznými a spätné zlúčenie sa stane nočnou morou.

Ak je funkcia pomerne jednoduchá a vývoj nebude trvať dlho, môžete zvoliť jednoduchý prístup, ktorým je ponechať vetvu úplne oddelenú, kým nebude funkcia úplná, a potom zlúčiť zmeny vetvy späť do kmeňa. V sprievodcovi zlúčením by to bolo jednoduché Zlúčiť celý rozsah revízií, pričom rozsah revízií je rozsah revízií vetvy.

Ak bude táto funkcia trvať dlhšie a je potrebné zohľadniť zmeny v kmeni, potom musíte vetvu synchronizovať. To jednoducho znamená, že pravidelne zlúčujete zmeny kmeňa do vetvy, takže vetva obsahuje všetky zmeny kmeňa plus novú funkciu. Proces synchronizácie používa Zlúčiť celý rrozsah revízií. Keď je funkcia dokončená, môžete ju zlúčiť späť do kmeňa pomocou buď Znovu integrovať vetvu alebo Zlúčiť dva rôzne stromy .

Ďalším (rýchlym) spôsobom zlúčenia všetkých zmien z kmeňa do vetvy funkcií je použitie súboru TortoiseSVN → Zlúčiť všetko... z rozšírenej kontextovej ponuky (pridržte stlačené tlačidlo Shift a kliknite pravým tlačidlom myši na súbor).

Obrázok 4.56. Dialóg Zlúčiť všetko

Tento dialóg je veľmi jednoduchý. Musíte len nastaviť možnosti zlúčenia, ako je opísané v časti “Možnosti zlúčenia”. Zvyšok vykoná TortoiseSVN automaticky použitím sledovania zlúčenia.

V predvolenom nastavení nie je nič zamknuté a ktokoľvek, kto má prístup na odovzdanie, môže kedykoľvek vykonať zmeny v ľubovoľnom súbore. Ostatní budú pravidelne aktualizovať svoje pracovné kópie a zmeny v úložisku sa zlúčia s miestnymi zmenami.

Ak Získate zámok súboru, potom ho môžete odovzdať iba vy. Odovzdania všetkých ostatných používateľov budú blokované, kým zámok neuvoľníte. Zamknutý súbor nemožno v úložisku nijako upravovať, takže ho nemožno vymazať ani premenovať, okrem vlastníka zámku.

Ostatní používatelia však nemusia nevyhnutne vedieť, že ste obsadili zámok. Pokiaľ stav zámku pravidelne nekontrolujú, najskôr sa o tom dozvedia, keď zlyhá ich odovzdanie, čo nie je vo väčšine prípadov veľmi vhodné. Na uľahčenie správy zámkov existuje nová vlastnosť Subversion svn:needs-lock. Keď je táto vlastnosť nastavená (na ľubovoľnú hodnotu) v súbore, pri každej rezervácii alebo aktualizácii súboru sa z miestnej kópie vytvorí iba na čítanie pokiaľ pracovná kópia obsahuje zámok súboru. Toto slúži ako varovanie, že by ste tento súbor nemali upravovať, pokiaľ ste predtým nezískali zámok. Súbory sú verziové a iba na čítanie sú v TortoiseSVN označené špeciálnym prekrytím, čo naznačuje, že pred úpravou musíte získať zámok.

Zámky sa zaznamenávajú podľa umiestnenia pracovnej kópie aj podľa vlastníka. Ak máte niekoľko pracovných kópií (doma, v práci), môžete zabrať iba jeden zámok týchto pracovných kópií.

Ak niekto z vašich spolupracovníkov získa zámok a potom odíde na dovolenku bez toho, aby ho uvoľnil, čo urobíte? Subversion poskytuje prostriedky na vynútenie uzamknutia. Uvoľnenie zámku, ktorý drží niekto iný, sa označuje ako prelomenie zámku a násilné získanie zámku, ktorý už drží niekto iný, sa označuje ako ukradnutie zámku. Prirodzene to nie sú veci, ktoré by ste mali robiť ľahkovážne, ak chcete zostať priateľmi so svojimi spolupracovníkmi.

Zámky sa zaznamenávajú v úložisku a vo vašej miestnej pracovnej kópii sa vytvorí značka zámku. Ak dôjde k nezrovnalosti, napríklad ak niekto iný prelomil zámok, značka miestneho zámku sa stane neplatnou. Úložisko je vždy definitívnym odkazom.

Vyberte súbory vo svojej pracovnej kópii, pre ktoré chcete získať zámok, a potom vyberte príkaz TortoiseSVN → Získať zámok....

Obrázok 4.57. Dialóg Zamykanie

Zobrazí sa dialógové okno, ktoré vám umožní zadať komentár, aby ostatní videli, prečo ste súbor uzamkli. Komentár je voliteľný a v súčasnosti sa používa iba s archívmi založenými na Svnserve. Ak (a len ak) potrebujete ukradnúť zámok niekomu inému, zaškrtnite Ukradnúť zámok a potom kliknite na OK .

Môžete nastaviť vlastnosť projektu tsvn:logtemplatelock tak, aby poskytovala užívateľom šablóny správy na vyplnenie ako uzamknutú správu. Pokyny na nastavenie vlastností sú časti “Nastavenia Projektu”.

Ak vyberiete priečinok a potom použijete TortoiseSVN → Získať zámok... dialógové okno uzamknutia otvorí každý súbor v každom podpriečinku vybraného na uzamknutie. Ak chcete skutočne uzamknúť celú hierarchiu, je to spôsob, ako to urobiť, ale mohli by ste sa stať veľmi nepopulárnymi u vašich spolupracovníkov, ak by ste ich vylúčili z celého projektu. Používajte to opatrne...

Aby ste nezabudli uvoľniť zámok, ktorý už nepotrebujete, uzamknuté súbory sa zobrazia v dialógovom okne odovzdania a predvolene sa vyberú. Ak budete pokračovať v odovzdávaní, zámky, ktoré máte na vybratých súboroch, sa odstránia, aj keď súbory neboli upravené. Ak nechcete uvoľniť zámok pre určité súbory, môžete ich zaškrtnutie zrušiť (ak nie sú upravené). Ak si chcete ponechať zámok nad súborom, ktorý ste upravili, musíte povoliť zaškrtávacie políčko Uchovať zámky pred vykonaním zmien.

Ak chcete zámok uvoľniť manuálne, vyberte v pracovnej kópii súbory, pre ktoré chcete zámok uvoľniť, a potom vyberte príkaz TortoiseSVN → Uvoľniť zámok. Nie je už čo zadávať, takže TortoiseSVN kontaktuje úložisko a uvoľní zámky. Tento príkaz môžete tiež použiť v priečinku na rekurzívne uvoľnenie všetkých zámkov.

Obrázok 4.58. Dialógové okno Kontrola zmien

Pre pozretie zabratia zámku vami alebo inými, môžete použiť TortoiseSVN → Kontrola úprav.... Lokálne držané značky zámku sa zobrazia okamžite. Ak chcete skontrolovať zámky, ktoré držia iní (a zistiť, či nie sú niektoré z vašich zámkov prelomené alebo ukradnuté), musíte kliknúť na Skontrolovať úložisko.

Z kontextovej ponuky môžete tiež získať a uvoľniť zámky, ako aj prelomiť a ukradnúť zámky držané inými.

Ako už bolo spomenuté vyššie, najefektívnejším spôsobom použitia zamknutia je nastavenie vlastnosti svn:needs-lock na súboroch. Pokyny na nastavenie vlastností sú v časti “Nastavenia Projektu”. Súbory s týmto nastavením vlastnosti budú vždy kontrolované a aktualizované so nastavením príznaku iba na čítanie, pokiaľ vaša pracovná kópia neobsahuje zámok.

Pripomíname, že TortoiseSVN to označuje špeciálnym prekrytím.

Ak uplatňujete politiku, pri ktorej musí byť každý súbor uzamknutý, môže byť jednoduchšie použiť funkciu automatických rekvizít Subversion na automatické nastavenie vlastnosti vždy, keď pridáte nové súbory. Pre ďalšie informácie si prečítajte časť “Automatické nastavenie vlastnosti”.

Keď vytvoríte nové úložisko so Subversion 1.2 alebo vyšším, v priečinku úložiska hooks sa vytvoria štyri šablóny háku. Nazývajú sa pred a po získaní zámku a pred a po uvoľnení zámku.

Je dobrý nápad nainštalovať skripty háku pred zamknutím a po odomknutí na serveri, ktorý odošle e-mail s oznámením o zamknutom súbore. Po zavedení takého skriptu môžu byť všetci vaši používatelia upozornení, ak niekto uzamkne/odomkne súbor. Nájdete ukážkový skript háku v priečinku hooks/post-lock.tmpl vo vašom úložisku.

Môžete tiež použiť háky na zakázanie prelomenia alebo ukradnutie zámkov, alebo ich môžete obmedziť na menovaného správcu. Prípadne môžete vlastníkovi poslať e-mail, keď je jeden z jeho zámkov prelomený alebo ukradnutý.

Ak sa chcete dozvedieť viac prečítajte si časť “Skripty háku na strane servera”.

Najprv musíte urobiť a otestovať vaše zmeny. Potom namiesto použitia TortoiseSVN → Odovzdať... v nadradenom priečinku vyberiete TortoiseSVN → Vytvoriť opravnú záplatu...

Obrázok 4.59. Dialógové okno Vytvoriť opravnú záplatu

teraz môžete vybrať súbory, ktoré chcete zahrnúť do opravnej záplaty, rovnako ako pri plnom odovzdaní. Takto sa vytvorí jeden súbor obsahujúci súhrn všetkých zmien, ktoré ste vo vybraných súboroch vykonali od poslednej aktualizácie z úložiska.

Stĺpce v tomto dialógovom okne je možné prispôsobiť rovnakým spôsobom ako stĺpce v dialógu Skontrolovať zmeny. Pre ďalšie podrobnosti si prečítajte časť “Lokálny a vzdialený stav”.

Kliknutím na tlačidlo Možnosti môžete určiť, ako je opravná záplata vytvorená. Môžete napríklad určiť, že zmeny v zakončení riadkov alebo bielych znakoch nebudú zahrnuté v konečnom súbore opravnej záplaty.

Môžete vytvoriť samostatné opravné záplaty obsahujúce zmeny v rozdielnych sústavách súborov. Samozrejme, ak vytvoríte súbor opravnej záplaty, urobíte v ňom ďalšie zmeny tých istých súborov a potom vytvoríte ďalšiu opravnú záplatu, druhý súbor opravnej záplaty bude obsahovať obe sústavy zmien.

Stačí uložiť súbor použitím názvu súboru podľa vášho výberu. Súbory opravnej záplaty môžu mať ľubovoľnú príponu, ktorá sa vám páči, ale podľa konvencie by mali používať .diff alebo .dif príponu. Teraz ste pripravení odovzdať svoj súbor opravnej záplaty.

Opravnú záplatu môžete tiež uložiť do schránky namiesto do súboru. Možno to budete chcieť urobiť, aby ste ju mohli vložiť do e-mailu na spracovanie ostatnými. Alebo ak máte na jednom stroji dve pracovné kópie a chcete preniesť zmeny z jednej do druhej, je to pohodlný spôsob vykonania opravnej záplaty schránkou.

Ak chcete, môžete vytvoriť súbor opravnej záplaty zvnútra dialógových okien Odovzdania alebo Kontroly úprav. Jednoducho vyberte súbory a použitím položky z kontextovej ponuky vytvorte opravnú záplatu z týchto súborov. Ak chcete vidieť dialógové okno Možnosti musíte pridržať Shift pri kliknutí pravým tlačidlom myši.

Na vašu pracovnú kópiu sa použijú súbory opravnej záplaty. Toto by sa malo robiť z rovnakej úrovne priečinkov, ktorá bola použitá na vytvorenie opravnej záplaty. Ak si nie ste istí, čo to je, stačí sa pozrieť na prvý riadok súboru opravnej záplaty. Napríklad ak bol prvý súbor, na ktorom sa pracovalo doc/source/english/chapter1.xml a prvý riadok v súbore opravnej záplaty je Index: english/chapter1.xml potom musíte použiť opravnú záplatu na priečinok doc/source/. Ak ste však v správnej pracovnej kópii a zvolíte nesprávnu úroveň priečinkov, TortoiseSVN na to upozorní a navrhne správnu úroveň.

Ak chcete na svoju pracovnú kópiu použiť súbor opravnej záplaty, musíte mať aspoň prístup na čítanie do úložiska. Dôvod je ten, že program zlúčenia musí odkazovať zmeny späť na revíziu, proti ktorej boli vykonané vzdialeným vývojárom.

V kontextovej ponuke pre tento priečinok kliknite na TortoiseSVN → Použiť opravnú záplatu... Zobrazí sa dialógové okno na otvorenie súboru, ktoré vám umožní vybrať súbor opravnej záplaty, ktorý sa má použiť. Zobrazia sa iba predvolené .diff alebo .dif súbory, ale môžete sa zvoliť “Všetky súbory”. Ak ste predtým uložili opravnú záplatu do schránky, môžete na otvorenie súboru použiť v dialógovom okne Otvoriť zo schránky.... Táto možnosť sa zobrazí, iba ak ste opravu uložili do schránky použitím TortoiseSVN → Vytvoriť opravnú záplatu.... Po skopírovaní opravy do schránky z inej aplikácie sa tlačidlo nezobrazí.

Prípadne, ak má súbor opravnej záplaty príponu .diff alebo .dif, môžete naňho kliknúť pravým tlačidlom myši priamo a vybrať TortoiseSVN → Použiť opravnú záplatu.... V takom prípade sa zobrazí výzva na zadanie umiestnenia pracovnej kópie.

Tieto dve metódy ponúkajú rôzne spôsoby, ako robiť to isté. Prvým spôsobom vyberiete pracovnú kópiu a prehliadate na súbor opravnej záplaty. V druhom kroku vyberte súbor opravnej záplaty a prehliadate pracovnú kópiu.

Po výbere súboru opravnej záplaty a umiestnenia pracovnej kópie sa spustí TortoiseMerge, ktorý zlúči zmeny zo súboru opravnej záplaty s vašou pracovnou kópiou. V malom okne je zoznam súborov, ktoré boli zmenené. Dvakrát postupne kliknite na každú z nich, skontrolujte zmeny a uložte zlúčené súbory.

Oprava vzdialeného vývojára bola teraz použitá na vašu pracovnú kópiu, takže musíte odovzdaním umožniť všetkým ostatným prístup k zmenám v úložisku.

Obrázok 4.60. Dialóg poznámky/zdpovednosti

Ak vás nezaujímajú zmeny z predošlých revízií, môžete nastaviť revíziu, z ktorej by malo vyvodenie zodpovednosti vychádzať. Nastavte na 1, ak chcete vyvodiť zodpovednosť za každú revíziu.

V predvolenom nastavení sa súbor vyvodenie zodpovednosti zobrazuje použitím aplikácie TortoiseBlame, ktorá zvýrazňuje rôzne revízie, aby sa sprehľadnilo čítanie. Ak chcete vytlačiť alebo upraviť súbor vyvodenia zodpovednosti, vyberte možnosť Na zobrazenie zodpovednosti použite textový prehliadač.

Môžete určiť spôsob, akým sa bude zaobchádzať so zmenami koncov riadkov a bielych znakov. Tieto možnosti sú popísané v časti “Ukončenia riadkov a biele znaky”. Predvolené správanie považuje všetky odlišnosti bielych znakov a koncov riadkov ako skutočné zmeny, ale ak chcete ignorovať zmenu odsadenia a nájsť pôvodného autora, môžete si tu zvoliť príslušnú možnosť.

Ak chcete, môžete zahrnúť aj informácie o zlúčení, hoci načítanie tejto možnosti zo servera môže trvať podstatne dlhšie. Keď sú riadky zlúčené z iného zdroja, informácia o zodpovednosti ukazuje revíziu, ktorá bola vykonaná v pôvodnom zdroji, ako aj revíziu, keď bola zlúčená do tohto súboru.

Akonáhle stlačíte OK TortoiseSVN začne načítať údaje, aby vytvoril súbor vyvodenie zodpovednosti. Po dokončení procesu zodpovednosti sa výsledok zapíše do dočasného súboru a výsledky si môžete prezrieť.

Obrázok 4.61. TortoiseBlame

TortoiseBlame, ktorý je súčasťou TortoiseSVN, uľahčuje čítanie súboru zodpovednosti. Keď umiestnite kurzor myši na čiaru v stĺpci Informácie o zodpovednosti, všetky riadky s rovnakou revíziou sa zobrazia na tmavšom pozadí. Riadky z iných revízií, ktoré zmenil ten istý autor, sú zobrazené na svetlom pozadí. Sfarbenie nemusí fungovať tak výrazne, ak máte displej nastavený iba na 256 farebný režim.

Ak kliknete ľavým tlačidlom na riadok, sú zvýraznené všetky riadky s rovnakou revíziou a riadky z iných revízií od rovnakého autora sú zvýraznené svetlejšou farbou. Toto zvýraznenie je priľnavé a umožňuje vám pohybovať myšou bez straty zvýraznenia. Opätovným kliknutím na túto revíziu vypnete zvýrazňovanie.

Komentáre revízií (správa záznamu) sa zobrazia v poli návodu vždy, keď kurzor myši prejde nad stĺpec s informáciami o zodpovednosti. Ak chcete skopírovať správu záznamu pre túto revíziu, použite kontextovú ponuku, ktorá sa zobrazí po kliknutí pravým tlačidlom myši na stĺpec s informáciami o zodpovednosti.

Vnútri správy o zodpovednosti môžete vyhľadávať použitím Upraviť → Hľadať.... Takto môžete vyhľadávať čísla revízií, autorov a obsah samotného súboru. Do vyhľadávania nie sú zahrnuté správy záznamu - na ich prehľadanie by ste mali použiť dialógové okno záznamu.

Môžete tiež preskočiť na konkrétne číslo riadku použitím Upraviť → Prejsť na riadok....

Keď je myš nad stĺpcami s informáciami o zodpovednosti, je k dispozícii kontextová ponuka, ktorá pomáha pri porovnávaní revízií a skúmaní histórie s použitím čísla revízie riadku pod myšou ako referencie. Kontextová ponuka → Zodpovednosť za predošlú revíziu vygeneruje správu o zodpovednosti pre ten istý súbor, ale použije hornú hranicu predošlej revízie. Takto získate správu o zodpovednosti za stav súboru tesne pred poslednou zmenou riadku, na ktorý sa pozeráte. Kontextová ponuka → Zobraziť zmeny spustí váš prehliadač odlišnosí a zobrazí vám, čo sa zmenilo v referenčnej revízii. Kontextová ponuka → Zobraziť záznam zobrazí dialógové okno záznamu revízií začínajúce referenčnou revíziou.

Ak potrebujete lepší vizuálny indikátor toho, kde sa nachádzajú najstaršie a najnovšie zmeny, vyberte Zobraziť → Farebný vek riadka. Týmto sa použije farebné stupňovanie na zobrazenie novších riadkov červenou farbou a starších riadkov modrej farby. Predvolené sfarbenie je dosť prehľadné, ale môžete ho zmeniť použitím nastavení TortoiseBlame.

Ak používate funkciu Merge Tracking a požadujete informácie o zlúčení pri spustení vyvodenia zodpovednosti, zlúčené riadky sa zobrazia trochu inak. Ak sa riadok zmenil v dôsledku zlúčenia z inej cesty, TortoiseBlame zobrazí namiesto pôvodnej zmeny revíziu a autora poslednej zmeny v pôvodnom súbore. Tieto riadky sú označené kurzívou, ktorá zobrazuje revíziu a autora. Revízia, v ktorej došlo k zlúčeniu, sa zobrazí samostatne v popise nástroja, keď umiestnite kurzor myši na stĺpce s informáciami o zodpovednosti. Ak nechcete, aby sa zlúčené riadky zobrazovali týmto spôsobom, zrušte zaškrtnutie políčka Zahrnúť informácie o zlúčení pri spustení vyvodenia zodpovednosti.

Ak chcete vidieť cesty zahrnuté v zlúčení, vyberte Zobraziť → Cesty zlúčenia. Zobrazí sa cesta, kde sa riadok naposledy zmenil, s výnimkou zmien vyplývajúcich zo zlúčenia.

Revízia uvedená v informáciách o zodpovednosti predstavuje poslednú revíziu, pri ktorej sa zmenil obsah tohto riadku. Ak bol súbor vytvorený kopírovaním iného súboru, potom kým nezmeníte riadok, jeho revízia viny zobrazí poslednú zmenu v pôvodnom zdrojovom súbore, nie revíziu, kde bola kópia vytvorená. To platí aj pre cesty zobrazené s informáciami o zlúčení. Cesta zobrazuje umiestnenie úložiska, kde bola urobená posledná zmena v danom riadku.

Nastavenia pre TortoiseBlame sú prístupné použitím TortoiseSVN → Nastavenie... na karte TortoiseBlame. Odvolávka na časť “Nastavenia TortoiseBlame”.

Jedným z obmedzení správy o zodpovednosti je to, že zobrazuje iba súbor, aký bol v konkrétnej revízii a poslednú osobu, ktorá mení každý riadok. Niekedy chcete vedieť, aké zmeny sa uskutočnili a tiež to, kto ich urobil. Ak kliknete pravým tlačidlom myši na riadok v TortoiseBlame, máte položku kontextovej ponuky, aby ste zobrazili zmeny vykonané v tejto revízii. Ak však chcete vidieť zmeny a informácie o zodpovednosti súčasne, potrebujete kombináciu správ o odlišnostiach a zodpovednosti.

Dialógové okno záznamu revízií obsahuje niekoľko možností, ktoré vám to umožňujú.

Každý uzol grafu revízie predstavuje revíziu v úložisku, kde sa niečo zmenilo v strome, na ktorý sa pozeráte. Rôzne typy uzlov možno rozlíšiť podľa tvaru a farby. Tvary sú stále, ale farby je možné nastaviť použitím TortoiseSVN → Nastavenia

Upozorňujeme, že graf predvolene zobrazuje iba body, v ktorých boli položky pridané, kopírované alebo odstránené. Zobrazenie každej revízie projektu vygeneruje veľmi veľký graf pre nepodstatné prípady. Ak naozaj chcete vidieť všetky revízie, kde boli vykonané zmeny, je tu možnosť urobiť to v ponuke Zobraziť a na paneli nástrojov.

Predvolené zobrazenie (zoskupenie) umiestni uzly tak, aby ich zvislá poloha bola v prísnom poradí revízií, takže máte vizuálnu stopu pre poradie, v ktorom sa veci robili. Ak sú dva uzly v rovnakom stĺpci, je veľmi zrejmé poradie. Keď sú dva uzly v susedných stĺpcoch, posun je oveľa menší, pretože nie je potrebné zabrániť prekrývaniu uzlov, a preto je poradie o niečo menej zrejmé. Takéto optimalizácie sú potrebné na udržanie primeranej veľkosti zložitých grafov. Upozorňujeme, že pri tomto zaradzovaní sa používa hrana uzla na staršej strane ako referencia, t. j. spodný okraj uzla, keď je graf zobrazený s najstarším uzlom v dolnej časti. Referenčná hrana je významná, pretože tvary uzlov nie sú všetky rovnako vysoké.

Pretože je graf revízií často pomerne zložitý, existuje niekoľko funkcií, pomocou ktorých je možné prispôsobiť zobrazenie tak, ako chcete. Sú k dispozícii v ponuke Zobraziť a na paneli nástrojov.

Na uľahčenie navigácie vo veľkom grafe použite prehľadové okno. Celý tento graf sa zobrazí v malom okne so zvýraznenou aktuálne zobrazenou časťou. Presunutím zvýraznenej oblasti môžete zmeniť zobrazenú oblasť.

Dátum revízie, autor a komentáre sa zobrazia v políčku návodu vždy, keď sa kurzor myši vznáša nad políčkom revízie.

Ak vyberiete dve revízie (použite Ctrl-klik ľavým tlačidlom myši ), môžete použiť kontextovú ponuku na zobrazenie odlišností medzi týmito revíziami. Môžete si zvoliť zobrazovanie odlišností ako v bodoch vytvárania vetiev, ale zvyčajne budete chcieť zobrazovať rozdiely v koncových bodoch vetiev, t. j pri HEAD revíziách.

Rozdiely môžete zobraziť ako súbor zjednotených odlišností, ktorý zobrazuje všetky rozdiely v jednom súbore s minimálnym kontextom. Ak si zvolíte kontextovú ponuku → Porovnať revízie zobrazí sa vám zoznam zmenených súborov. Dvojklikom na názov súboru pre načítanie oboch revízií súboru a porovnali sa nástrojom na vizuálne porovnanie odlišností.

Ak kliknite pravým tlačidlom myši na revíziu môžete použiť kontextovú ponuku → Zobraziť záznam pre zobrazenie históriu.

Zmeny vo vybraných revíziách môžete tiež zlúčiť do inej pracovnej kópie. Dialógové okno výberu priečinka vám umožňuje si zvoliť pracovnú kópiu, do ktorej sa má zlúčiť, ale potom už nebude mať dialógové okno s odovzdaním možnosť vyskúšať testovacie zlúčenie. Dobrou myšlienkou je zlúčenie do nemodifikovanej pracovnej kópie, aby ste mohli zmeny vrátiť, ak to nevyjde! Toto je užitočná funkcia, ak chcete zlúčiť vybrané revízie z jednej vetvy do druhej.

Ak chcete znova skontrolovať server, či neobsahuje novšie informácie, môžete zobrazenie jednoducho obnoviť použitím F5. Ak používate zásobník záznamu (predvolene povolené), skontroluje sa tým, či sú v úložisku novšie odovzdania a načítané iba nové. Ak bol zásobník záznamov v režime offline, pokúsi sa tiež vrátiť späť online.

Ak používate zásobník záznamov a myslíte si, že sa obsah správy alebo autor mohli zmeniť, na obnovenie potrebných správ by ste mali použiť dialógové okno záznamu. Pretože graf revízií funguje z koreňa úložiska, museli by ste zrušiť platnosť celého zásobníka záznamu a opätovné vyplnenie by mohlo trvať veľmi dlho.

Veľký strom môže byť ťažko navigovateľný a niekedy budete chcieť skryť jeho časti alebo ho rozložiť na les menších stromov. Ak umiestnite kurzor myši na miesto, kde odkaz na uzol vstupuje alebo opúšťa uzol, uvidíte jedno alebo viac vyskakovacích tlačidiel, ktoré vám to umožnia.

Kliknutím na tlačidlo mínus zviniete priložený podstrom.

Kliknutím na tlačidlo plus rozviniete zvinutý strom. Keď sa strom zloží, toto tlačidlo zostane viditeľné, aby označilo skrytý podstrom.

Kliknite na tlačidlo krížika, aby ste rozdelili pripojený podstrom a zobrazili ho ako samostatný strom v grafe.

Kliknutím na tlačidlo krúžka znovu pripojíte rozdelený strom. Keď je strom rozdelený, toto tlačidlo zostane viditeľné, čo znamená, že existuje samostatný podstrom.

Kliknite na pozadie grafu pre hlavnú kontextovú ponuku, ktorá ponúka možnosti Rozvinúť všetko a Spojiť všetky. Ak žiadna vetva nebola zvinutá alebo rozdelená, kontextová ponuka sa nezobrazí.

Niekedy máte pracovnú kópiu, ktorú chcete previesť späť do normálneho priečinka bez priečinka .svn. Všetko, čo musíte urobiť, je vymazať .svn priečinok z koreňa pracovnej kópie.

Prípadne môžete priečinok exportovať do seba. V Prieskumníkovi Windows pretiahnite v sekcii priečinkov pri stlačení pravého tlačidla myši priečinok pracovnej kópie zo sekcie súboru na seba. TortoiseSVN zistí tento špeciálny prípad a opýta sa, či chcete vytvoriť bezverziovú pracovnú kópiu. Ak odpoviete Áno priečinok správy bude odstránený a budete mať obyčajný bezverziový strom priečinkov.

V TortoiseSVN si môžete integrovať nástroj na sledovanie chýb podľa svojho výberu. Aby ste to dosiahli, musíte definovať niektoré vlastnosti, ktoré sa musia začínať bugtraq:. Tie musia byť nastavené v priečinkoch: (“Nastavenia Projektu”)

Obrázok 4.66. Dialógové okno Vlastnosti Bugtraq (sledovania chýb)

Pri úprave ktorejkoľvek z vlastností bugtraq sa použije špeciálny editor vlastností, ktorý uľahčí nastavenie vhodných hodnôt.

Existujú dva spôsoby integrácie TortoiseSVN s nástrojmi na sledovanie problémov. Jeden je založený na jednoduchých strunách, druhý je založený na regulárnych výrazoch. Vlastnosti používané oboma prístupmi sú:

Ak sú obe vlastnosti bugtraq:message a bugtraq:logregex nastavené, logregex má prednosť.

Niektoré vlastnosti tsvn: vyžadujú hodnotu true/false. TortoiseSVN tiež rozumie yes ako synonymu pre true a no ako synonymu pre false.

Keď do pracovnej kópie pridáte nové podpriečinky pouziťím TortoiseSVN, všetky vlastnosti projektu prítomné v nadradenom priečinku sa automaticky pridajú aj do nového podradeného priečinka.

Integrácia nástroja na sledovanie problémov sa neobmedzuje iba na TortoiseSVN; dá sa použiť s akýmkoľvek klientom Subversion. Ďalšie informácie sa nachádzajú v úplnom znení v časti Špecifikácia integrácie sledovača problémov v zdrojovom úložisku TortoiseSVN. V časti (“Licencia” sa vysvetľuje, ako získať prístup do úložiska.)

Predošlá časť sa zaoberá pridávaním informácií o problémoch do správ záznamu. Čo však v prípade, že potrebujete získať informácie zo sledovača problémov? Dialóg odovzdania má rozhranie COM, ktoré umožňuje integráciu externého programu, ktorý vie hovoriť s vaším sledovačom. Spravidla by ste mali chcieť zadať požiadavku do sledovača na získanie zoznamu otvorených problémov, ktoré vám boli pridelené, aby ste si mohli vybrať problémy, ktoré sa pri tomto odovzdaní riešia.

Každé takéto rozhranie je samozrejme veľmi špecifické pre váš systém sledovania problémov, takže nemôžeme poskytnúť túto časť. Popis, ako vytvoriť takýto program, je mimo rozsah tejto príručky. Definíciu rozhrania a ukážkové doplnky v C# a C++/ATL možno získať v priečinku contrib v úložisku TortoiseSVN. (Časť “Licencia” vysvetľuje, ako získať prístup do úložiska.) Súhrn API je tiež uvedený v časti Kapitola 7, Rozhranie IBugtraqProvider. Ďalším (fungujúcim) príkladom doplnku v C# je aplikácia Gurtle, ktorá implementuje požadované rozhranie COM na interakciu so sledovačom problémov kódu Google.

Pre ilustráciu predpokladajme, že vám správca systému poskytol doplnok na sledovanie problémov, ktorý ste si nainštalovali, a že ste nastavili niektoré zo svojich pracovných kópií tak, aby ste doplnok mohli používať v dialógovom okne nastavení TortoiseSVN. Keď otvoríte dialógové okno odovzdania z pracovnej kópie, ku ktorej bol doplnok priradený, v hornej časti dialógového okna sa zobrazí nové tlačidlo.

Obrázok 4.67. Príklad dialógového okna sledovania problémov

V tomto príklade môžete vybrať jeden alebo viac otvorených čísel. Doplnok potom môže generovať špeciálne naformátovaný text, ktorý pridá do vašej správy záznamu.

Obrázok 4.68. Dialógové okno Nastavenia, Všeobecná stránka

Toto dialógové okno umožňuje určiť preferovaný jazyk a nastavenia špecifické pre Subversion.