TortoiseSVN toimii Windows Vistassa ja sitä uudemmissa Windows-versioissa. Se on saatavana sekä 32- että 64-bittisenä versiona. 64-bittinen asennusohjelma sisältää myös 32-bittiset laajennusosat, minkä ansiosta 32-bittistä versiota ei tarvitse asentaa erikseen, jotta TortoiseSVN-komennot ja kuvakkeet saataisiin käyttöön 32-bittisissä sovelluksissa.

Tuki Windows 98, Windows ME ja Windows NT4 -käyttöjärjestelmille loppui versiossa 1.2.0; Windows 2000 -tuki sekä Windows XP SP2 -tuki puolestaan loppui versiossa 1.7.0. Tuki Windows XP SP3 -järjestelmälle loppui versiossa 1.9.0. Voit yhä asentaa jonkun näistä vanhemmista versioista, mikäli tarvitset niitä.

TortoiseSVN sisältää helppokäyttöisen asennusohjelman. Kaksoisnapsauta asennustiedostoa ja seuraa ohjeita - asennusohjelma huolehtii lopusta. Muista käynnistää tietokone uudelleen asennuksen jälkeen.

TortoiseSVN-käyttöliittymä voidaan kääntää eri kielille erikseen noudettavien kielipakettien avulla. Katso lisätietoa luvusta Liite G, Kielipaketit ja tavutuksen tarkastus.

Jos törmäät ongelmiin asennuksen aikana tai ohjelmaa käyttäessäsi, tarkista projektin FAQ paikantimesta https://tortoisesvn.net/faq.html.

Todellisessa projektissa Subversion-arkisto sijaitsee yleensä erillisellä palvelimella. Tässä oppaassa käytämme kuitenkin Subversionin tukemaa paikallista arkistoa, joka voidaan luoda suoraan kiintolevyllesi ilman erillistä palvelinta.

Luo aluksi uusi, tyhjä hakemisto tietokoneellesi. Se voi sijaita missä tahansa, mutta tässä oppaassa se on C:\svn_repos. Napsauta hiiren oikeaa näppäintä hakemiston päällä ja valitse pudotusvalikon komento TortoiseSVN → Luo arkisto tähän.... Arkisto luodaan kansioon ja on valmis käytettäväksi. Voit myös luoda arkistolle oletusarvoisen kansiorakenteen napsauttamalla painiketta Luo kansiorakenne.

Nyt meillä on arkisto, mutta se on täysin tyhjä. Oletetaan, että hakemistossa C:\Projects\Widget1 on joukko tiedostoja, jotka haluaisin lisätä versionhallintaan. Napsauta hiiren oikeaa näppäintä hakemiston Widget1 kohdalla ja valitse komento TortoiseSVN → Tuo..., joka avaa seuraavan ikkunan:

Kuva 1.2. Tuonti-ikkuna

Subversion-arkistoon viitataan paikantimella (engl. URL), joka sallii sen sijoittamisen minne tahansa Internetissä. Tässä tapauksessa tarvitaan paikannin paikalliseen arkistoon file:///c:/svn_repos/trunk, johon lisätään projektin nimi Widget1. Huomaa kolme kauttaviivaa yhteyskäytännön file: jälkeen sekä se, että paikantimissa ei käytetä kenoviivoja.

Toinen tämän ikkunan tärkeä ominaisuus on Tuontiviesti -tekstikenttä, jossa voit kuvata, mitä olit tekemässä. Kun myöhemmin tutkit projektin historiaa, toimitusviestit ovat tärkeä opas siihem mitä muutoksia on tehty, ja miksi. Tässä tapauksessa voimme kirjata vaikkapa ”Tuo Widget1-projekti arkistoon”. Napsauta OK ja kansio lisätään arkistoosi.

Nyt, kun arkistossa on projekti, tarvitaan siitä työkopio, jota käytetään päivittäisessä työssä. Huomaa, että kansion tuonti arkistoon ei automaattisesti tee siitä työkopiota. Subversion-termi uuden työkopion luomiseksi on Hae työkopio (engl. checkout). Hae arkiston Widget1-kansiosta työkopio hakemistoon C:\Projects\Widget1-Dev seuraavasti: Luo kansio, napsauta sitä hiiren oikealla näppäimellä ja anna komento TortoiseSVN → Hae työkopio.... Anna sitten haettava paikannin, tässä tapauksessa file:///c:/svn_repos/trunk/Widget1 ja napsauta OK. Arkiston tiedostot lisätään uuteen kansioon.

Tämän kansion ulkonäkö poikkeaa alkuperäisestä kansiosta. Jokaisella tiedostolla on vihreä kuvakepäällys vasemmassa alanurkassa. Kuvakepäällykset ovat TortoiseSVN-tilakuvakkeita, jotka näytetään vain työkopioille. Vihreä päällys ilmaisee, että tiedosto ei poikkea arkiston tiedostosta.

On aika alkaa töihin. Oletetaan, että muutamme kansion Widget1-Dev tiedostoja Widget1.c ja ReadMe.txt. Huomaa, että tiedostojen kuvakepäällykset muuttavat punaisiksi. Tämä kertoo, että niissä on paikallisia muutoksia.

Mutta mitä on muuttunut? Napsauta hiiren oikealla näppäimellä yhtä muuttuneista tiedostoista ja valitse TortoiseSVN → Vertaa TortoiseSVN-vertailutyökalu käynnistyy ja näyttää yksityiskohtaisesti, mitkä rivit ovat muuttuneet.

Kuva 1.3. Tiedostojen vertaileminen

OK, olemme tyytyväisiä muutoksiin, joten päivitetään arkistoa. Tämän toimenpiteen nimi on Toimita muutokset. Napsauta hiiren oikealla näppäimellä hakemistoa Widget1-Dev ja valitse komento TortoiseSVN → Toimita.... Toimitusikkuna luettelee muuttuneet tiedostot valintaruudun kera. Saatat haluta toimittaa arkistoon vain osan muuttuneista tiedostoista, mutta tällä kertaa toimitamme molempien tiedostojen muutokset. Anna viesti, joka kuvaa muutokset ja napsauta OK. Edistymisikkuna näyttää siirrettävät tiedostot ja sen sulkeuduttua olet valmis.

Projektin edetessä uusia tiedostoja tarvitaan lisää. Oletetaan, että lisäät tiedoston Extras.c ja viittaat siihen olemassa olevasta tiedostosta Makefile. Napsauta hiiren oikealla näppäimellä kansiota ja anna komento TortoiseSVN → Lisää.... Lisäysikkuna näyttää kaikki versioimattomat tiedostot; voit valita, mitkä niistä haluat arkistoida. Toinen tapa lisätä tiedostoja on napsauttaa itse tiedostoa ja antaa komento TortoiseSVN → Lisää.

Kun nyt toimitat kansion sisällön arkistoon, uusi tiedosto näkyy tilassa Lisätty ja muutettu tiedosto tilassa Muutettu. Huomaa, että voit kaksoisnapsauttaa muutettua tiedostoa nähkäksesi tehdyt muutokset.

Yksi hyödyllisimmistä TortoiseSVN-toiminnoista on loki-ikkuna. Se näyttää luettelon toimituksista, joita olet tehnyt tiedostolle tai kansiolle, sekä näyttää niille antamasi yksityiskohtaiset lokiviestit (Annoithan toimitusviestin? Mikäli et, huomaat nyt miksi se on tärkeää.)

Kuva 1.4. Loki-ikkuna

(tässä on laiskuussyistä käytetty TortoiseSVN-arkiston loki-ikkunaa).

Ylin paneeli näyttää toimitetut versiot ja alun niiden toimitusviesteistä. Kun valitset jonkun version, sen koko toimitusviesti näytetään keskimmäisessä paneelissa; alin paneeli näyttää tällöin versiossa muuttuneet tiedostot ja kansiot.

Kullakin paneelilla on kontekstivalikko, jossa on lisäkomentoja tietojen käyttämiseksi. Alimmassa paneelissa voit kaksoisnapsauttaa tiedostoa nähdäksesi siihen ko. versiossa tehdyt muutokset. Katso lisää luvusta ”Versioloki”.

Kaikki versionhallintajärjestelmät sallivat aiemmin tehtyjen muutosten perumisen. Niin kuin voi odottaa, TortoiseSVN tekee tästä helppoa.

Mikäli haluat perua muutoksia, joita et ole vielä toimittanut arkistoon, voit palauttaa työkopiosi muokkausta edeltäneeseen tilaan komennolla TortoiseSVN → Palauta. Tällöin muutoksesi siirretään Roskakoriin ja korvataan alkuperäisellä versiolla. Jos haluat perua vain osan muutoksista, voit käyttää TortoiseMerge-ohjelmaa erojen tutkimiseen ja osittaiseen palauttamiseen.

Jos haluat perua tietyn version muutokset, käynnistä loki-ikkuna ja etsi haluttu versio. Valitse sitten komento Kontekstivalikko → Poista tämän version muutokset, jolloin muutokset perutaan.

Oletetaan, että meillä on kaksi työntekijää, Harry ja Sally. He päättävät muokata samaa arkiston tiedostoa samaan aikaan. Mikäli Harry tallettaa muutoksensa arkistoon ensin, on mahdollista, että Sally voi (hetkeä myöhemmin) vahingossa ylikirjoittaa ne omalla, uudella versiollaan tiedostosta. Vaikka Harryn versio tiedostosta ei häviä ikuisiksi ajoiksi (koska tiedostojärjestelmä muistaa kaikki muutokset) , Harryn tekemät muutokset eivät ole mukana Sallyn uudemmassa versiossa tiedostosta, koska hän ei koskaan edes nähnyt Harryn muutoksia. Harryn työ on tosiasiallisesti kadonnut (tai ainakin puuttuu tiedoston viimeisestä versiosta) ja luultavasti vahingossa. Juuri tätä tilannetta halutaan välttää!

Kuva 2.2. Vältettävä ongelma

Monet versionhallintajärjestelmät ratkaisevat tämän ongelman lukitse/muuta/vapauta -mallin avulla. Tällainen ratkaisu on hyvin yksinkertainen; arkisto sallii vain yhden ihmisen muuttaa tiedostoa kerrallaan. Ensiksi Harryn pitää lukita tiedosto, ennen kuin muutoksia voidaan alkaa tehdä. Tiedoston lukitseminen muistuttaa paljolti kirjan lainaamista kirjastosta; jos Harry on lukinnut tiedoston, niin Sally ei voi tehdä siihen muutoksia. Mikäli Sally koettaa lukita tiedoston, arkisto evää pyynnön. Sally voi ainoastaan lukea tiedostoa ja odottaa, että Harry saa muutostyönsä loppuun ja vapauttaa lukon. Lukon vapauttamisen jälkeen Sally voi vuorostaan lukita ja muokata tiedostoa.

Kuva 2.3. Lukitse/muuta/vapauta -ratkaisu

Lukitse-muokkaa-vapauta -mallin ongelma on, että se on hieman rajoittava ja muodostuu usein käyttäjille pullonkaulaksi:

Subversion, CVS ja monet muut versionhallintajärjestelmät käyttävät kopioi-muokkaa-yhdistä -mallia vaihtoehtona lukitukselle. Tässä mallissa kunkin käyttäjän asiakasohjelma lukee arkistoa ja muodostaa henkilökohtaisen työkopion projektista. Käyttäjät työskentelevät sitten yhtä aikaa, kukin muokaten omia kopioitaan. Lopulta omat kopiot yhdistetään uudeksi, lopulliseksi versioksi. Versionhallintajärjestelmä auttaa usein yhdistämisessä, mutta loppujen lopuksi käyttäjä on vastuussa siitä, että yhdistäminen tapahtuu oikein.

Esimerkki. Oletetaan, että Harry ja Sally luovat kumpikin työkopion samasta projektista kopioimalla sen arkistosta. He työskentelevät yhtä aikaa, ja tekevät muutoksia samaan tiedostoon A työkopioissaan. Sally tallettaa muutoksensa arkistoon ensin. Kun Harry yrittää tallettaa muutoksensa myöhemmin, arkisto kertoo hänelle, että hänen tiedostonsa A on vanhentunut. Toisin sanoen tiedosto A on jotenkin muuttunut arkistossa sen jälkeen, kun hän viimeksi kopioi sen. Joten Harry pyytää asiakasohjelmaansa yhdistämään uudet muutokset arkistosta oman työkopionsa tiedostoon A. Sallyn tekemät muutokset eivät mene päällekkäin hänen omien muutostensa kanssa, joten saatuaan muutokset yhdistettyä hän voi tallettaa työkopionsa takaisin arkistoon.

Kuva 2.4. Kopioi-muokkaa-yhdistä -ratkaisu

Kuva 2.5. ...Kopioi-muokkaa-yhdistä jatkuu

Mutta entäpä jos Sallyn muutokset ovatkin päällekkäisiä Harryn muutosten kanssa? Mitä sitten? Tällaista tilannetta kutsutaan ristiriidaksi, eikä se yleensä ole kovin suuri ongelmaa. Kun Harry komentaa asiakasohjelmaansa yhdistämään viimeisimmät muutokset arkistosta työkopioonsa, hänen kopionsa tiedostosta A merkitään ristiriitaiseksi: hän voi tarkastella molempia ristiriitaisten muutosten joukkoja, ja käsin valita niiden välillä. Huomaa, että ohjelma ei voi automaattisesti ratkoa ristiriitoja; vain käyttäjä (ihminen) kykenee ymmärtämään ne ja tekemään tarpeelliset älykkäät valinnat. Kun Harry on käsin ratkonut päällekkäiset muutokset (ehkäpä keskustelemalla ristiriidoista Sallyn kanssa!), hän voi turvallisesti tallettaa yhdistetyn tiedoston takaisin arkistoon.

Kopioi-muokkaa-yhdistä -malli voi kuulostaa hieman kaoottiselta, mutta käytännössä se toimii äärimmäisen joustavasti. Käyttäjät voivat työskennellä yhtä aikaa, tarvitsematta koskaan odottaa toisia. Silloinkin, kun työ kohdistuu samoihin tiedostoihin, useimmat yhtäaikaiset muutokset eivät ole päällekkäisiä, ja siten ristiriidat ovat harvinaisia. Ristiriitojen ratkomiseen tarvittava aika on paljon pienempi kuin lukitusjärjestelmän käytössä hukattu aika.

Loppujen lopuksi kaikki tiivistyy yhteen kriittiseen tekijään: käyttäjien kommunikointiin. Kun käyttäjät kommunikoivat huonosti, sekä syntaktisten että semanttisten ristiriitojen määrä kasvaa. Mikään järjestelmä ei voi pakottaa käyttäjiä kommunikoimaan täydellisesti, eikä mikään järjestelmä pysty havaitsemaan semanttisia ristiriitoja. Niinpä ei kannata tuudittautua harhaluuloon, että lukituksiin perustuva järjestelmä voisi jotenkin estää ristiriidat; käytännössä lukitus vaikuttaa enemmänkin tuottavuutta rajoittavasti.

On eräs tavallinen tilanne, jossa lukitse-muokkaa-vapauta -malli toimii paremmin: tiedostot, joita ei voi yhdistää. Jos arkistossasi on esimerkiksi kuvia, joita kaksi ihmistä muuttaa yhtä aikaa, niin tehtyjä muutoksia ei voi mitenkään yhdistää. Joko Harry tai Sally menettävät muutoksensa.

Subversion käyttää oletusarvoisesti kopioi-muokkaa-yhdistä -mallia, ja useissa tapauksissa et koskaan tarvitse mitään muuta. Versiosta 1.2 alkaen Subversion tukee kuitenkin myös tiedostojen lukitusta, joten jos projektissasi on tiedostoja, joita ei voi yhdistää (tai projektikäytäntö edellyttää lukitusmallin käyttöä), Subversion tarjoaa silti tarvittavat ominaisuudet.

Olet jo lukenut työkopioista; nyt näytämme, kuinka Subversion-asiakasohjelma luo ja käyttää niitä.

Subversion-työkopio on tietokoneellasi sijaitseva tavallinen kansiopuu, joka sisältää kokoelman tiedostoja. Voit muokata näitä tiedostoja mielesi mukaan, ja mikäli ne ovat lähdekooditiedostoja, voit kääntää ne ohjelmaksi tavanomaiseen tapaan. Työkopiosi on yksityistä työaluettasi: Subversion ei koskaan lisää siihen muiden tekemiä muutoksia, eikä myöskään siirrä omia muutoksiasi muitten saataville ennen kuin erikseen komennat sitä tekemään niin.

Tehtyäsi muutoksia työkopiossasi oleviin tiedostoihin ja varmistuttuasi, että ne toimivat moitteetta, voit Subversionin komennoilla julkaista muutoksesi muille projektissasi työskenteleville ihmisille (kirjoittamalla arkistoon). Jos muut ihmiset julkaisevat omia muutoksiaan, voit yhdistää ne työkopioosi Subversionin komennoilla (lukemalla arkistosta).

Työkopio sisältää myös ylimääräisiä tiedostoja, joita Subversion luo ja ylläpitää. Eräs näistä on .svn -hakemisto, jota kutsutaan työkopion hallintohakemistoksi . Hallintohakemiston tiedostojen avulla Subversion havaitsee, mitkä tiedostot sisältävät julkaisemattomia muutoksia, ja mitkä tiedostot ovat vanhentuneita suhteessa muiden työhön. Ennen versiota 1.7 Subversion loi hallintohakemiston jokaiseen työkopion versioituun hakemistoon. Versiosta 1.7 alkaen Subversion toimii täysin eri tavoin: kullakin työkopiolla on vain yksi hallintohakemisto, joka sijaitsee suoraan työkopion juuren alla.

Tyypillinen Subversion-arkisto sisältää usein useiden projektien tiedostot (tai lähdekoodin); tavallisesti kukin projekti on alihakemisto arkiston tiedostopuussa. Tällaisessa järjestelyssä käyttäjän työkopio vastaa yleensä yhtä arkiston alipuuta.

Oletetaan esimerkiksi, että arkistosi sisältää kaksi ohjelmistoprojektia.

Kuva 2.6. Arkiston tiedostojärjestelmä

Toisin sanoen arkiston juurihakemistossa on kaksi alihakemistoa: paint ja calc.

Saadaksesi työkopion sinun täytyy kopioida jonkin arkiston polun tiedostot työasemallesi. Tätä kutsutaan työkopion noutamiseksi (engl. check out). Työkopion noutamisella ei ole tekemistä lukituksen tai resurssien varaamisen kanssa; se vain luo sinulle oman paikallisen kopion projektista.

Oletetaan, että teet muutoksia tiedostoon button.c. Koska .svn -hakemisto muistaa tiedoston muutospäivämäärän ja alkuperäisen sisällön, Subversion tietää, että olet muuttanut tiedostoa. Subversion ei kuitenkaan julkaise muutoksiasi ennen kuin erikseen komennat sitä. Muutosten julkaisutoimentpidettä kutsutaan yleisemmin arkistoon toimittamiseksi (engl. commit).

Julkaistaksesi muutoksesi muille, voit käyttää Subversion-komentoa toimita arkistoon.

Nyt muutoksesi tiedostoon button.c on toimitettu arkistoon; jos joku toinen käyttäjä hakee työkopion projektista /calc, hän näkee muutoksesi tiedoston viiimeisimmässä versiossa.

Oletetaan, että sinulla on työtoveri Sally, joka nouti työkopion projektista /calc samaan aikaan sinun kanssasi. Kun toimitat muutoksesi tiedostoon button.c, Sallyn työkopio säilyy muuttumattomana; Subversion muokkaa työkopioita vain käyttäjän niin pyytäessä.

Saattaakseen projektinsa ajan tasalle, Sally voi pyytää Subversionia päivittämään työkopionsa käyttäen komentoa päivitä. Tämä liittää muutoksesi Sallyn työkopioon, samoin kuin kaikki muutkin arkistoon edellisen työkopion noudon jälkeen tapahtuneet muutokset.

Huomaa, ettei Sallyn ei tarvinnut kertoa, mitä tiedostoja päivitetään; Subversion käyttää arkiston lisäksi .svn -hakemistojen tietoja päättääksen, mitkä tiedostot pitää saattaa ajan tasalle.

Subversion-arkistoihin voi päästä käsiksi useilla eri tavoilla - suoraan paikalliselta levyltä tai erilaisten yhteyskäytäntöjen kautta. Arkiston paikka ilmaistaan kuitenkin aina paikantimella (Uniform Resource Locator, URL). Paikantimesta käy ilmi, miten arkistoon kytkeydytään:

Subversion-paikantimet käyttävät enimmäkseen normaalia syntaksia, joka sallii palvelimen nimen ja porttinumeron liittämisen osaksi paikanninta. Kytkeytymistapaa file:// käytetään yleensä paikallisesti, vaikka sitä voidaan käyttää myös verkkopalvelimen UNC-polkujen kanssa. Paikannin on siten muotoa file://konenimi/polku/arkistoon. Paikallisessa tietokoneessa paikantimen konenimiosan pitää joko puuttua tai olla localhost. Tästä syystä paikalliset polut sisältävät yleensä kolme kauttaviivaa, file:///polku/arkistoon.

Lisäksi file:// -kytkeytymistavan käyttäjien pitää Windows-alustalla käyttää epävirallista ”standardia” kytkeytyäkseen arkistoihin, jotka sijaitsevat samassa koneessa, mutta eri asemassa kuin nykyinen asema. Kumpikin seuraavista paikanninsyntakseista toimii (X on asema, jossa arkisto sijaitsee):

file:///X:/polku/arkistoon
...
file:///X|/polku/arkistoon
...

Huomaa, että paikannin käyttää tavallisia kauttaviivoja, vaikka Windows-polut käyttävät natiivisti kenoviivoja.

Voit kytkeytyä FSFS-tekniikalla toteutettuun arkistoon verkkojaon kautta, mutta tätä ei suositella useista eri syistä:

Toiminto svn commit julkaisee yhteen tai useampaan tiedostoon ja hakemistoon tehdyt muutokset yhtenä atomisena (onnistuu joko kokonaan tai arkisto ei muutu) tapahtumana. Voit muuttaa tiedostojen sisältöä, luoda, poistaa, uudelleen nimetä ja kopioida tiedostoja ja hakemistoja työkopiossasi ja lopuksi toimittaa koko muutosjoukon arkistoon yhtenä kokonaisuutena.

Arkistossa kutakin toimitusta kohdellaan atomisena: joka kaikki toimituksen muutokset tulevat voimaan, tai mikään niistä ei tule voimaan. Subversion koettaa säilyttää tämän atomisuuden ohjelmien kaatuessa, järjestelmien kaatuessa, verkkoyhteyksien katkeillessa ja muiden käyttäjien toimien keskellä.

Joka kerta kun arkisto hyväksyy toimituksen, tiedostojärjestelmäpuu siirtyy uuten tilaan, jota kutsutaan versioksi. Kullekin versiolle annetaan yksikäsittteinen luonnollinen luku, yhtä isompi kuin edellinen versio. Uuden arkiston ensiversio on nolla ja se koostuu pelkästään tyhjästä juurihakamistosta.

Arkisto on näppärää havainnollistaa joukkona puita. Kuvittele joukkoa versionumeroita, alkaen nollasta ja ulottuen vasemmalta oikealle. Jokaiseen versionumeroon liittyy tiedostojärjestelmäpuu, joka on ”otos” arkiston tilasta kunkin toimituksen jälkeen.

Kuva 2.7. Arkisto

On tärkeää huomata, että työkopiot eivät aina vastaa yhtä tiettyä arkiston versiota; ne voivat sisältää tiedostoja useista eri versioista. Oletetaan esimerkiksi, että haet työkopion arkistosta, jonka viimeisin versio on 4:

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

Tällä hetkellä tämä työkopio vastaa täsmälleen versiota 4 arkistossa. Oletetaan kuitenkin, että teet muutoksen tiedostoon button.c, ja toimitat tämän muutoksen. Olettaen, että muita muutoksia ei ole tapahtunut, toimituksesi luo arkistosta version 5, ja työkopiosi näyttää nyt seuraavalta:

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

Oletetaan, että tässä kohden Sally toimittaa muutoksen tiedostoon integer.c, luoden version 6. Jos käytät komentoa svn update saattaaksesi työkopiosi ajan tasalle, se näyttää seuraavalta:

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

Sallyn tiedostoon integer.c tekemät muutokset ilmestyvät työkopioosi, ja oma muutoksesi on yhä mukana tiedostossa button.c. Tässä esimerkissä tiedoston Makefile sisältö on identtinen versioissa 4, 5, ja 6, mutta Subversion merkitsee työkopiosi tiedoston Makefile versiolla 6 ilmaisemaan, että se on yhä ajan tasalla. Tehtyäsi päivityksen työkopiosi juurihakemistolle se vastaa yleisesti ottaen täsmälleen yhtä arkiston versiota.

Subversion tallettaa jokaista työkopion tiedostoa varten kaksi oleellista tietoa .svn/ -hallintoalueelle:

Näiden tietojen avulla, keskustelemalla arkiston kanssa, Subversion-asiakas voi päätellä, missä seuraavista tiloista työkopion tiedosto on:

Nyt olet luonut uuden arkiston, jonka sijainti on D:\SVN\MyNewRepository.

Käyttääksesi paikallista arkistoasi tarvitset polun sen sisältävään kansioon. Muista, että Subversion odottaa kaikkien arkistopolkujen olevan muotoa file:///C:/SVNRepository/. Huomaa kauttaviivojen '/' käyttö.

Päästäksesi verkkojaolla olevaan arkistoon voit käyttää joko UNC-polkua tai sitoa sen asemakirjaimeen. UNC-poluille oikea muoto on file://palvelin/polku/arkistoihin/. Huomaa, että edeltäviä kauttaviivoja on tässä vain kaksi.

Ennen SVN-versiota 1.2 UNC-polut piti antaa hankalammassa muodossa file:///\palvelin/polku/arkistoihin. Tämä muoto on yhä tuettu, mutta ei suositeltu.

Vaikka on teoriassa mahdollista sijoittaa FSFS-arkisto verkkojaolle ja sallia sen yhtäaikainen käyttö file:// -yhteyskäytännöllä, tätä tapaa ei suositella eikä tueta useista eri syistä:

file:// -yhteyskäytäntö on tarkoitettu paikallisille yhden käyttäjän arkistoille, erityisesti testaamiseen ja virheiden etsintään. Kun haluat jakaa arkiston, sinun on todella asennettava oikea palvelin, eikä se ole läheskään niin vaikeaa kuin saatat kuvitella. Luku ”Arkiston käyttö” sisältää vinkkejä palvelimen valintaan ja asentamiseen.

Ennen kuin tuot tietosi arkistoon, sinun pitäisi ensin miettiä, miten haluat järjestää tietosi. Jos käytät yhtä suositelluista tavoista, arkiston käyttö on jatkossa paljon helpompaa.

On olemassa muutamia suositeltuja tapoja järjestää arkisto. Useimmat ihmiset luovat trunk -hakemiston, joka sisältää kehityksen ”päälinjan”, branches-hakemiston, joka sisältää kehityshaarat, ja tags-hakemiston, joka sisältää merkityt versiot. Jos arkisto sisältää vain yhden projektin, on tavallista luoda seuraavat ylätason hakemistot:

/trunk
/branches
/tags

Koska tätä rakennetta käytetään niin usein, TortoiseSVN kykenee luomaan sen automaattisesti arkiston luonnin yhteydessä.

Jos arkistossa on useita projekteja, on usein tapana indeksoida rakenne haaroittain:

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

...tai projekteittain:

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

Projekteittain indeksointi on järkevää, jos projektit eivät ole läheisessä suhteessa keskenään ja kustakin haetaan versioita itsenäisesti. Keskenään suhteessa oleville projekteille, joille saatat haluta kaikki projektit kerralla, tai missä kaikki projektit muodostavat yhden levityspaketin, on usein parempi indeksoida haaroittain. Tällöin työkopio voidaan noutaa yhdestä trunk-hakemistosta, ja aliprojektien suhteet ovat paremmin näkyvissä.

Jos otat käyttöön päätason /trunk /tags /branches -lähestymistavan, mikään ei kuitenkaan pakota sinua kopioimaan koko trunk-hakemistoa jokaista haaraa ja merkittyä versiota varten, ja monilla tavoin tämä rakenne joustaa eniten.

Toisistaan riippumattomille projekteille erillisten arkistojen käyttö saattaa olla parempi ajatus. Kun toimitat muutoksia, koko arkiston versionumero muuttuu, ei pelkästään projektin versionumero. Kun kaksi riippumatonta projektia jakaa arkiston, voi yhden projektin versionumeroissa olla suuria aukkoja. Subversion- ja TortoiseSVN-projektit löytyvät samasta palvelimesta, mutta ovat eri arkistoissa, mikä sallii itsenäisen kehityksen ja välttää versionumerosekaannukset.

Voit tietenkin jättää tavanomaiset tavat järjestää arkisto huomiotta ja luoda niistä minkä tahansa muunnelman, joka sopii parhaiten ryhmällesi. Muista, että mitä valitsetkin, päätös ei ole lopullinen. Voit järjestää arkiston uudelleen milloin vain. Koska haarat ja merkityt versiot ovat tavallisia hakemistoja, TortoiseSVN voi siirtää tai nimetä ne uudelleen miten vain tahdot.

Siirtyminen yhdestä rakenteesta toiseen voidaan toteuttaa helposti joukolla siirtokomentoja palvelimella; Jos et pidä arkiston rakenteesta, voit siirrellä hakemistoja ympäriinsä arkistoselaimella.

Jos et siis vielä ole luonut peruskansiorakennetta arkistoosi, se kannattaa tehdä nyt. Tähän on kaksi tapaa. Jos haluat pelkästään luoda /trunk /tags /branches -rakenteen, voit käyttää arkistoselainta luodaksesi kolme kansiota (kolmella erillisellä toimituksella). Jos taas haluat luoda syvemmän hierarkian, on yksinkertaisempaa luoda kansiorakenne paikalliselle levylle ja tuoda se arkistoon yhdellä toimituksella:

Huomaa että tuomasi kansion nimi ei näy arkistossa, pelkästään sen sisältö. Esimerkki: Luo seuraava kansiorakenne

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

Tuo C:\Temp\New arkiston juureen, joka näyttää lopputuloksena seuraavalta:

/trunk
/branches
/tags

Kuva 4.1. Resurssienhallinnan kuvakepäällykset

Yksi TortoiseSVN:n näkyvimmistä ominaisuuksista ovat kuvakepäällykset, jotka näkyvät työkopiosi tiedostoille. Niiden avulla näet yhdellä silmäyksellä, mitkä tiedostoistasi ovat muuttuneet. Katso luvusta ”Kuvakepäällykset” mitä eri päällykset merkitsevät.

Kuva 4.2. Kontekstivalikko versioidulle hakemistolle

Kaikki TortoiseSVN-komennot käynnistyvät Windows-resurssienhallinnan kontekstivalikosta. Useimmat ovat heti näkyvissä, kun oikea-napsautat tiedoston tai kansion päällä. Käytettävissä olevat komennot riippuvat siitä, mikäli tiedosto, kansio tai sen isäkansio on versioitu. TortoiseSVN-valikko näkyy myös osana Resurssienhallinnan Tiedosto-valikkoa.

Joissain tapauksissa saatat nähdä valikossa useita TortoiseSVN-kohtia. Tämä ei ole virhe!

Kuva 4.3. Pikakuvakkeen Tiedosto-valikko versioidussa kansiossa

Tässä esimerkissä versioimaton pikakuvake sijaitsee versioidussa kansiossa, ja Resurssienhallinnan Tiedosto-valikossa on kolme TortoiseSVN-kohtaa. Yksi on kansiolle, yksi pikakuvakkeelle itselleen ja kolmas oliolle, johon pikakuvake viittaa. Auttaakseen sinua erottamaan ne toisistaan, kuvakkeilla on tunnus oikeassa alakulmassa näyttämään, onko valikon kohta tiedostolle, kansiolle, pikakuvakkeelle vaiko useille valituille kohteille.

Kuva 4.4. Oikea-raahaa -valikko versioidulle kansiolle

TortoiseSVN-komentoja on käytettävissä myös, kun oikea-raahaat tiedostoja tai kansioita uuteen paikkaan työkopion sisällä tai kun oikea-raahaat versioimattoman tiedoston tai kansion versioituun hakemistoon.

Joillakin tavallisilla toiminnoilla on vakiintuneet Windows-pikanäppäimet, mutta ne eivät näy painikkeissa tai valikoissa. Jos et keksi, miten saada tehtyä jotain ilmeistä, esim. ikkunan päivitys, tarkista oheinen lista.

Mikäli arkisto käyttää salasanasuojausta, esiin aukeaa tunnistusikkuna.

Kuva 4.5. Tunnistusikkuna

Syötä käyttäjätunnuksesi ja salasanasi. Valintaruudun avulla voit tallettaa tiedot Subversionin oletushakemiston %APPDATA%\Subversion\auth kolmeen alihakemistoon:

Mikäli haluat tyhjentää talletetut tunnistetiedot, voit tehdä sen TortoiseSVN:n asetusikkunan Tallennetut tiedot -sivulla. Painike Tyhjennä kaikki poistaa talletetut tunnistetiedot kaikista arkistoista. Painike Tyhjennä... puolestaan avaa ikkunan, josta voit valita poistettavat yksittäiset tunnistetiedot. Katso myös ”Tallennettujen tietojen asetukset”.

Jotkut käyttäjät haluavat, että tunnistustiedot poistetaan, kun Windows suljetaan tai siitä kirjaudiutaan ulos. Tämä voidaan tehdä uloskirjautumiskomentojonolla, joka poistaa kansion %APPDATA%\Subversion\auth, esim.

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

Verkkosivusto http://www.windows-help-central.com/windows-shutdown-script.html sisältää ohjeita tällaisten komentojonojen käyttämiseen.

Katso ”Arkiston käyttö” saadaksesi lisätietoja tunnistuksen ja saantioikeuksien määrittelystä SVN-palvelimelle.

Monet TortoiseSVN-ikkunat sisältävät paljon tietoa, ja voit joutua kasvattamaan niiden kokoa. Usein on kuitenkin hyödyllisempää kasvattaa pelkästään korkeutta, tai pelkästään leveyttä, kun maksimoida ikkuna näytön kokoiseksi. Tämän helpottamiseksi Suurenna-painikkeella on lisätoimintoja: hiiren keskinäppäin suurentaa pystysuunnassa, ja hiiren oikea näppäin suurentaa vaakasuunnassa.

Jos olet tuomassa uutta projektia arkistoon, joka sisältää olemassa olevia projekteja, on kansiorakenne jo kiinnitetty. Jos sen sijaan olet tuomassa projektia uuteen arkistoon, kannattaa miettiä hetki arkiston rakenteen organisointia. Luku ”Arkiston rakenne” käsittelee asiaa tarkemmin.

Tämä luku kuvaa Subversionin tuontikomennon, joka suunniteltiin kansiohierarkian tallettamiseksi arkistoon yhdellä kertaa. Vaikka tämä onnistuukin, komennossa on muutamia puutteita:

Näistä syistä suosittelemme, ettet käytä tuontikomentoa, vaan noudatat sen sijaan luvussa ”Tuonti arkistoon työkopion kautta” kuvattua kaksivaiheista menetelmää (kolmas vaihtoehto on luoda yksinkertainen /trunk /tags /branches -rakenne arkistoosi). Seuraavat kappaleet kuvaavat kuitenkin itse tuontikomennon toiminnan.

Ennen kuin tuot projektisi arkistoon sinun tulee:

Valitse nyt projektisi kansiorakenteen juurihakemisto Windows Resurssienhallinnassa ja napsauta hiire oikeaa näppäintä avataksesi kontekstivalikon. Valitse komento TortoiseSVN → Tuo arkistoon... joka avaa seuraavan ikkunan:

Kuva 4.6. Tuonti-ikkuna

Tähän ikkunaan sinun on annettava arkistopaikannin, johon haluat tuoda projektisi. On tärkeää muistaa, että paikallinen kansio, jota olet tuomassa, ei itse siirry arkistoon, vain sen sisältö. Jos kansiorakenteesi näyttää esimerkiksi seuraavalta:

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

ja tuot kansion C:\Projects\Widget arkistopaikantimeen http://mydomain.com/svn/trunk, saatat yllättyä havaitessasi, että alikansiosi ovat suoraan hakemistossa trunk alihakemiston Widget sijaan. Alikansio on annettava osana paikanninta: http://mydomain.com/svn/trunk/Widget-X. Huomaa, että tuontikomento luo automaattisesti alikansiot arkistoon, jos niitä ei vielä ole olemassa.

Tuontiviestiä käytetään lokiviestinä.

Oletusarvoisesti tiedostoja ja kansioita, jotka täsmäävät yleisen ohituslistan (global ignore pattern) kanssa, ei tuoda. Muuttaaksesi tätä käytäntöä voit ruksata Ota mukaan ohitetut tiedostot -valintalaatikon. Katso luvusta ”Yleiset asetukset” lisätietoa globaalin ohituslausekkeen asettamisesta.

Heti napsautettuasi OK-näppäintä TortoiseSVN tuo koko hakemistopuun kaikki tiedostot arkistoon. Projekti on nyt talletettu arkiston versionhallintaan. Huomaa, että kansio itse EI kuitenkaan versioidu! Saadaksesi työkopion juuri arkistoon tuoduista tiedostoista sinun on erikseen haettava niistä työkopio. Seuraavassa luvussa kuvataan vaihtoehtoinen tekniikka, jonka avulla voit tuoda tiedostot arkistoon ja luoda työkopion samalla kertaa.

Olettaen että sinulla on jo arkisto ja haluat lisätä siihen uuden kansiorakenteen, seuraa seuraavia ohjeita:

Joskus joudut versioimaan tiedoston, joka sisältää käyttäjäkohtaisia tietoja. Toisin sanoen jokainen käyttäjä/kehittäjä joutuu muokkaamaan sitä omiin tarpeisiinsa soveltuvaksi. Tällaisen tiedoston versiointi on kuitenkin vaikeaa, koska jokainen käyttäjä toimittaa joka kerta omat muutoksensa arkistoon.

Tällaisissa tapauksissa kannattaa käyttää tiedostopohjia. Luot tiedoston, joka sisältää kaikki kehittäjien tarvitsemat tiedot, lisäät sen versionhallintaan ja annat kehittäjien noutaa sen. Jokainen kehittäjä voi sitten tehdä kopion tiedostosta ja nimetä sen uudelleen. Tämän jälkeen kopion muokkaus ei ole enää ongelma.

Voit esimerkiksi vilkaista TortoiseSVN:n käännöskomentojonoa. Se kutsuu tiedostoa nimeltä default.build.user, jota ei ole arkistossa. Arkistossa on vain tiedosto default.build.user.tmpl, joka on pohja, josta kehittäjän on tehtävä kopio nimellä default.build.user. Tiedosto sisältää kommentteja, joista selviää, mitä rivejä pitää muuttaa paikallisia asetuksia vastaaviksi, jotta käännös toimisi.

Lopuksi lisäsimme vielä tiedoston default.build.user isähakemistonsa ohituslistaan, ts. sisällytimme sen Subversion-ominaisuuteen svn:ignore. Siten se ei turhaan näy toimitusikkunassa.

Hakiessasi työkopiota voit valita syvyyden, joka määrittää, miten syvälle alikansioihin työkopion haku etenee. Mikäli haluat vain muutamia osia suuresta versiopuusta, voit hakea työkopion vain ylätasolta ja päivittää sitten tarvittavat alikansiot palautuvasti.

Voit helposti muodostaa työkopion vain osasta arkistoa siten, että työkopio muistaa valitut osat. Tämä tapahtuu napsauttamalla painiketta Valitse kohteet... ja valitsemalla avautuvasta ikkunasta työkopioon lisättävät kohteet. Tällaista työkopiota kutsutaan epätäydelliseksi (engl. sparse). Kun päivität epätäydellisen työkopion, puuttuvia kohteita ei lisätä, vaan päivitys koskee pelkästään jo olemassa olevaa työkopion sisältöä.

Jos noudat epätäydellisen työkopion (valitsemalla syvyydeksi jotain muuta kuin täysin palautuva), voit myöhemmin helposti lisätä tai poistaa alihakemistoja jollain seuraavista tavoista.

Tämä ominaisuus on näppärä, kun haluat hakea työkopioosi osia suuresta hakemistopuusta, säilyttäen silti mahdollisuuden päivitykseen yhdellä operaatiolla. Jos hakemistopuussasi on esimerkiksi alihakemistot Project01 ... Project99, ja haluat työkopion vain kansioista Project03, Project25 ja Project76/SubProj, toimi seuraavasti:

Kun työkopiosi on päivitetty eikä siinä ole ristiriitoja, olet valmis toimittamaan muutoksesi arkistoon. Valitse toimitettavat kansiot ja/tai tiedostot ja suorita komento TortoiseSVN → Toimita....

Kuva 4.8. Toimitusikkuna

Toimitusikkuna näyttää kaikki muuttuneet tiedostot, mukaan lukien lisätyt, poistetut ja versioimattomat tiedostot. Jos et halua toimittaa jotain muuttunutta tiedostoa, poista sen valinta. Jos taas haluat sisällyttää toimitukseen versioimattoman tiedoston, ruksaa sen valinta.

Voit nopeasti valita tai poistaa valinnan kaikilta tietyn tyyppisiltä tiedostoilta napsauttamalla jotain tiedostolistan yläpuolella olevista linkeistä.

Luvussa ”Paikallinen ja etätila” on kuvattu, miten tiedostojen tilan mukaan tapahtuva väritys ja kuvakepäällykset toimivat.

Kohteet, jotka on vaihdettu osoittamaan toiseen arkistopolkuun, on merkitty (s)-merkillä. Olet saattanut esim. vaihtaa työkopion polkuja työskennellessäsi jossain haarassa ja unohtanut vaihtaa takaisin päähaaraan. Tämä on varoitus siitä!

Kaksoisnapsautus jonkin muutetun tiedoston päällä toimitusikkunassa käynnistää vertailutyökalun muutostesi näyttämiseksi. Kontekstivalikossa on lisää toimintoja, kuten oheinen kuva näyttää. Voit myös raahata tiedostoja toiseen sovellukseen kuten tekstieditoriin tai kehitysympäristöön.

Voit valita tai poistaa kohteitten valinnan napsauttamalla valintalaatikkoa niiden vasemmalla puolella. Hakemistoille voit käyttää toimintoa Shift-napsauta suorittaaksesi toiminnon palautuvasti.

Alapaneelissa näytetyt sarakkeet ovat mukautettavissa. Kun oikea-napsautat jonkin sarakeotsikon päällä, esiin aukeaa kontekstivalikko, jonka avulla näytetyt sarakkeet voi valita. Voit myös vaihtaa sarakkeen leveyttä käyttämällä raahauskahvaa, joka ilmestyy kun siirrät hiiren sarakkeiden väliselle rajalle. Mukautukset muistetaan, joten näet samat otsakkeet myös seuraavalla kerralla.

Oletusarvoisesti kaikki tiedostolukot vapautuvat onnistuneen toimituksen jälkeen. Jos haluat säilyttää lukot, varmista että valinta Pidä lukot on ruksattu. Valinnan oletusarvo otetaan no_unlock-asetuksesta Subversionin määrittelytiedostossa. Luvussa ”Yleiset asetukset” kerrotaan lisää Subversionin määrittelytiedoston muokkaamisesta.

Toimitusikkuna tukee Subversionin muutoslistoja, joiden avulla toisiinsa liittyvät tiedostot voi niputtaa yhteen. Ominaisuudesta kerrotaan lisää luvussa ”Muutoslistat”.

Joskus on tarpeen pystyä toimittamaan vain osa tiedostoon tehdyistä muutoksista. Tällainen tilanne sattuu tavallisesti, kun olet työstämässä jotain toimintoa, mutta kiireinen korjaus vaatii riippumatonta muutosta tiedostoon, jota olet jo muuttanut.

oikea-napasauta tiedostoa ja anna komento Kontekstivalikko → Palauta toimituksen jälkeen. Tämä luo kopion tiedostosta sen hetkisessä tilassaan., minkä jälkeen voit muokata tiedostoa vapaasti ja poistaa muutokset, joita et halua mukaan. Kun olet valmis, talleta muutokset ja toimita ne arkistoon.

Kun toimitus on valmis, tiedoston kopio palautetaan automaattisesti, ja sinulla on taas muuttunut tiedosto, jonka muutoksia ei ole vielä arkistossa.

Joskus on tarpeen versioida tiedostoja, jotka muuttuvat usein, mutta joita et oikeastaan halua toimittaa arkistoon. Tämä voi olla merkki huonosta ohjelmiston rakennusprosessista - miksi tiedostot on ylipäätään versioitu? Olisiko parempi käyttää kaavaintiedostoja? Versiointi on kuitenkin välttämätöntä, jos kehitysympäristösi esimerkiksi muuttaa projektitiedoston aikaleimaa jokaisen käännöksen yhteydessä. Projektitiedosto on tietenkin versioitava, koska se sisältää kaikki käännösasetukset; toisaalta sitä ei haluta toimittaa arkistoon pelkän aikaleiman muuttumisen vuoksi.

Näitä hankalia tilanteita voi helpottaa käyttämällä erityistä ignore-on-commit -muutoslistaa. Kaikki tämän listan tiedostot jäävät oletusarvoisesti pois arkistotoimituksesta. Voit yhä toimittaa ne, mutta tämä vaatii tiedostojen valitsemista erikseen toimitusikkunassa.

Muista syöttää lokiviesti, joka kuvaa muutoksia, joita olet toimittamassa. Tämä auttaa sinua näkemään, mitä milloinkin tapahtui, kun myöhemmin selaat projektilokia. Viesti voi olla niin pitkä tai lyhyt kuin haluat; monilla projekteilla on sovittu käytäntö lokiviestin sisällölle ja käytettävälle kielelle - joskus jopa yksityiskohtaiselle rakenteelle.

Voit muotoilla lokiviestiäsi yksinkertaisesti käyttämällä saman tapaista muotoilua kuin sähköpostiviesteissä. Muotoillaksesi tekstin kirjoita *tekstin* lihavoidaksesi, _tekstin_ alleviivataksesi ja ^tekstin^ kursivoidaksesi sen.

Kuva 4.9. Toimitusikkunan oikeinkirjoituksen tarkastus

TortoiseSVN sisältää oikeinkirjoituksen tarkistuksen, joka auttaa lokiviestin kirjoituksessa. Työkalu korostaa kaikki väärin kirjoitetut sanat. Käytä kontekstivalikkoa ottaaksesi käyttöön ehdotetut korjaukset. Työkalu ei tietenkään tunne kaikkia sinun tuntemiasi teknisiä termejä, joten oikein kirjoitetut sanatkin näkyvät joskus virheinä. Voit tällöin lisätä ne omaan sanastoosi kontekstivalikon avulla.

Lokiviesti-ikkunassa on myös tiedosto- ja funktionimien automaattinen täydennys. Työkalu käyttää säännöllisiä lausekkeita hakeakseen luokkien ja funktioiden nimiä niistä tekstitiedostoista, joita olet toimittamassa arkistoon. Jos sana, jota olet kirjoittamassa, täsmää minkään listalla olevan kanssa (kirjoitettuasi vähintään kolme merkkiä tai painettuasi Ctrl+Välilyönti), näkyviin ilmestyy pudotusvalikko, josta voit valita koko nimen. TortoiseSVN:n mukana tulevat säännölliset lausekkeet sijaitsevat TortoiseSVN-asennuksen bin-hakemistossa. Voit määritellä omia lausekkeitasi ja tallettaa ne tiedostoon %APPDATA%\TortoiseSVN\autolist.txt. Tämä tiedosto ei häviä, jos päivität TortoiseSVN-asennuksen. Jos et tunne säännöllisiä lausekkeita, tutustu niihin osoitteessa https://en.wikipedia.org/wiki/Regular_expression. Käyttöohjeen ja aloittelijan oppaan löydät osoitteesta https://www.regular-expressions.info/.

Säännöllisen lausekkeen säätäminen toimivaksi voi olla työlästä. Tästä syystä TSVN sisältää testi-ikkunan, johon voi syöttää säännöllisen lausekkeen ja tiedostonimiä, joita vastaan sitä testataan. Käynnistys tapahtuu komennolla TortoiseProc.exe /command:autotexttest.

Lokiviesti-ikkuna sisältää myös viestikatkelmatoiminnon. Katkelmat näytetään automaattisen täydennyksen pudotusvalikossa, kun näppäilet katkelman pikavalinnan. Katkelman valinta lisää koko katkelman lokiviestiin. TortoiseSVN-asennuksen mukana tulee joukko oletuskatkelmia, jotka sijaitsevat asennushakemiston kansiossa bin. Voit myös lisätä omia katkelmiasi tiedostoon %APPDATA%\TortoiseSVN\snippet.txt. Katkelmatiedostossa merkki # aloittaa kommenttirivin, merkit \n ja \r lisäävät rivinvaihdon ja merkki \\ lisää kenoviivan.

Voit käyttää uudelleen aiemmin syötettyjä lokiviestejä. Napsauta Viimeisimmät viestit nähdäksesi luettelon viimeisimmistä tälle työkopiolle syötetyistä viesteistä. Talletettujen viestien määrän voi muuttaa TortoiseSVN:n asetuksista.

Voit tyhjentää kaikki talletetut toimitusviestit TortoiseSVN:n asetuksien sivulta Talletetut tiedot. Voit myös tyhjentää yksittäisiä viestejä Viimeisimmät viestit-ikkunasta käyttämällä Delete-näppäintä.

Jos haluat sisällyttää valitut polut lokiviestiin, voit käyttää komentoa Kontekstivalikko → Liitä tiedostonimilista lokiviestin syöttöikkunassa.

Toinen keino lisätä polkuja lokiviestiin on yksinkertaisesti raahata tiedostot tiedostolistasta lokiviestin syöttöikkunaan.

Napsautettuasi OK esiin aukeaa ikkuna, joka näyttää toimituksen edistymisen.

Kuva 4.10. Edistymisikkuna näyttää toimituksen vaiheet

Edistymisikkuna käyttää värikoodausta korostaakseen eri toimintoja

Tässä on lueteltu oletusarvoiset värit, mutta voit mukauttaa värejä käyttämällä asetusikkunaa. Tätä on kuvattu tarkemmin luvussa ”Väriasetukset”.

Tiedostoristiriita syntyy, kun kaksi tai useampia kehittäjiä on muuttanut samoja rivejä jossain tiedostossa. Koska Subversion ei tiedä mitään projektistasi, se jättää ristiriitojen ratkonnan kehittäjän vastuulle. Ristiriitainen alue merkitään tekstitiedostoissa seuraavasti:

<<<<<<< tiedostonimi
    sinun muutoksesi
=======
    arkistosta yhdistetyt muutokset
>>>>>>> versio

Tämän lisäksi Subversion luo jokaista ristiriitaista tiedostoa kohti kolme ylimääräistä tiedostoa hakemistoosi:

Voit joko käynnistää ulkoisen yhdistämistyökalun komennolla TortoiseSVN → Muokkaa ristiriitoja/guimenuitem> tai voit k.

Suorita lopuksi komento TortoiseSVN → Ratkaistu ja toimita muutoksesi arkistoon. Huomaa, että Ratkaise-komento ei oikeasti ratkaise ristiriitaa. Se vain poistaa tiedostonimi.mine ja tiedostonimi.r* -tiedostot ja siten sallii myöhemmät toimita-komennot.

Jos sinulla on ristiriitoja binääritiedostojen kanssa, Subversion ei yritä yhdistää tiedostoja itse. Paikallinen tiedosto säilyy muuttumattomana (täsmälleen sellaisena, kuin viimeksi muuttaessasi sitä) ja työkopioosi luodaan tiedostonimi.r* -tiedostot. Jos haluat perua muutoksesi ja pitää arkistoversion, käytä komentoa Palauta. Jos haluat pitää oman versiosi ja ylikirjoittaa arkiston version, käytä komentoa Merkitse ratkaistuksi ja toimita sen jälkeen oma versiosi arkistoon.

Voit käyttää Merkitse ratkaistuksi -komentoa useille tiedostoille, jos valitset yläkansion ja sieltä komennon TortoiseSVN → Merkitse ratkaistuksi... Komento näyttää ikkunan, jossa luetellaan kaikki ristiriitaiset tiedostot; voit sitten valita, mitkä niistä merkitään ratkaistuiksi.

Ominaisuusristiriita syntyy, kun kaksi (tai useampia) kehittäjää on muuttanut samaa ominaisuutta. Kuten tiedostoristiriidan tapauksessa, ristiriidan voi ratkoa vain kehittäjä.

Jos jokin muutoksista korvaa toisen, valitse toinen vaihtoehdoista Ratkaise käyttämällä paikallista ominaisuutta tai Ratkaise käyttämällä etäominaisuutta. Mikäli muutokset on yhdistettävä, valitse Muokkaa ominaisuutta, tee tarvittavat muutokset ja merkitse ristiriita ratkaistuksi.

Puuristiriita syntyy, kun kehittäjä siirtää/nimeää uudelleen/poistaa tiedoston tai kansion, jonka joku toinen kehittäjä on myös siirtänyt/nimennyt uudelleen/poistanut, tai jota hän on pelkästään muokannut. On useita tilanteita, jotka voivat johtaa puuristiriitaan, ja jokainen niistä vaatii erilaisia toimenpiteitä ristiriidan ratkaisemiseksi.

Kun Subversion poistaa tiedoston paikallisesti, se poistetaan myös paikallisesta tiedostojärjestelmästä. Tästä syystä sille ei voida näyttää kuvakepäällystä eikä sitä voida valita komentojen kohteeksi puuristiriitatilanteessa. Käytä sen sijaan Tarkista muutokset -ikkunaa käynnistääksesi Muokkaa ristiriitoja -toiminnon.

TortoiseSVN voi auttaa oikean yhdistämispaikan löytämisessä, mutta ristiriitojen ratkaisemiseen voi liittyä ylimääräistä työtä. Muista, että päivityksen jälkeen työkopion BASE-versio sisältää jokaisen kohteen version sellaisena, kun se oli arkistossa päivityshetkellä. Jos palautat muutoksen päivityksen jälkeen, kohde palautuu arkistoversioon, ei siihen versioon, joka oli käytössä aloittaessasi omia muutoksiasi.

Kuva 4.12. Resurssienhallinnan kuvakepäällykset

Haettuasi työkopion Subversion-arkistosta näet tiedostosi Windows-resurssienhallinnassa erilaisin kuvakkein. Tämä on eräs syy siihen, miksi TortoiseSVN on niin suosittu. TortoiseSVN lisää ns. kuvakepäällyksen jokaisen versioidun tiedoston oman kuvakkeen päälle. Riippuen tiedoston Subversion-tilasta päällys on erilainen.

Juuri haettu työkopion tiedoston kuvakepäällys on vihreä ruksi. Subversion-tila on normaali.

Heti kun alat muokata tiedostoa, tila muuttuu muutetuksi ja kuvakepäällys puolestaan punaiseksi huutomerkiksi. Tämän avulla voit helposti nähdä, mitkä tiedostot ovat muuttuneet viime päivityksen jälkeen ja jotka pitää toimittaa arkistoon.

Jos päivityksen aikana syntyy ristiriita, kuvakepäällys muuttuu keltaiseksi huutomerkiksi.

Jos olet asettanut svn:needs-lock -ominaisuuden tiedostolle, Subversion poistaa kirjoitusoikeudet tiedostoon kunnes lukitset sen. Tällaisilla tiedostoilla on kuvakepäällys, joka kertoo, että tiedosto on lukittava ennen kuin sitä voi muokata.

Jos olet lukinnut tiedoston, ja Subversion-tila on normaali, tämä kuvakepäällys muistuttaa, että jos et aio muuttaa sitä, sinun tulee vapauttaa lukko salliaksesi muitten muutokset.

Tämä kuvakepäällys ilmaisee, että jotkut tiedostot/kansiot nykyisen kansion alapuolella on määritelty poistettaviksi versionhallinnasta. Se voi merkitä sitä, että versioitu tiedosto puuttuu kansiosta.

Plusmerkki kertoo, että tiedosto/kansio on merkitty lisättäväksi versionhallintaan.

Palkki ilmaisee, että tiedosto/kansio on ohitettu versionhallintatoiminnoissa. Päällys on valinnainen.

Tämä kuvake näytetään sellaisille tiedostoille ja kansioille, joita ei ole versioitu eikä myöskään ohitettu. Päällys on valinnainen.

Saatat havaita, että kaikkia näitä kuvakkeita ei käytetä sinun järjestelmässäsi. Tämä johtuu siitä, että kuvakepäällysten maksimimäärä Windowsissa on hyvin rajallinen, ja jos käytät myös TortoiseCVS-ohjelman vanhaa versiota, kuvakepäällyksiä on liikaa. TortoiseSVN yrittää olla ”mallikansalainen” ja rajoittaa kuvakepäällysten käyttöä antaakseen myös muille sovelluksille mahdollisuuden.

Nykyisin, kun Tortoise-tyyppisiä ohjelmia on useita (TortoiseCVS, TortoiseHg, ...), kuvakkeiden rajallinen määrä on todellinen ongelma. Ratkaistakseen tämän TortoiseSVN-projekti on luonut DLL-muodossa jaettavan jaetun kuvakejoukon, jota kaikki Tortoise-ohjelmat voivat käyttää. Tarkista ohjelmasi tekijöiltä, onko se jo otettu käyttöön :-)

Lisätietoa siitä, miten kuvakepäällykset vastaavat Subversion-tiloja sekä muita teknisiä yksityiskohtia löytyy luvusta ”Kuvakepäällykset”.

Kuva 4.13. Resurssienhallinnan ominaisuudet, Subversion-sivu

Joskus on tarpeen saada yksityiskohtaisempaa tietoa tiedostosta/kansiosta kuin mitä pelkkä kuvakepäällys tarjoaa. Nämä tiedot löytyvät Resurssienhallinnan ominaisuuksien Subversion-sivulta. Valitse tiedosto tai kansio ja anna komento Windows-valikko → Ominaisuudet kontekstivalikossa (huomaa: tämä on Resurssienhallinnan tavallinen Ominaisuudet-komento, ei TortoiseSVN-alivalikosta löytyvä!). Ominaisuudet-ikkunassa on TortoiseSVN:n lisäämä sivu versioiduille tiedostoille/kansioille, jossa näet kaikki oleelliset tiedot.

Kuva 4.14. Tarkista muutokset

On usein hyödyllistä tietää, mitä tiedostoja olet muutanut ja mitä tiedostoja muut ovat muuttaneet versionhallinnassa. Tällöin komento TortoiseSVN → Tarkista muutokset... on tarpeen. Avautuva ikkuna näyttää kaikki jollain tapaa muuttuneet tiedostot työkopiossasi, samoin kuin mahdolliset versioimattomat tiedostosi.

Napsauttamalla Tarkista arkisto voit etsiä muutoksia myös arkistosta. Tällä tavoin voit ennen päivitystä tarkistaa mahdolliset syntyvät ristiriidat. Voit myös päivittää valitsemasi tiedostot arkistosta päivittämättä koko kansiota. Oletusarvoisesti Tarkista arkisto-toiminto tutkii arkistoa työkopion syvyyden perusteella. Jos haluat nähdä arkiston kaikki tiedostot ja kansiot (ts. myös ne, joita ei ole haettu työkopioon), sinun on pidettävä Shift-näppäin pohjassa Tarkista arkisto painikkeen napsautuksen aikana.

Ikkuna käyttää värikoodausta korostaakseen tilaa.

Tässä on lueteltu oletusarvoiset värit, mutta voit mukauttaa värejä käyttämällä asetusikkunaa. Tätä on kuvattu tarkemmin luvussa ”Väriasetukset”.

Kuvakepäällyksiä käytetään kuvaamaan myös muita tiloja. Seuraava kuva näyttää kaikki mahdolliset kuvakepäällykset jotka näytetään tarpeen vaatiessa.

Kuvakepäällykset näytetään seuraavissa tiloissa:

Kohteet, jotka on vaihdettu osoittamaan toiseen arkistopolkuun, on merkitty (s)-merkillä. Olet saattanut esim. vaihtaa työkopion polkuja työskennellessäsi haarassa ja unohtanut vaihtaa ne takaisin päähaaraan. Tämä on varoitus siitä! Konstekstivalikon avulla voit vaihtaa takaisin tavallisiin polkuihin.

Ikkunan kontekstivalikosta voit vertailla muutoksia. Voit tarkistaa itse tekemäsi paikalliset muutokset komennolla Kontekstivalikko → Vertaa kantaversion (BASE) kanssa. Samoin voit tarkistaa muiden arkistoon tekemät muutokset komennolla Kontekstivalikko → Näytä erot unified diff-muodossa.

Voit myös palauttaa muutokset yksittäisiin tiedostoihin. Jos poistit tiedoston vahingossa, se näkyy muodossa Puuttuu ja voit käyttää Palauta-komentoa poiston palauttamiseen.

Versioimattomat ja ohitetut tiedostot voidaan lähettää Roskakoriin käyttäen komentoa Kontekstivalikko → Poista. Jos haluat poistaa tiedostot pysyvästi (ohittaen Roskakorin), pidä Shift-näppäin pohjassa kun napsautat Poista.

Jos haluat tutkia tiedostoa yksityiskohtaisesti, voit raahata sen täältä toiseen sovellukseen (esim. tekstieditori tai IDE). Voit myös tallettaa siitä kopion raahaamalla sen johonkin kansioon Windows-resurssienhallinnassa.

Sarakkeet ovat muokattavia. Jos oikea-napsautat minkä tahansa sarakeotsikon päällä, näkyviin ilmestyy kontekstivalikko, jonka avulla voit valita näytettävät sarakkeet. Voit myös vaihtaa sarakkeen leveyttä käyttämällä raahauskahvaa, joka ilmestyy, kun siirrät hiiren sarakerajalle. Nämä mukautukset muistetaan, joten näet samat otsikot myös seuraavalla kerralla.

Jos työskentelet useiden, toisistaan riippumattomien tehtävien parissa, voit myös ryhmitellä tiedostot muutoslistoihin. Lue lisätietoa luvusta ”Muutoslistat”.

Ikkunan alaosassa näytetään yhteenvetona työkopiosi sisältämä versioväli. Näytetyt versiot perustuvat toimitettuihin, ei päivitettyihin versioihin; ne esittävät versioväliä, jolla tiedostot viimeksi toimitettiin arkistoon, ei versioita, joihin ne on päivitetty. Huomaa myös, että versioväli perustuu vain näytettyihin tietoihin, ei koko työkopioon. Jos haluat nähdä tiedot koko työkopiosta, ruksaa valinta Näytä muuttumattomat tiedostot.

Usein on tarpeen tutkia tiedostojen sisältöä muutettujen kohtien osalta. Tämä tehdään valitsemalla muuttunut tiedosto ja antamalla komento Vertaa kontekstivalikosta. Tämä käynnistää ulkoisen vertailuohjelman, joka sitten vertaa nykyistä versiota alkuperäiseen (BASE-versio), joka otettiin talteen viimeisimmässä työkopion haussa tai päivityksessä.

Kuva 4.18. Versioloki

Voit avata loki-ikkunan useista paikoista:

Jos arkisto ei ole saatavilla, saat ilmoituksen Siirrytäänkö yhteydettömään tilaan?, joka on kuvattu luvussa ”Yhteydetön tila”.

Yläpaneelissa on Toimenpiteet-sarake, jonka kuvakkeet antavat yhteenvedon kussakin versiossa suoritetuista toimenpiteistä. Erilaisia kuvakkeita on neljä, joista kukin näytetään omassa sarakkeessaan.

Jos versio muutti tiedostoa tai hakemistoa, niin muutettu-kuvake näytetään ensimmäisessä sarakkeessa.

Jos versio lisäsi tiedoston tai hakemiston, niin lisätty-kuvake näytetään toisessa sarakkeessa.

Jos versio poisti tiedoston tai hakemiston, niin poistettu-kuvake näytetään kolmannessa sarakkeessa.

Jos versio korvasi tiedoston tai hakemiston, niin korvattu-kuvake näytetään neljännessä sarakkeessa.

Jos versio muutti tai nimesi uudelleen tiedoston tai hakemiston, niin siirretty-kuvake näytetään neljännessä sarakkeessa.

Jos versio korvasi tiedoston tai hakemiston siirtämällä tai nimeämällä sen uudelleen, niin siirtämällä korvattu-kuvake näytetään neljännessä sarakkeessa.

Jos versio yhdisti tiedoston tai hakemiston, niin yhdistetty-kuvake näytetään neljännessä sarakkeessa.

Jos versio yhdisti käänteisesti tiedoston tai hakemiston, niin käänteisesti yhdistetty-kuvake näytetään neljännessä sarakkeessa.

Kuva 4.19. Versiolokin yläpaneelin kontekstivalikko

Loki-ikkunan yläpaneelissa on kontekstivalikko, jonka komentojen avulla saat lisää tietoa. Jotkut komennot ovat saatavilla vain, kun lokia näytetään tiedostolle, jotkut taas ovat käytettävissä vain, kun lokia näytetään kansiolle.

Kuva 4.20. Code Collaborator -asetusikkuna

Kuva 4.21. Yläpaneeli kaksi versiota valittuna

Jos valitset kaksi versiota kerralla (käyttäen Ctrl-näppäintä), kontekstivalikko on erilainen:

Jos valitset useita peräkkäisiä versioita (käyttäen Ctrl tai Shift -näppäimiä), kontekstivalikko sisältää vaihtoehdon kaikkien versiovälillä tehtyjen muutosten perumiseen. Tämä on helpoin tapa poistaa joukko muutoksia yhdellä kertaa.

Voit myös yhdistää valitut versiot toiseen työkopioon, kuten yllä on kuvattu.

Jos kaikilla valituilla versioilla on sama tekijä, voit muokata kaikkien versioiden tekijää yhdellä kertaa.

Kuva 4.22. Lokin alapaneelin kontekstivalikko

Loki-ikkunan alapaneelissa on myös kontekstivalikko, jonka komentojen avulla voit

Kun loki-ikkunan alapaneelissa on useita tiedostoja valittuina, kontekstivalikko muuttuu seuraavaksi:

Kuva 4.23. Lokin alapaneelin kontekstivalikko, kun useita tiedostoja on valittuna.

Loki ei aina näytä kaikkia koskaan tehtyjä muutoksia useista eri syistä:

Jos haluat nähdä lisää lokiviestejä, napsauta Seuraavat 100 -painiketta saadaksesi 100 seuraavaa lokiviestiä. Voit toistaa tämän niin monta kertaa kuin on tarpeen.

Tämän painikkeen vieressä on monitoimipainike, joka muistaa, mihin sitä viimeksi käytettiin. Napsauta nuolta nähdäksesi vaihtoehtoiset komennot.

Käytä Näytä väli ... -komentoa, jos haluat nähdä tietyn versiovälin. Komento avaa ikkunan, johon voit syöttää alku- ja loppuversion.

Käytä Näytä kaikki -komentoa, jos haluat nähdä kaikki lokiviestit HEAD-versiosta aina versioon 1 saakka.

Päivittääksesi viimeisimmän näytetyn version, paina F5.

Paina Ctrl-F5 päivittääksesi lokivälimuistin.

Koska loki-ikkuna näyttää HEAD-version (eikä työkopion nykyversion) lokin, saattaa usein käydä niin, että näet lokiviestejä sisällölle, joka ei ole vielä mukana työkopiossa. Jotta tämä olisi selkeämpää, työkopiosi versiota vastaava toimitusviesti näytetään lihavoituna.

Kun näytät loki-ikkunan kansiolle, sen sisältämä suurin versionumero korostetaan; tämä vaatii työkopion läpikäymisen. Läpikäynti tapahtuu erillisessä säikeessä jotta loki-ikkunan näyttäminen ei viivästyisi, mutta tästä syystä kansioiden korostus ei välttämättä näy heti.

Subversion 1.5 ja uudemmat versiot pitävät kirjaa tehdyistä yhdistämisistä ominaisuuksien avulla. Tämän ansiosta yhdistämisistä saadaan tarkempaa historiatietoa kuin aiemmin. Jos esimerkiksi kehität uuden ominaisuuden haarassa ja yhdistät sen sitten päähaaraan, ominaisuuden kehitysloki näkyy päähaaran lokissa vain yhtenä toimituksena (tehty yhdistäminen), vaikka haarassa on saattanut olla satoja arkistotoimituksia ominaisuuden kehityksen aikana.

Kuva 4.24. Yhdistettyjen versioiden jäljitys loki-ikkunassa

Jos haluat nähdä yksityiskohtaisesti, mitkä versiot yhdistettiin näytettävään haaraan osana arkistotoimitusta, ruksaa valinta Ota yhdistetyt versiot mukaan. Toiminto hakee lokiviestit uudelleen, mutta lisää väliin lokiviestit, jotka yhdistettiin. Yhdistetyt versiot näytetään harmaina koska ne esittävät muutoksia, jotka on tehty eri osaan arkistopuuta.

Yhdistäminen ei tietenkään koskaan ole yksinkertaista! Kun jotain toimintoa kehitetään omassa kehityshaarassaan, siihen luultavasti tehdään ajoittaisia yhdistämisiä päähaarasta, jotta kehityshaara pysyy ajan tasalla. Niinpä haaran yhdistämishistoria sisältää myös lisäkerroksen yhdistämishistoriaa. Nämä eri kerrokset näytetään lokissa sisentämällä.

Versio-ominaisuudet eroavat täysin kunkin Subversion-kohteen ominaisuuksista. Versio-ominaisuudet (eng. revprops) ovat kuvaustietoja (esim. lokiviesti, toimituspäiväys ja tekijä), jotka liitetään tiettyyn versionumeroon arkistossa.

Joskus saatat haluta muuttaa aimmin syöttämääsi lokiviestiä, ehkäpä kirjoitusvirheen takia, tai koska haluat parantaa sitä tai muuttaa sitä muista syistä. Tai haluat muuttaa toimituksen tekijätiedon, koska unohdit laittaa tunnistuksen kuntoon, tai...

Sekä lokiviestiä että tekijätietoja voidaan muuttaa milloin vain. Koska tällaisia muutoksia ei voi perua (muutokset eivät versioidu), ominaisuus on oletusarvoisesti estetty. Salliaksesi sen sinun on määriteltävä pre-revprop-change -toimintokomento. Katso lisätietoa Subversion-kirjan kappaleesta Hook Scripts. Luvussa ”Palvelinpään komentojonot” on tietoa toimintokomentojen ottamisesta käyttöön Windows-ympäristössä.

Määriteltyäsi tarpeelliset komentosarjat palvelimellasi voit muuttaa minkä tahansa version tekijätietoja tai lokiviestejä (tai mitä tahansa versio-ominaisuutta). Komento tähän löytyy loki-ikkunan yläpaneelin kontekstivalikosta. Voit myös muokata lokiviestiä keskipaneelin kontekstivalikon avulla.

Jos et halua käydä läpi satojen lokiviestien listaa, voit rajoittaa näytetyt lokiviestit vain niihin, joista olet kiinnostunut käyttämällä loki-ikkunan yläosassa olevia suodatintoimintoja. Alku- ja loppupäiväyskontrollien avulla näytetyt viestit voi rajoittaa tietylle päivämäärävälille. Hakukontrollin avulla voit näyttää vain viestit, jotka sisältävät annetun tekstin.

Napsauta etsintäkuvaketta valitaksesi, mitä etsitään. Valitse etsintä säännöllisten lausekkeiden avulla. Tavallisesti tarvitset luultavasti vain yksinkertaista tekstihakua, mutta monimutkaisemmissa hauissa säännöllisten lausekkeiden käytöstä on hyötyä. Jos viet hiiren kontrollin päälle, esiin aukeaa työkaluvihje, jossa on vinkkejä säännöllisten lausekkeiden käytöstä ja merkkijonofunktioista. Suodatin toimii tarkistamalla, täsmääkö antamasi merkkijono lokiviestien kanssa, ja vain ne lokiviestit näytetään, jotka täsmäävät suodatinmerkkijonon kanssa.

Yksinkertainen osamerkkijonohaku toimii samaan tapaan kuin hakukone. Etsittävät merkkijonot erotetaan välilyönnein, ja kaikkien on täsmättävä. Voit käyttää etuliitettä - kertomaan, että osamerkkijonoa ei saa löytyä, ja etuliitettä ! lausekkeen alussa kertomaan, että koko lauseke on täsmättävä käänteisesti. Voit käyttää etuliitettä + kertomaan, että osamerkkijonon on löydyttävä (vaikka se olisi aiemmin suljettu pois etuliitteellä -). Huomaa, että järjestyksellä on tässä väliä. Voit käyttää lainausmerkkejä ympäröimään merkkijonoja, joissa on välilyöntejä, ja mikäli haluat etsiä itse lainausmerkkiä, tapahtuu se laittamalla kaksi lainausmerkkiä perätysten. Huomaa, että kenoviivaa ei käytetä pakomerkkinä. Esimerkit selventävät asiaa:

Alice Bob -Eve

etsii merkkijonoja, joissa esiintyy sekä Alice että Bob muttei Eve.

Alice -Bob +Eve

etsii merkkijonoja, joissa esiintyy sekä Alice muttei Bob, tai jonoja joissa esiintyy Eve.

-Case +SpecialCase

etsii merkkijonoja, joissa ei esiinny Case, ottaen kuitenkin mukaan jonot, joissa esiintyy SpecialCase.

!Alice Bob

etsii merkkijonoja, joissa ei esiinny sekä Alice että Bob.

!-Alice -Bob

muistatko De Morganin lauseen? NOT(NOT Alice AND NOT Bob) yksinkertaistuu muotoon (Alice OR Bob).

"Alice and Bob"

etsii merkkijonoa ”Alice and Bob”.

""

etsii lainausmerkkiä missä tahansa tekstissä.

"Alice says ""hi"" to Bob"

etsii merkkijonoa ”Alice says "hi" to Bob”.

Säännölliset lausekkeet eivät mahdu tämän oppaan aihepiiriin, mutta löydät johdantomateriaalia osoitteestahttp://www.regular-expressions.info/.

Huomaa, että suodattimet toimivat vain jo haettuihin viesteihin. Niillä ei ole vaikutusta viestien hakemiseen arkistosta.

Voit myös suodattaa alapaneelissa näytettyjä polkunimä käyttämällä Näytä vain kohteeseen liittyvät polut -valintaa. Liittyvät polut ovat niitä, jotka sisältävät osanaan polun, jota käytetään itse lokin näyttämiseen. Jos lokia näytetään kansiolle, tämä tarkoittaa kaikkia tiedostoja kansiossa tai sen alapuolella. Tiedostolle se tarkoittaa vain tiedostoa itseään. Normaalisti polkuilista näyttää kaikki polut, jotka liittyvät samaan toimitukseen, mutta harmaina. Mikäli valinta on käytössä, nämä polut piilotetaan.

Joskus on tarpeen vaatia, että lokiviestit noudattavat sovittua muotoa, mikä tarkoittaa, että muutoksia kuvaava teksti ei näy yläpaneelin lyhennetyssä yhteenvedossa. Ominaisuutta tsvn:logsummary voidaan käyttää irrottamaan lokiviestistä yläpaneelissa näkyvä osa. Lue luvusta ”TortoiseSVN-projektin ominaisuudet” kuinka ominaisuutta käytetään.

Tilastot-painike näyttää joitain mielenkiintoisia metriikoita lokissa näkyvistä versioista. Komento laskee, kuinka monta tekijää on tehnyt muutoksia, kuinka monta muutosta on tehty, mikä on ollut viikottainen edistyminen, jne. Näet yhdellä silmäyksellä, kuka on tehnyt eniten töitä, ja kuka on laiskotellut ;-)

Toimitukset arkistoon tekijöittäin

Kuva 4.25. Toimitukset tekijöittäin -histogrammi

Tämä graafi näyttää, ketkä tekijät ovat olleet aktiivisimpia projektissa. Piirtovaihtoehtoina ovat histogrammi, pinottu histogrammi tai ympyräkaavio.

Kuva 4.26. Toimitukset tekijöittäin -ympyräkaavio

Tilanteessa, jossa päätekijöitä on vähän ja avustavia tekijöitä paljon, pienten segmenttien suuri lukumäärä voi tehdä graafista vaikealukuisen. Ikkunan alaosassa olevan liukukytkimen avulla voit säätää kynnyksen (prosentteina kaikista toimituksista), jonka alapuolinen aktiviteetti niputetaan kategoriaan Muut.

Toimitukset päiväyksen mukaan

Kuva 4.27. Toimitukset päiväyksen mukaan -graafi

Tässä ikkunassa näet graafisesti projektin aktiivisuuden toimitusten lukumäärän ja tekijöiden mukaan. Graafi antaa osviittaa siitä, milloin projektin parissa työskennellään, ja kuka työskentelee milloinkin.

Kun tekijöitä on useita, graafissa on useita viivoja. Saatavilla on kaksi näkymää: tavallinen, missä kunkin tekijän aktiivisuus on suhteessa perusviivaan, ja pinottu, missä kunkin tekijän aktiivisuus on suhteessa alla olevaan viivaan. Jälkimmäinen vaihtoehto välttää viivojen leikkaukset, mikä saattaa tehdä graafista helppolukuisemman; toisaalta yksittäisen tekijän tuotoksien määrää on vaikeampi arvioida.

Oletusarvoisesti analyysi välittää merkkien tasoista, joten käyttäjiä PeterEgan ja PeteRegan kohdellaan eri tekijöinä. Monissa tapauksissa käyttäjänimet eivät välitä merkkien tasosta, ja voivat siten olla vaihtelevasti syötettyjä. Tällöin haluat luultavasti käyttäjien DavidMorgan ja davidmorgan tarkoittavan samaa henkilöä. Käytä Tekijät merkkien tasosta välittämättä -valintaa määrittämään, miten tässä toimitaan.

Huomaa, että tilastot kattavat saman jakson, minkä loki näyttää. Jos se näyttää vain yhtä versiota, tilastot eivät kerro sinulle kovin paljon.

Kuva 4.28. Yhteydetön tila

Jos palvelimeen ei saada yhteyttä ja lokiviestien talletus on päällä, voit käyttää loki-ikkunaa ja versiograafia yhteydettömässä tilassa. Tällöin käytetään paikallisesti talletettuja lokitietoja, ja voit jatkaa työskentelyä, vaikka tiedot eivät välttämättä ole ajan tasalla tai täydellisiä.

Tässä sinulla on kolme vaihtoehtoa:

Valinta Tee tästä oletusarvo estää ikkunan näyttämisen uudelleen ja valitsee sen sijaan aina vaihtoehdon, jonka valitset seuraavaksi. Voi yhä vaihtaa (tai poistaa) oletuksen toiminnolla TortoiseSVN → Asetukset.

Jos haluat tarkistaa palvelimelta uudet lokiviestit, voit päivittää näytön helposti painamalla F5. Mikäli käytät lokivälimuistia (oletusarvoisesti päällä), komento noutaa arkistosta vain uudet lokiviestit. Jos lokivälimuisti on yhteydettömässä tilassa, komento koettaa myös siirtyä takaisin yhteydelliseen tilaan.

Jos käytät lokivälimuistia ja uskot lokiviestin sisällön tai tekijän muuttuneen, voit käyttää komentoa Shift-F5 tai Ctrl-F5 hakeaksesi näytössä olevat viestit uudelleen palvelimelta lokivälimuistiin. Huomaa, että tämä koskee vain näytettäviä viestejä eikä mitätöi kyseisen arkiston lokivälimuistia kokonaisuudessaan.

Jos olet määritellyt ulkoisen vertailuohjelman, voit käyttää vaihtoehtoista työkalua pitämällä Shift -näppäimen pohjassa antaessasi Vertaa-komennon. Lue luvusta ”Ulkoiset ohjelmat”, miten ulkoiset vertailutyökalut määritellään.

Jossain vaiheessa projektia saattaa tulla tarpeelliseksi muuttaa rivinloppumerkit CRLF-muodosta LF-muotoon. Saatat myös muuttaa jonkun lohkon sisennystä. Valitettavasti molemmat toimenpiteet merkitsevät suuren määrän rivejä muuttuneiksi, vaikka itse sisällön merkitys ei muutu. Seuraavat asetukset auttavat tällaisissa tilanteissa vertailtaessa ja sovellettaessa paikkatiedostoja. Valinnat löytyvät komentojen Yhdistä ja Selvitä tekijät yhteydestä, samoin kuin TortoiseMerge-työkalun asetuksista.

Älä välitä rivinvaihdoista ohittaa muutokset, jotka johtuvat pelkästään erilaisesta rivinlopetustyylistä.

Vertaa tyhjämerkkejä tulkitsee kaikki muutokset sisennyksessä ja rivin sisäisissä tyhjämerkeissä lisättyinä/poistettuina riveinä.

Ohita muuttuneet tyhjämerkit jättää pois muutokset, jotka johtuvat pelkästään tyhjämerkkien määrän tai tyypin muutoksesta, esim. sisennysmerkkien muuttumisesta tabulointimerkeistä välilyönneiksi. Tyhjämerkkien lisääminen paikkaan, missä niitä ei ennen ollut, tai kaikkien tyhjämerkkien poisto luetaan yhä muutokseksi.

Ohita kaikki tyhjämerkit jättää huomiotta kaikki tyhjämerkeistä johtuvat muutokset.

Kaikki rivit, joiden sisältö on muuttunut, sisältyvät tietenkin aina vertailuun.

Kuva 4.29. Versioiden vertailu

Kun valitset kaksi alipuuta arkistoselaimesta, tai kun valitset jonkin kansion kaksi eri versiota loki-ikkunasta, voit antaa komennon Kontekstivalikko → Vertaa versioita.

Ikkuna näyttää listan kaikista muuttuneista tiedostoista ja sallii yksittäisten tiedostojen vertaamisen tai muutosten tekijöiden selvittämisen kontekstivalikon kautta.

Voit viedä muutospuun, mistä voi olla hyötyä, jos joudut lähettämään jollekulle projektisi puurakenteen, joka sisältää vain muuttuneet tiedostot. Toiminto koskee vain valittuja tiedostoja, joten joudut valitsemaan haluamasi tiedostot - yleensä kaikki - ja antamaan sitten komennon Kontekstivalikko → Vie valitut tiedostot.... Sinulta kysytään lopuksi muutospuun talletuspaikka.

Voit myös siirtyä tietylle riville käyttämällä komentoa Muokkaa → Siirry riville....

Jos haluat viedä tiedostolistan ja toimenpiteet (muutettu, lisätty, poistettu) samalla kertaa, voit tehdä sen komennolla Kontekstivalikko → Kopioi valinta leikepöydälle.

Ikkunan yläosassa oleva nuolipainike sallii vertailun suunnan muuttamisen. Voit siis näyttää muutokset, joiden avulla A:sta saadaan B, tai, halutessasi, miten B:stä saadaan A.

Versionumeroilla varustettuja painikkeita voi käyttää asettamaan erilainen versioväli. Aina kun vaihdat väliä, lista vertailtavien versioiden välissä muuttuneista kohteista päivittyy automaattisesti.

Jos tiedostonimilista on hyvin pitkä, voit käyttää etsintäkenttää supistamaan sitä. Huomaa, että haku on yksinkertainen tekstihaku, joten jos haluat rajoittaa listan C-tiedostoihin, syötä .c eikä *.c.

Tekstitiedostojen vertailuun on saatavilla useita työkaluja, muiden muassa TortoiseMerge, mutta usein on tarpeen nähdä, miten kuvatiedosto on muuttunut. Tätä varten kehitettiin TortoiseIDiff.

Kuva 4.30. Kuvien vertailuohjelma

Komento TortoiseSVN → Vertaa mille tahansa yleiselle kuvaformaatille käynnistää TortoiseIDiff-työkalun, jolla kuvia voi verrata. Oletusarvoisesti kuvat näytetään rinnakkain, mutta Näytä-valikon tai työkalurivin avulla voit vaihtaa ne näkymään pinottuna; voit myös halutessasi näyttää kuvat sekoitettuna päällekkäin.

Käytössä on tietenkin myös zoomaus- ja siirtotyökalut. Voit siirtää kuvaa raahaamalla sitä hiiren vasemmalla napilla. Jos valitset asetuksen Kytke kuvat yhteen , niin siirtokontrollit (vierityspalkit, hiiren rullapyörä) kytkeytyvät molemmissa kuvissa yhteen.

Kuvan tietolaatikko näyttää yksityiskohtia kuvatiedostosta, kuten koko pikseleinä, tarkkuus ja värisyvyys. Jos tietolaatikko on tiellä, komento Näytä → Kuvan tiedot piilottaa sen. Samat tiedot näytetään työkaluvihjeessä, kun pidät hiirtä hetken kuvaotsikon päällä.

Kun kuvat ovat päällekkäin, niiden suhteellista intensiteettiä (alpha) kontrolloidaan ikkunan vasemmalla puoliskolla olevan liukukytkimen avulla. Voit napsauttaa minne tahansa liukukytkimen päällä tai säätää sitä muuttaaksesi sekoitusta interktiivisesti. Toiminto CTRL+SHIFT-Hiiren vieritysrulla vaihtaa myös sekoitusta.

Liukusäätimen yläpuoinen painike vaihtaa 0% ja 100% sekoituksien välillä, ja jos kaksoisnapsautat painiketta, sekoitus alkaa vaihdella automaattisesti sekunnin välein, kunnes napsautat painiketta uudelleen. Tästä voi olla hyötyä pienten muutosten etsinnässä.

Joskus on hyödyllistä nähdä erot sekoituksen sijaan. Sinulla saattaa olla esim. kaksi piirilevykaavion versiota ja haluat tietää, mitkä osat ovat muuttuneet. Jos otat pois käytöstä sekoitustilan, ero näytetään pikselien väriarvojen XOR-operaationa. Muuttumattomat alueet ovat valkoisia ja muutetut alueet värjättyjä.

Kun haluat vertailla muuta kuin tekstiä sisältäviä dokumentteja, on normaalisti käytettävä ohjelmaa, jolla dokumentti luotiin, koska vain se tuntee dokumentin rakenteen. Yleisesti käytetyissä Microsoft Office- ja Open Office -ympäristöissä onkin mukana vertailutuki, ja TortoiseSVN sisältää komentojonoja, joiden avulla ohjelmat käynnistyvät oikeilla asetuksilla, kun vertailet niillä tehtyjä dokumentteja. Voit tarkistaa, mitä tiedostotyyppejä tuetaan ja lisätä omiasi komennolla TortoiseSVN → Asetukset ja napsauttamalla Ulkoiset ohjelmat -osion painiketta Lisäasetukset.

Jos TortoiseSVN:n mukana tulevat työkalut eivät tee kaikkia haluamiasi asioita, koeta jotain toista avoimen lähdekoodin- tai kaupallista työkalua. Jokaisella on oma suosikkinsa, eikä seuraava luettelo ole millään muotoa täydellinen, mutta tässä on muutamia harkitsemisen arvoisia työkaluja:

Lue kappaleesta ”Ulkoiset ohjelmat” lisätietoa työkalujen ottamisesta käyttöön TortoiseSVN:ssä.

Subversionin ohituslausekkeet hyödyntävät tiedostonimien yleistystä (globbing), alun perin Unixista lähtöisin olevaa tekniikkaa, jonka avulla tiedostonimet yleistetään käyttäen erikoismerkkejä:

Hahmontäsmäys riippuu merkkien tasosta, mikä voi aiheuttaa ongelmia Windowsissa, Voit pakottaa ei-riippuvan käytöksen (työläästi) parittamalla merkit, esim. ohittaaksesi *.tmp-hahmon merkkien tasosta riippumatta, voit käyttää hahmoa *.[Tt][Mm][Pp].

Jos olet kiinnostunut yleistyksen virallisestä määrittelystä, voit tutkia komentotulkin IEEE-määrittelyä dokumentissa Pattern Matching Notation.

Käytä komentoa TortoiseSVN → Poista poistaaksesi tiedostoja tai kansioita arkistosta.

Kun poistat tiedoston tai kansion komennolla TortoiseSVN → Poista, se häviää heti työkopiostasi ja merkitään poistettavaksi arkistosta seuraavan toimituksen yhteydessä. Tiedoston sisältävä kansio näyttää ”muutettu” -kuvakepäällystä. Aina arkistotoimitukseen saakka voit saada tiedoston takaisin suorittamalla komennon TortoiseSVN → Palauta sen sisältävälle kansiolle.

Jos haluat poistaa kohteen arkistosta, mutta säilyttää sen paikallisesti versioimattomana tiedostona/kansiona, käytä komentoa Laajennettu kontekstivalikko → Poista (säilytä paikallinen). Nähdäksesi komennon sisältävän laajennetun kontekstivalikon, sinun on pidettävä Shift-näppäin painettuna, kun napsautat hiiren oikeaa näppäintä Resurssienhallinnan oikeassa paneelissa.

Jos tiedosto poistetaan Resurssienhallinnan avulla käyttämättä TortoiseSVN-kontekstivalikkoa, toimitusikkuna näyttää sen ja sallii poiston versiohallinnasta ennen toimitusta. Jos kuitenkin päivität työkopiotasi, Subversion havaitsee puuttuvan tiedoston ja korvaa sen viimeisimmällä arkistoversiolla. Jos joudut poistamaan versioidun tiedoston, käytä aina komentoa TortoiseSVN → Poista jotta Subversionin ei tarvitse arvata, mitä todella haluat tehdä.

Mikäli on tarpeen nimetä tiedosto tai kansio uudelleen, käytä komentoa Kontekstivalikko → Nimeä uudelleen.... Syötä kohteelle uusi nimi ja olet valmis.

Jos haluat siirtää tiedostoja työkopion sisällä, ehkäpä eri alikansioon, raahaa ne käyttäen hiiren oikeaa näppäintä:

Toinen keino tiedostojen kopiointiin tai siirtämiseen on käyttää Windowsin kopioi/leikkaa -komentoja. Valitse haluamasi tiedostot, napsauta hiiren oikeata painiketta ja valitse komento Kontekstivalikko → Kopioi. Siirry sitten kohdehakemistoon, napsauta hiiren oikeata painiketta ja valitse komento TortoiseSVN → Liitä. Jos haluat siirtää tiedostoja, käytä komentoa Kontekstivalikko → Leikkaa komennon Kontekstivalikko → Kopioi sijaan.

Voit myös käyttää arkistoselainta kohteiden siirtelyyn. Lue lisää luvusta ”Arkistoselain”.

Jos arkisto sisältää jo kaksi tiedostoa, joilla on sama nimi, mutta eri merkkitasot (esim. TEST.TXT ja test.txt), et pysty päivittämään tai hakemaan työkopiota tiedostot sisältävästä arkiston hakemistosta Windows-ympäristössä. Vaikka Subversion tukee merkkitasosta riippuvia tiedostonimiä, Windows ei sitä tee.

Tämä tilanne syntyy joskus, kun kaksi kehittäjää toimittaa muutokset arkistoon eri työkopioista, joissa on sama tiedosto eri tavoin nimettynä. Se voi myös sattua, kun tiedostot toimitetaan esim. Linux-työasemasta.

Tällaisessa tapauksessa sinun on päätettävä, kumman tiedoston haluat pitää, ja tuhota (tai nimetä uudelleen) toinen arkistosta.

Joskus käy niin, että ystävällinen kehitysympäristösi nimeää tiedostoja puolestasi uudestaan esim. osana ohjelman uudelleenjärjestelyä (refactoring), eikä tietenkään kerro tästä Subversionille. Jos päätät toimittaa muutoksesi arkistoon tässä tilanteessa, Subversion tulkitsee, että vanha tiedosto puuttuu ja uusi on versioimaton. Voisit tietenkin ruksata uuden tiedoston saadaksesi sen lisätyksi, mutta menettäisit silloin lokihistorian, koska Subversion ei tiedä, että tiedostot liittyvät toisiinsa.

Parempi keino ratkaista asia on kertoa Subversionille, että kyseessä on oikeastaan uudelleen nimeäminen. Voit tehdä tämän sekä Toimita että Tarkista muutokset -ikkunoista: valitse sekä vanha (puuttuva) ja uusi (versioimaton) nimi sekä anna komento Kontekstivalikko → Korjaa siirto parittaaksesi tiedostot uudelleennimennäksi.

Tavallisesti ohituslista kannattaa asettaa niin, että kaikki tuotetut tiedostot ohitetaan Subversionissa. Mutta entäpä jos haluat poistaa kaikki ohitetut kohteet esim. rakentaaksesi sovelluksen alusta uudelleen? Tavallisesti tällainen tehdään makefile-tiedostolla tai kehitysympäristön komennolla, mutta joskus tämä ei ole mahdollista, joten on hyödyllistä pystyä nollaamaan tilanne muutenkin.

TortoiseSVN sisältää komennon Laajennettu kontekstivalikko → Poista versioimattomat kohteet ... juuri tätä tarkoitusta varten. Sinun on pidettävä Shift-näppäin pohjassa oikea-napsauttaessasi hiirellä Resurssienhallinnan oikeassa paneelissa saadaksesi laajennetun kontekstivalikon näkyviin. Komento avaa ikkunan, jossa on lueteltu kaikki kansion sisältämät versioimattomat tiedostot. Voit sitten valita ne tiedostot, jotka haluat poistettavan.

Kun tällaiset kohteet poistetaan, ne siirretään Roskakoriin, joten virheen sattuessa voit yhä palauttaa alkuperäisen tilanteen.

Kuva 4.37. Subversion ominaisuussivu

Voit katsoa ja asettaa Subversion-ominaisuuksia Resurssienhallinnan ominaisuusikkunasta, mutta se onnistuu myös TortoiseSVN-alivalikosta, TortoiseSVN → Ominaisuudet.

Voit lisätä sekä omia ominaisuuksiasi että ominaisuuksia, joilla on erityismerkitys Subversionille. Jälkimmäiset alkavat etuliitteellä svn:. Esimerkiksi svn:externals on tällainen ominaisuus; katso lisää ulkoisten viitteiden käytöstä luvusta ”Ulkoiset kohteet”.

Lisätietoa Subversion-ominaisuuksista löydät Subversion-kirjan luvusta Special Properties.

Ominaisuuksien lisääminen ja muokkaus

Kuva 4.38. Ominaisuuksien lisääminen

Lisätäksesi uuden ominaisuuden, napsauta ensin Lisää.... Valitse ominaisuuden nimi valikosta ja syötä tarvittavat tiedot ominaisuuskohtaisesti. Ominaisuuskohtaiset syöttöikkunat on kuvattu tarkemmin luvussa ”Ominaisuuksen muokkaaminen”.

Lisätäksesi ominaisuuden, jolla ei ole omaa erikoisikkunaa, valitse Uusi...-valikon komento Lisäominaisuudet. Valitse sen jälkeen jokin olemassa olevan ominaisuus pudotusvalikosta tai lisää uusi ominaisuus.

Jos haluat lisätä ominaisuuden kerralla useisiin kohteisiin, valitse haluamasi tiedostot/kansiot Resurssienhallinnasta ja anna komento Kontekstivalikko → Ominaisuudet.

Jos haluat soveltaa ominaisuuden palautuvasti jokaiseen tiedostoon ja kansioon nykyisen kansion alapuolella, ruksaa valinta Sovella palautuvasti.

Jos haluat muuttaa olemassa olevaa ominaisuutta, valitse ominaisuus luettelosta ja napsauta Muokkaa....

Jos haluat poistaa olemassa olevan ominaisuuden, valitse ominaisuus listasta ja napsauta Poista.

Ominaisuutta svn:externals voidaan käyttää toisten, samassa tai eri arkistossa olevien projektien kytkemiseksi työkopioon. Lue lisää luvusta ”Ulkoiset kohteet”.

Muokkaa HEAD-version ominaisuuksia

Koska ominaisuudet ovat versioituvia, et voi muokata edellisten versioiden ominaisuuksia. Loki-ikkunan ja arkistoselaimen (pl. HEAD-versio) näyttämät ominaisuudet eivät siten salli muokkaamista.

TortoiseSVN sisältää muutamia ominaisuuksia, joilla on erityismerkitys. Kaikki alkavat etuliitteellä tsvn:

TortoiseSVN osaa integroitua joidenkin vikaseurantatyökalujen kanssa. Integrointi perustuu erityisiin projektiominaisuuksiin, jotka alkavat etuliitteellä bugtraq:. Lue lisää luvusta ”Integrointi vikaseurantaohjelmiin”.

TortoiseSVN osaa myös integroitua joidenkin web-pohjaisten arkistoselainten kanssa. Integrointi perustuu ominaisuuksiin, jotka alkavat etuliitteellä webviewer:. Lue lisää luvusta ”Integrointi web-pohjaisiin arkistoselaimiin”.

Kun lisäät työkopioon uusia alikansioita, TortoiseSVN lisää yläkansion projektiominaisuudet niihin automaattisesti.

Tietyillä ominaisuuksilla sallittujen arvojen joukko tai arvomuoto on rajoitettu. TortoiseSVN käyttää näiden ominaisuuksien muokkaamiseen erityisiä ikkunoita, jotka näyttävät sallitut arvot tai näyttävät ominaisuuden osat.

Ulkoinen sisältö

Kuva 4.44. svn:externals -ominaisuussivu

Ominaisuutta svn:externals voidaan käyttää toisten, samassa tai eri arkistossa olevien projektien kytkemiseksi työkopioon. Lue lisää luvusta ”Ulkoiset kohteet”.

Sinun on määritettävä sen alihakemiston nimi, johon ulkoinen viite noudetaan, sekä ulkoisen viitteen Subversion-paikannin. Voit kytkeä ulkoisen viitteen HEAD-versioon, jolloin työkopioosi lisätään päivityksen yhteydessä automaattisesti ulkoisen viitteen muutokset. Voit myös kytkeä ulkoisen viitteen johonkin kiinteään versionumeroon. Tässä tapauksessa saatat myös haluta antaa saman version ankkuriversioksi, koska jos ulkoinen viite nimetään uudelleen tulevaisuudessa, Subversion ei kykene päivittämään viitettä työkopioosi. Määrittämällä ankkuriversion Subversionille, että ulkoisen viitteen nimeä on etsittävä sellaisena, kun se oli ankkuriversiossa (ankkuriversion oletusarvo on HEAD).

Painike Etsi HEAD-versio noutaa jokaisen ulkoisen viitteen HEAD-version ja näyttää sen oikeanpuolimmaisessa sarakkeessa. Kun HEAD-versio on tiedossa, oikea-napsauta ulkoisen viitteen kohdalla antaa komennon, jolla voit ankkuroida valitut ulkoiset viitteet niiden eksplisiittisiin HEAD-versioihin. Mikäli HEAD-versio ei ole vielä selvillä, oikea-napsauta noutaa sen ensin.

SVN-avainsanat

Kuva 4.45. svn:keywords -ominaisuussivu

Valitse avainsanat, jotka haluat laajentaa tiedostossasi.

Rivinvaihtotyyli

Kuva 4.46. svn:eol-style -ominaisuussivu

Valitse haluamasi rivinlopetustyyli; TortoiseSVN valitsee soveltuvan ominaisuusarvon.

Kytkeytyminen vikaseurantaohjelmiin

Kuva 4.47. tsvn:bugtraq -ominaisuussivu

Lokiviestien koot

Kuva 4.48. Lokiviestien ominaisuussivun koko

Nämä kolme ominaisuutta ohjaavat lokiviestien muotoilua. Ensimmäiset kaksi poistavat OK-painikkeen käytöstä toimitus- ja lukitusikkunoissa, kunnes toimitusviesti on riittävän pitkä. Reuna-asema näyttää sarkainmerkin asetetun sarakeleveyden kohdalla, mikäli projekti käyttää lokiviesteille leveysrajoitusta. Arvon nollaus poistaa ominaisuuden käytöstä.

Projektin kieli

Kuva 4.49. Kielen ominaisuussivu

Valitse lokiviestien tavutuksen tarkastuksessa käytettävä kieli. Tiedostolistauksen valintaa käytetään, kun napsautat hiiren oikealla painikkeella lokiviestipaneelissa ja valitset toiminnon Liitä tiedostoluettelo. Oletusarvoisesti Subversion-tilatiedoissa käytetään asennuskieltä. Kun tämä valinta on asetettu, tilatiedot näytetään aina englanniksi. Tästä on hyötyä projekteille, joiden lokiviestien on oltava aina englanninkielisiä.

MIME-tyyppi

Kuva 4.50. svn:mime-type -ominaisuussivu

svn:needs-lock

Kuva 4.51. svn:needs-lock -ominaisuussivu

Tämä ominaisuus määrittää, asetetaanko tiedosto arkistosta noudettaessa 'vain luku'-tilaan, vaikka sillä ei olisi lukkoa.

svn:executable

Kuva 4.52. svn:executable -ominaisuussivu

Tämä ominaisuus määrittää, merkitäänkö tiedosto arkistosta noudettaessa suoritettavaksi (vain Linux/unix). Ominaisuus ei tee mitään Windows-ympäristössä.

Yhdistä lokiviestikaavaimet

Aina, kun versioita yhdistetään työkopioon, TortoiseSVN luo lokiviestin kaikista yhdistetyistä versioista. Nämä ovat saatavilla painikkeen Viimeaikaiset viestit avulla toimitusikkunassa.

Voit mukauttaa luodun viestin seuraavien ominaisuuksien avulla:

Kuva 4.53. Ominaisuusikkuna yhdistä lokiviestikaavaimet

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

Tämä ominaisuus määrittää ensimmäisen osan luodusta lokiviestistä. Voit käyttää seuraavia avainsanoja:

{revisions}

Pilkuin erotettu lista yhdistettyjä versioita, esim. 3, 5, 6, 7

{revisionsr}

Kuten {versiot}, mutta kukin versio prefiksoituna merkillä r, esim. r3, r5, r6, r7

{revrange}

Pilkuilla erotettu lista yhdistettyjä versioita ryhmiteltyinä osaväleihin, esim. 3, 5-7

{mergeurl}

Yhdistämisen lähdepaikannin, ts. paikka, josta yhdistettävät versiot tulevat.

Tämän merkkijonon oletusarvo on Yhdistetty versio(t) {versioväli} paikasta {yhdistämispaikannin}:

tsvn:mergelogtemplatemsg

Tämä ominaisuus määrittää, miltä kunkin yhdistetyn version tekstin tulisi näyttää. Voit käyttää seuraavia avainsanoja:

{msg}

Yhdistetyn version lokiviesti sellaisenaan.

{msgoneline}

Kuten {msg}, mutta rivinvaihdot korvattuina välilyönnein, jotta koko lokiviesti näkyy yhdellä rivillä.

{author}

Yhdistetyn version tekijä.

{rev}

Itse yhdistetty versio.

{bugids}

Yhdistetyn version vikatunnukset, mikäli niitä on.

tsvn:mergelogtemplatemsgtitlebottom

Tämä ominaisuus määrittää tsvn:mergelogtemplatetitle tai tsvn:mergelogtemplatereversetitle -asetuksella määritellyn otsikon paikan. Jos ominaisuuden arvona on yes tai true, otsikko lisätään alaosaan, muuten yläosaan.

Tärkeää

Tämä toimii vain, jos yhdistetyt versiot ovat jo lokivälimuistissa. Jos olet kytkenyt lokivälimuistin pois päältä, tai lokia ei ole katsottu ennen yhdistämistä, luotu viesti ei sisällä tietoa yhdistetyistä versioista.

Oletetaan, että haet työkopion projkektista /project1 kansioon D:\dev\project1. Valitse kansio D:\dev\project1 ja valitse hiiren oikealla näppäimellä komento Windows-valikko → Ominaisuudet. Ominaisuusikkuna aukeaa. Siirry Subversion-välilehteen, jossa voit asettaa ominausuudet. Napsauta Ominaisuudet.... Esiin aukeavassa ikkunassa voit kaksoisnapsauttaa svn:externals-valintaa, jios sellainen on, tai lisätä uuden valitsemalla valikosta Uusi... ja externals.

Jos haluat sisällyttää paikalliseen polkuun välilyöntejä tai muita erikoismerkkejä, voit joko ympäröidä sen lainausmerkein tai käyttää kenoviivamerkkiä \ erikoismerkkien edellä. Jälkimmäinen tarkoittaa tietysti myös sitä, että polkuerottimena on käytettävä jakoviivamerkkiä /. Huomaa, että tämä toiminnallisuus on käytössä versiosta 1.6 alkaen.

Jos ulkoinen projekti on samassa arkistossa, kaikki siihen tehdyt muutokset sisältyvät toimituslistaan toimittaessasi pääprojektin muutoksia arkistoon.

Jos ulkoinen projekti on eri arkistossa, siihen tekemistäsi muutoksista näytetään tai ilmoitetaan toimittaessasi pääprojektin muutoksia arkistoon. Joudut kuitenkin toimittamaan ulkoiset muutokset erikseen.

Jos käytät absoluuttisia paikantimia svn:externals -määrityksissä ja joudut sijoittamaan työkopiosi uudelleen (ts. jos arkistosi paikannin muuttuu), niin ulkoiset viitteet eivät päivity eivätkä siis ehkä enää toimi oikein.

Tällaisten ongelmien välttämiseksi Subversion (ja siis myös TortoiseSVN) tukee versiosta 1.5 alkaen suhteellisia paikantimia ulkoisissa viitteissä. Suhteellisen paikantimen voi antaa neljällä eri tavalla. Seuraavissa esimerkeissä oletetaan, että käytössä on kaksi arkistoa, http://example.com/svn/repos-1 ja http://example.com/svn/repos-2. Paikantimesta http://example.com/svn/repos-1/project/trunk on noudettu työkopio kansioon C:\Working ja ominaisuus svn:externals on asetettu kansiolle trunk.

Voit myös tarvittaessa määrittää ankkuri- ja operatiivisen version paikantimelle. Lue lisää näistä tavoista Subversion-kirjasta.

Lisätietoa TortoiseSVN:n ominaisuuksien käsittelystä löytyy luvusta ”Projektiasetukset”.

Eri tavoista viitata yhteisiin aliprojekteihin löytyy tietoa luvusta ”Sisällytä projektiin yhteinen aliprojekti”.

Versiosta 1.6 alkaen voit lisätä ulkoisia viittauksia yksittäisiin tiedostoihin työkopiossasi samaan tapaan kuin ulkoisten kansioiden yhteydessä. Tähän liittyy kuitenkin muutamia rajoituksia.

Ulkoinen tiedosto käyttäytyy useimmiten normaalin versioidun tiedoston tavoin, mutta niitä ei voi siirtää tai poistaa tavanomaisilla komennoilla vaan muokkaamalla svn:externals-ominaisuutta.

Jos sinulla on jo työkopio tiedostoista tai kansioista, jotka haluat lisätä toiseen työkopioon ulkoisena viitteenä, voit yksinkertaisesti raahata ne kohdetyökopioon Resurssienhallinnan avulla.

Oikea-raahaa tiedosto tai kansio työkopiosta siihen työkopioon, johon haluat lisätä sen ulkoisena viitteenä. Vapauttaessasi hiiren näppäimen esiin aukeaa kontekstivalikko SVN Lisää ulkoinen viite tähän. Jos valitset komennon, tarvittava svn:externals -ominaisuus lisätään automaattisesti. Tämän jälkeen riittää toimittaa ominaisuusmuutokset arkistoon ja päivittää työkopio.

Jos olet tuonut projektisi arkistoon käyttäen suositeltua hakemistorakennetta, haaran tai merkityn version tekeminen on yksinkertaista:

Kuva 4.54. Haara / merkitty versio -ikkuna

Valitse työkopiostasi se kansio, jonka haluat kopioda haaraan tai merkitä ja valitse sitten komento TortoiseSVN → Luo haara / merkitty versio....

Uuden haaran oletusarvoinen kohde on sama kuin se, mistä työkopio on noudettu. Joudut siis muokkaamaan kohdepaikantimen haluamaksesi. Niinpä alkuperäinen paikannin

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

muuttuisi esim. muotoon

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

Jos et muista edellisellä kerralla käyttämääsi nimeämistapaa, napsauta oikealla olevaa "..."-näppäintä, joka avaa arkistoselaimen, jolla voit tutkia arkiston nykyistä rakennetta.

Nyt on valittava, mistä kopio tehdään. Subversion tarjoaa kolme vaihtoehtoa:

Jos haluat työkopiosi vaihtuvan osoittamaan uuteen haaraan automaattisesti, ruksaa valinta Vaihda työkopio uuteen haaraan / merkittyyn versioon. Mutta ennen kuin teet sen, varmista, ettei työkopiossasi ole paikallisia muutoksia. Jos niitä kuitenkin on, ne yhdistetään haaran työkopioon vaihdon yhteydessä.

Jos työkopiossasi on svn:externals-määreellä liitettyjä projekteja, ne luetellaan haaraudu/luo merkitty versio -ikkunan alaosassa. Kullekin ulkoiselle viitteelle näytetään kohdepolku ja lähdepaikannin.

Jos haluat varmistaa, että uusi merkitty versio on aina yksikäsitteinen, tarkista, että sen sisältämien ulkoisten viittausten versiot ovat kiinnitettyjä. Jos ulkoinen viite osoittaa HEAD-versioon, se voi muuttua tulevaisuudessa, minkä seurauksena merkityn version hakeminen palauttaa muuttuneen HEAD-version, eikä projekti esimerksi käänny enää. Tästä syystä viitteet kannattaa aina kiinnittää versioon merkintää luotaessa.

Ulkoiset viitteet kiinnitetään automaattisesti joko nykyiseen HEAD-versioon tai työkopion BASE-versioon riippuen haaran/merkityn version alkuperästä:

Napsauta OK toimittaaksesi uuden kopion arkistoon. Älä unohda kirjoittaa lokiviestiä. Huomaa, että kopio luodaan arkistossa.

Huomaa, että mikäli et pyytänyt työkopion vaihtamista osoittamaan uuteen haaraan, niin haaran tai merkityn version luonti ei vaikuta työkopioosi. Vaikka loisit haaran muuttuneesta työkopiostasi, voi työkopiosi luonnin jälkeen yhä olla muuttunut suhteessa päähaaraan, koska muutokset toimitetaan uuteen haaraan, ei päähaaraan (jonne haara osoittaa).

Voit myös luoda haaran tai merkityn version ilman työkopiota. Tämä tapahtuu arkistoselaimessa, missä voit raahata kansioita uuteen paikkaan. Sinun on pidettävä Ctrl-näppäin painettuna raahattaessa, jotta kansio kopioidaan - muussa tapauksessa se siirretään.

Voit myös raahata kansioita hiiren oikealla näppäimellä. Kun vapautat hiiren painikkeen, voit valita kontekstivalikosta, haluatko siirtää vai kopioida kansion. Haaran tai merkityn version luomiseksi kansio on tietenkin kopioitava, ei siirrettävä.

Vielä yksi tapa haaran luomiseen on käyttää loki-ikkunaa. Voit näyttää lokin esimerkiksi päähaaralle, valita version (joko HEAD-version ylhäältä tai jonkin aiemman version) ja napsauttaa hiiren oikeaa näppäintä sen kohdalla. Esiin aukeavasta kontekstivalikosta löytyy komento Luo versiosta haara / merkitty versio...

...siinä kysymys (ei oikeasti!). Siinä missä työkopion haku noutaa kaiken halutusta arkiston haarasta työkopioosi, komento TortoiseSVN → Vaihda... noutaa työkopioosi vain muuttuneet tiedot. Tämä on hyväksi verkon kuormitukselle ja siten myös hermoillesi :-).

On useita tapoja ottaa käyttöön juuri luomasi haara tai merkitty versio. Voit:

Kuva 4.55. Vaihtoikkuna

Vaikka Subversion ei itse tee eroa merkittyjen versioiden ja haarojen välillä (ne ovat molemmat polkukopiota), niiden käyttötapa on tavallisesti erilainen.

Kuva 4.56. Ohjattu yhdistäminen - versioväli

Syötä Mistä:-kenttään sen haaran tai merkityn version paikannin, jossa työkopioon yhdistettävät versiot sijaitsevat. Voit myös napsauttaa ...-näppäintä etsiäksesi haaran arkistoselaimella. Jos olet aiemmin yhdistänyt tästä haarasta, voit valita paikantimen suoraan pudotusvalikosta, joka sisältää aiemmin käytetyt paikantimet.

Jos yhdistät uudelleen nimetystä tai poistetusta haarasta, joudut siirtymään takaisin sellaiseen versioon, jossa haara oli vielä olemassa. Tämä versio on kiinnitettävä ankkuriversioksi yhdistettävään versioväliin (ks. alla), muuten yhdistäminen epäonnistuu, koska HEAD ei sisällä ko. polkua.

Syötä Yhdistettävä versioväli -kenttään luettelo yhdistettävistä versioista. Lista voi olla yksittäinen versio, joukko pilkuin erotettuja versioita, väliviivalla erotettu versioväli tai joku näiden yhdistelmä.

Mikäli joudut määrittämään yhdistämistä varten ankkuriversion, lisää se versioiden jälkeen, esim. 5-7,10@3. Tässä esimerkissä yhdistetään versiot 5, 6, 7 ja 10 ankkuriversiolla 3.

Helpoin tapa valita yhdistettävä versioväli on napsauttaa Näytä loki -painiketta, jolloin saat näkyviin viimeisimmät muutokset lokiviesteineen. Jos haluat yhdistää muutokset yhdestä versiosta, riittää kun valitset sen. Jos haluat yhdistää muutokset useista versioista, valitse halutut versiot (käyttäen Shift-näppäintä apuna). Napsauta OK, ja luettelo yhdistettävistä versionumeroista täytetään puolestasi.

Jos haluat käyttää yhdistämistä poistamaan aiemmin toimitettuja muutoksia työkopiostasi, valitse poistettavat versiot ja varmista, että valinta Käänteinen yhdistäminen on asetettu.

Jos olet jo aiemmin yhdistänyt muita muutoksia tästä haarasta, olet toivottavasti kirjannut lokiviestiin tiedon viimeisestä yhdistetystä versiosta, kun toimitit muutokset arkistoon. Siinä tapauksessa voit käyttää työkopiosi Näytä loki -komentoa etsiäksesi tuon lokiviestin. Koska TortoiseSVN käyttää muutosjoukkoja versiovälien kuvaamiseen, sinun tulee käyttää edellisen yhdistämisen loppupistettä seuraavaa versiota alkupisteenä uudelle yhdistämiselle. Jos esimerkiksi yhdistit viimeksi versiot 37-39, niin uuden yhdistämisen aloitusversion tulisi olla 40.

Jos hyödynnät Subversionin yhdistämisjäljitysominaisuuksia, sinun ei tarvitse muistaa, mitä versioita on aiemmin yhdistetty - Subversion pitää niistä kirjaa puolestasi. Jos jätät versiovälin tyhjäksi, mukaan sisällytetään kaikki aiemmin yhdistämättömät versiot. Lue luvusta ”Tehtyjen yhdistämisten jäljitys” lisää asiasta.

Kun yhdistämisjäljitys on käytössä, loki-ikkuna näyttää harmaannutettuna sekä aiemmin yhdistetyt versiot että ne versiot, jotka edeltävät yhteistä haarautumispistettä (esim. haaran kopiointi). Valinta Piilota versiot, joita ei voi yhdistää sallii tällaisten versioiden suodattamisen pois, jolloin näet vain versiot, jotka voidaan yhdistää.

Jos on mahdollista, että muut ihmiset toimittavat muutoksia arkistoon, niin ole varovainen käyttäessäsi HEAD-versiota. Se saattaa viitata uudempaan versioon kuin luulet (näin käy, jos joku muu on ehtinyt toimittaa muutoksia arkistoon viimeisimmän päivityksesi jälkeen).

Jos jätät versiovälin tyhjäksi tai valitset kaikki versiot, Subversion yhdistää kaikki vielä yhdistämättömät versiot. Tämä tunnetaan nimillä takaisin yhdistäminen tai automaattinen yhdistäminen.

Muutosten yhdistäminen takaisin (engl. reintegrate) voidaan tehdä vain seuraavien ehtojen täyttyessä: Ensinnäkin palvelimen on tuettava tehtyjen yhdistämisten jäljitystä. Työkopion syvyyden on oltava täysin palautuva (ei osittainen); siinä ei saa myöskään olla paikallisia muutoksia, vaihdettuja hakemistoja tai hakemistoja, jotka eivät ole versiossa HEAD. Kaikkien päähaaran muutosten, jotka on tehty kehityshaaran olemassaolon aikana, on oltava yhdistettyjä (tai merkitty yhdistetyiksi) kehityshaaraan. Yhdistettävä versioväli lasketaan automaattisesti.

NapsautaSeuraava ja siirry lukuun ”Yhdistämisvalinnat”.

Kuva 4.57. Ohjattu yhdistäminen - puut

Jos käytät tätä menetelmää yhdistääksesi kehityshaaran takaisin päähaaraan, sinun on käynnistettävä yhdistämistoiminto päähaaran työkopiosta.

Mistä:-kenttään syötetään päähaaran paikannin. Tämä voi kuulostaa väärältä, mutta muista, että päähaara on alkupiste, johon haluat lisätä kehityshaaran muutokset. Voit myös napsauttaa ...-painiketta selataksesi arkistoa.

Syötä kenttään Mihin: kehityshaaran paikannin.

Syötä kenttiin Mistä: Versio ja Mihin: Versio viimeisin versionumero, jossa kaksi puuta viimeksi synkronoitiin. Jos olet varma, että kukaan muu ei ole toimittamassa tiedostoja arkistoon, voit käyttää molemmissa tapauksissa uusinta (HEAD)-versiota. Jos on mahdollista, että joku muu on voinut samaan aikaan tehdä arkistotoimituksia synkronoinnin jälkeen, käytä tarkkaa versionumeroa välttääkssesi viimeaikaisten toimitusten menetyksen.

Voit myös käyttää komentoa Näytä loki valitaksesi version.

Tällä sivulla voit määritellä lisäasetuksia ennen yhdistämisen aloitusta. Useimmiten oletusasetuksia ei ole tarpeen muuttaa.

Voit myös määrittää yhdistämissyvyyden, ts. kuinka syvälle työkopioosi yhdistäminen etenee. Syvyyskäsitteet on kuvattu luvussa ”Työkopion haun syvyys”. Oletussyvyys on Työkopio, joka käyttää nykyistä työkopion syvyyttä. Tämä on miltei aina oikea valinta.

Useimmiten yhdistäminen kannattaa suorittaa ottamalla tiedoston historia huomioon siten, että yhdistettävuksi valitaan muutokset suhteessa yhteiseen edeltäjään. Joskus kuitenkin voi olla tarpeen yhdistää tiedostoja, jotka ovat suhteessa toisiinsa, mutta joilla ei ole yhteistä versiohistoriaa arkistossa. Olet esimerkiksi saattanut tuoda jonkun kirjaston versiot 1 ja 2 kahteen eri hakemistoon. Vaikka ne ovat loogisesti suhteessa keskenään, Subversion ei tiedä sitä, koska se näkee vain tuomasi tiedostot. Jos yrität yhdistää nämä puut, havaitset, että ensin kaikki tiedostot poistetaan ja sitten lisätään uudestaan. Ohjataksesi Subversionin käyttämään polkuihin perustuvia eroja historiaan pohjautuvien erojen sijaan, ruksaa valinta Ohita edeltäjät. Tästä aiheesta löydät lisätietoa Subversion-kirjan luvusta Noticing or Ignoring Ancestry.

Voit määrittää, millä tapaa rivinloppu- ja tyhjämerkkejä käsitellään yhdistettäessä. Nämä valinnat on kuvattu luvussa ”Rivinlopetin- ja tyhjämerkkiasetukset”. Oletusarvoisesti erot rivinloppu- ja tyhjämerkeissä ovat todellisia yhdistettäviä muutoksia.

Valinta Pakotettu yhdistäminen estää puuristiriidan, joka syntyy, kun yhdistettävä poisto koskee tiedostoa, jossa on paikallisia muutoksia tai jota ei ole versioitu ollenkaan. Tiedoston poistoa ei ole mahdollista perua, mistä syystä valinta ei ole oletusarvoisesti päällä.

Jos yhdistämisjäljitys on käytössä ja haluat merkitä version yhdistetyksi ilman, että oikeasti teet sen, ruksaa valinta Pelkkä yhdistämistietojen päivitys. Saatat haluta tätä ainakin kahdesta eri syystä: yhdistäminen voi olla liian mutkikas, joten päätät yhdistää muutokset käsin ja tehdä yhdistämisjäljityksen tietoiseksi tästä. Toisaalta voit haluta estää tietyn version yhdistämisen - sen merkitseminen yhdistetyksi estää version ottamisen mukaan yhdistämiseen yhdistämisjäljitystä tukevissa asiakasohjelmissa.

Nyt kaikki on valmista ja voit napsauttaa Yhdistä-painiketta aloittaaksesi. Jos haluat esikatsella yhdistämisen tekemiä muutoksia, painike Testaa suorittaa yhdistämisen, mutta ei muuta työkopiotasi. Se näyttää luettelon tiedostoista, jotka muuttuvat, kun varsinainen yhdistäminen tehdään, ilmoittaen myös mahdollisista ristiriidoista, joita saattaa syntyä. Koska yhdistämisten jäljitys monimutkaistaa asioita, ei ole täysin varmaa tapaa tietää ennalta, voidaanko yhdistäminen viedä päätökseen ilman ristiriitoja. Tästä syystä testiyhdistämisen ristiriitaisiksi ilmoittamat tiedostot saattavat itse asiassa yhdistyä ongelmitta.

Yhdistämisen etenemisikkuna näyttää kunkin yhdistämisen vaiheen ja siihen liittyvät versiovälit. Tällöin voit joskus nähdä yhden odottamattoman ylimääräisen version: jos esimerkiksi yhdistit version 123, edistymisikkuna kertoo ” Yhdistetään versiot 122 - 123 ”. Tämän ymmärtääksesi sinun on muistettava, että yhdistäminen on läheisessä suhteessa vertailuun. Yhdistäminen toimii tuottamalla luettelon eroista kahden arkistokohdan välillä ja sovittaa ne työkopioosi. Edistymisikkuna näyttää vertailun alku- ja loppukohdat.

Yhdistäminen on nyt valmis. Kannattaa tutkia tuloksia ja varmistua, että ne vastaavat odotuksia. Yhdistäminen on yleensä varsin monimutkaista. Ristiriitoja syntyy usein, kun kehityshaara on ajautunut kauas päähaarasta.

Versiota 1.5 aiemmat Subversion-asiakkaat ja palvelimet eivät talleta tietoa tehdyistä yhdistämisistä, vaan niistä on pidettävä kirjaa käsin. Kun olet testannut muutokset ja toimitat ne arkistoon, lokiviestisi tulisi aina sisältää ne versionumerot, jotka yhdistettiin. Jos haluat myöhemmin suorittaa toisen yhdistämisen, sinun on tiedettävä mitä olet jo yhdistänyt, koska samaa versiota ei voi ilman ristiriitoja yhdistää kahdesti. Lisää yksityiskohtia yhdistämisestä löydät Subversion-kirjan luvusta Best Practices for Merging.

Jos palvelimesi ja kaikki asiakasohjelmat käyttävät vähintään Subversion-versiota 1.5, tehdyt yhdistämiset muistetaan automaattisesti eikä niitä tehdä useammin kuin kerran. Tämä helpottaa yhdistämistä huomattavasti, koska voit joka kerta yksinkertaisesti valita kaikki versiot yhdistettäväksi ja antaa järjestelmän huolehtia lopusta.

Haaran ylläpito on tärkeää. Jos haluat pitää haaran ajan tasalla päähaaraan nähden, sinun kannattaa yhdistää usein, jotta haara ja päähaara eivät ajaudu liian kauas toisistaan. Tietenkin samalla pitää välttää muutosten yhdistämistä useaan kertaan, kuten edellä on kuvattu.

Subversion 1.5 lisäsi tuen ja työkaluja tehtyjen yhdistämisten jäljittämiselle. Kun yhdistät muutoksia hakemistopuusta toiseen, yhdistetyt versionumero talletetaan, ja tät tietoa voidaan käyttää useisiin eri tarkoituksiin.

Tieto tehdyistä yhdistämisistä talletetaan svn:mergeinfo-ominaisuuteen Subversion-asiakkaan toimesta yhdistämisen aikana. Kun yhdistämisen tulos toimitetaan arkistoon, palvelin tallettaa tiedot tietokantaan, ja kykenee myöhemmin antamaan yhdistämiseen liittyviä tietoja loki-, tekijän selvitys tai yhdistämispyyntöjen yhteydessä. Jotta järjestelmä toimisi kunnolla, on sekä palvelin että kaikki asiakasohjelmat päivitettävä. Vanhemmat asiakasohjelmat eivät talleta svn:mergeinfo-ominaisuutta, ja vanhemmat palvelimet eivät kykene vastaamaan uudempien asiakasohjelmien kyselyihin.

Lisätietoa tehtyjen yhdistämisten jäljittämisestä löydät dokumentista Merge tracking documentation.

Yhdistäminen ei aina suju kitkattomasti. Joskus syntyy ristiriita. Näissä tilanteissa TortoiseSVN avaa yhdistämisristiriitojen ratkontaikkunan.

Kuva 4.58. Yhdistämisristiriitojen ratkontaikkuna

On todennäköistä, että osa muutoksista yhdistyy ongelmitta, kun taas jotkut ovat ristiriidassa arkistoon jo toimitettujen muutosten kanssa. Kaikki yhdistettävissä olevat muutokset yhdistetään. Yhdistämisristiriitaikkuna tarjoaa eri tapoja käsitellä ristiriitaisia rivejä.

Yksinkertaiset ristiriidat, jotka johtuvat muutoksista tiedoston sisältöön tai sen ominaisuuksiin, voidaan ratkaista painikkeilla, joilla valitaan säilytettävät ja hylättävät osat.

Mikäli kyseessä on puuristiriita, lue ensin kappale ”Puuristiriidat”, joka kuvaa puuristiriitojen alalajit ja esiintymissyyt.

Yhdistämisen jälkeen tapahtuva puuristiriitojen ratkaisu tehdään puuristiriitaikkunassa, jossa on useita vaihtoehtoja ristiriidan ratkaisemiseksi:

Kuva 4.59. Puuyhdistämisristiriitojen ratkontaikkuna

Vaihtoehdot riippuvat puuristiriidan tyypistä ja sisältävät selventävän kuvauksen toiminnasta. Jos et ole varma, voit keskeyttää yhdistämisen tai käyttää Lykkää-painiketta ratkaistaksesi ristiriidan myöhemmin.

Kun kehität uutta ominaisuutta erillisessä haarassa, on syytä harkita jo etukäteen tapa, jolla muutokset yhdistetään takaisin päähaaraan, kun ominaisuus on valmis. Jos päähaarassa on samaan aikaan meneillään muuta kehitystyötä, huomaat, että erot kasvavat ajan mittaan merkittäviksi, ja takaisin yhdistäminen muuttuu painajaiseksi.

Jos ominaisuus on suhteellisen yksinkertainen ja sen toteuttaminen ei vie pitkään, voit käyttää yksinkertaista menetelmää, jossa kehityshaara pidetään täysin erillisenä päähaarasta valmistumiseensa asti. Tämän jälkeen se yhdistetään takaisin päähaaraan käyttäen yhdistämisvalintaa Yhdistä versioväli; versioväli koostuu kehityshaaran alku- ja loppuversioista.

Jos ominaisuuden kehittäminen vie pitkään, ja joudut sen aikana ottamaan huomioon päähaarassa tapahtuvia muutoksia, joudut pitämään haarat synkronoituina. Tämä tarkoittaa yksinkertaisesti sitä, että yhdistät aika ajoin päähaaran muutokset kehityshaaraan, jolloin kehityshaara sisältää päähaaran muutokset sekä uuden ominaisuuden. Synkronointiin käytetään yhdistämisvalintaa Yhdistä versioväli. Kun ominaisuus on valmis, voit yhdistää sen takaisin päähaaraan joko komennolla Yhdistä haara takaisin tai Yhdistä kaksi eri puuta.

Toinen (nopea) tapa yhdistää kaikki muutokset päähaarasta kehityshaaraan on käyttää laajennetun kontekstivalikon komentoa TortoiseSVN → Yhdistä kaikki... (pidä Shift-näppäin painettuna avatessasi valikon).

Kuva 4.60. Yhdistä kaikki -ikkuna

Tämä ikkuna on helppo täyttää. Riittää, kun asetat yhdistämisasetukset kappaleen ”Yhdistämisvalinnat” mukaisesti. TortoiseSVN huolehtii lopusta automaattisesti käyttäen hyväkseen tietoa aiemmin tehdyistä yhdistämisistä.

Oletusarvoisesti mitään ei lukita ja kaikki kehittäjät, joilla on toimitusoikeudet arkistoon, voivat toimittaa muutoksia tiedostoihin milloin tahansa. Muut kehittäjät päivittävät työkopionsa aika ajoin, ja arkiston mahdolliset muutokset yhdistetään paikallisten muutosten kanssa.

Kun lukitset tiedoston, vain sinä voit toimittaa siihen muutoksia arkistossa. Muitten kehittäjien toimitukset estetään kunnes vapautat lukon. Lukittua tiedostoa ei voi muuttaa arkistossa, joten sitä ei voida esim. poistaa tai nimetä uudelleen, paitsi lukon omistajan toimesta.

Muut kehittäjät eivät kuitenkaan välttämättä tiedä, että olet lukinnut tiedoston. Jolleivät he tarkista lukitustilannetta säännöllisesti, tilanne valkenee heille ensimmäisen kerran, kun toimitus arkistoon epäonnistuu. Tämä ei ole useimmiten kovin hyödyllistä. Jotta lukkojen hallinta olisi helpompaa, Subversion tukee erityistä svn:needs-lock -ominaisuutta. Kun tämä ominaisuus on asetettu jollekin tiedostolle (mihin tahansa arvoon), paikallinen työkopio kirjoitussuojataan aina työkopion haun tai päivityksen yhteydessä ellei tiedosto ole jo lukittu ko. työkopiossa. Tämä toimii varoituksena, että tiedostoa ei tulisi muokata, ellei sitä ole ensin lukittu. Kirjoitussuojatuilla, versioiduilla tiedostoilla on TortoiseSVN:ssä erityinen kuvakepäällys, joka myös viestittää, että tiedosto on lukittava ennen muokkaamista.

Lukot ovat kehittäjä- ja työkopiokohtaisia. Jos sinulla on useita työkopioita (esim. kotona, töissä), voit lukita yksittäisen tiedoston vain yhdessä työkopiossa.

Mikä neuvoksi, jos työtoverisi lukitsee tiedoston ja lähtee sitten esim. lomalle vapauttamatta sitä? Subversionissa on työkalut lukon pakotettuun vapauttamiseen. Jonkun toisen lukitseman tiedoston lukituksen purkua kutsutaan lukon rikkomiseksi. Jonkun toisen lukitseman tiedoston lukitusta itselle kutsutaan lukon varastamiseksi. Näitä toimenpiteitä ei tietenkään pidä tehdä kevyin perustein, mikäli haluat pysyä väleissä työtoveriesi kanssa.

Tiedot lukoista säilytetään palvelimella, ja lukkotunniste luodaan paikallisessa työkopiossa. Ongelmatilanteissa, esim. jos joku on rikkonut lukon, paikallinen lukkotunniste vanhenee. Arkistossa on aina viime kädessä tieto lukituksista.

Valitse työkopiostasi tiedostot, jotka haluat lukita ja anna sitten komento TortoiseSVN → Lukitse...

Kuva 4.61. Lukitusikkuna

Voit syöttää esiin aukeavaan ikkunaan lukitussyyn, jotta muut näkevät, miksi lukitsit tiedoston. Lukitussyy on vapaaehtoinen ja nykyisin käytössä vain Svnserve-pohjaisissa arkistoissa. Jos (ja vain jos) joudut ottamaan lukon joltakin toiselta kehittäjältä, ruksaa valinta Varasta lukko ja napsauta sitten OK.

Voit asettaa projektiominaisuuden tsvn:logtemplatelock asettaaksesi oletusarvoisen lukitusviestin. Katso ”Projektiasetukset” saadaksesi lisätietoa ominaisuuksien asettamisesta.

Jos suoritat komennon TortoiseSVN → Lukitse... kansiolle, lukitusikkuna listaa kaikki tiedostot kaikissa alikansioissa ja valitsee ne lukittaviksi. Jos todella haluat lukita koko tiedostohierarkian, niin tämä komento on sitä varten. Kannattaa kuitenkin olla varovainen tämän komennon käytössä, sillä jos lukitset muut kehittäjät ulos koko projektista, et ainakaan saa lisää ystäviä..

Jotta et unohtaisi vapauttaa lukkoja, joita et enää tarvitse, toimitusikkuna valitsee lukitut tiedostot oletusarvoisesti arkistoon toimitettaviksi. Jos jatkat toimitusta, valittujen tiedostojen lukot vapautetaan, vaikkei niitä olisi muutettu. Jos et halua vapauttaa joidenkin tiedostojen lukkoja, voit poistaa niiden valinnan (ellei niitä ole muutettu). Jos haluat säilyttää lukon muuttamallesi tiedostolle, sinun on ruksattava valinta Pidä lukot ennen muutosten toimittamista.

Jos haluat pelkästään vapauttaa lukkoja, valitse haluamasi tiedostot työkopiostasi ja anna komento TortoiseSVN → Vapauta lukko. TortoiseSVN ottaa yhteyden arkistoon ja vapauttaa lukot. Voit käyttää komentoa myös kansioille vapauttaaksesi kaikki lukot palautuvasti.

Kuva 4.62. Tarkista muutokset -ikkuna

Voit käyttää komentoa TortoiseSVN → Tarkista muutokset... nähdäksesi, mitä lukkoja sinulla ja muilla on. Paikalliset lukot luetellaan välittömästi. Tarkistaaksesi muitten lukitukset (ja nähdäksesi, onko mikään lukoistasi rikki tai varastettu) sinun on napsautettava Tarkista arkisto.

Ikkunan kontekstivalikosta löytyvillä komennoilla voit myös muuttaa tiedostojen lukitusta. Voit myös rikkoa ja varastaa muitten lukitsemia tiedostoja.

Kuten edellä on kuvattu, tehokkain tapa käyttää lukitusta on asettaa svn:needs-lock -ominaisuus tiedostoille. Katso ohjeet ominaisuuksien asettamiseen luvusta ”Projektiasetukset”. Tiedostot, joilla on tämä ominaisuus, ovat aina kirjoitussuojattuja työkopiossasi, ellet ole lukinnut niitä.

TortoiseSVN käyttää erityistä kuvakepäällystä muistuttamaan tästä.

Jos projektissasi on voimassa käytäntö, jonka mukaan tiedostot on lukittava ennen niiden muuttamista, saattaa olla näppärää käyttää Subversionin automaattisia ominaisuuksia asettamaan ominaisuus aina, kun lisäät uusia tiedostoja. Katso lisää aiheesta luvusta ”Automaattiset ominaisuudet”.

Kun luot uuden arkiston, niin Subversion-versiosta 1.2 alkaen arkiston hooks-hakemistoon luodaan neljä komentojonopohjaa. Näitä kutsutaan ennen lukitusta ja lukon vapautusta sekä lukituksen ja lukon vapautuksen jälkeen.

Saattaa olla kannattavaa asentaa palvelimelle sellaiset post-lock ja post-unlock -komentojonot, jotka lähettävät sähköpostia, joka kertoo, mikä tiedosto lukittiin/vapautettiin. Tällöin kaikki kehittäjät saavat tiedon, jos joku lukitsee tiedoston tai vapauttaa lukon. Löydät esimerkin komentojonosta arkistokansiosta hooks/post-lock.tmpl.

Voit käyttää komentojonoja myös estämään lukkojen rikkomisen tai varastamisen, tai kenties sallia ne vain erikseen nimetylle ylläpitäjälle. Tai ehkä haluat lähettää sähköpostia kehittäjälle, jonka lukkoa ollaan rikkomassa tai varastamassa.

Lue lisätietoa luvusta ”Palvelinpään komentojonot”.

Ensin sinun on tehtävä ja testattava muutoksesi. Tämän jälkeen sinun on (komennon TortoiseSVN → Toimita... sijaan) annettava komento TortoiseSVN → Luo paikkatiedosto... muutokset sisältävässä kansiossa, mieluiten työkopion juurikansiossa.

Kuva 4.63. Paikkatiedoston luonti-ikkuna

Nyt voit valita paikkaan sisällytettävät tiedostot samaan tapaan kuin normaalin arkistotoimituksen yhteydessä. Komento tuottaa tiedoston, joka kokoaa yhteen kaikki valitsemiisi tiedostoihin tekemäsi muutokset viimeisen arkistopäivityksen jälkeen.

Tämän ikkunan sarakkeet voidaan mukauttaa samaan tapaan kuin Tarkista muutokset-ikkunassa. Lue yksityiskohdat luvusta ”Paikallinen ja etätila”.

Painikkeen Asetukset avulla voit määritellä, miten paikkatiedosto luodaan. Voit esimerkiksi jättää rivinvaihto- tai tyhjämerkkien muutokset pois lopullisesta paikkatiedostosta.

Voit tuottaa useita erillisiä paikkatiedostoja, joissa on muutoksia eri tiedostojoukkoihin. Huomaa, että jos luot paikkatiedoston, teet uusia muutoksia samoihin tiedostoihin ja luot uuden paikkatiedoston, niin uusi paikkatiedosto sisältää molemmat muutosjoukot.

Talleta tiedosto valitsemallasi nimellä. Paikkatiedostoilla voi olla haluamasi pääte, mutta ne käyttävät perinteisesti päätteitä .patch tai .diff. Olet nyt valmis toimittamaan paikkatiedostosi.

Voit myös tallettaa paikan leikepöydälle tiedoston sijaan. Saatat haluta tehdä tämän, jotta voit esim. liittää tekstin sähköpostiviestiin muitten katselmoitavaksi. Tai jos sinulla on kaksi työkopiota samalla koneella ja haluat siirtää muutokset työkopiosta toiseen, niin leikepöydän avulla se onnistuu näppärästi.

Jos haluat, voit luoda paikkatiedoston Toimita tai Tarkista muutokset -ikkunoista. Valitse haluamasi tiedostot ja luo paikkatiedosto kontekstivalikon avulla. Mikäli haluat nähdä Asetukset -ikkunan, pidä shift -näppäin painettuna napsauttaessasi hiiren oikeaa näppäintä.

Paikkatiedostot käytetään työkopioon. Tämä tulisi tehdä samalta hakemistotasolta kuin missä paikka luotiin. Jos et ole varma, mikä se on, varmista asia katsomalla paikkatiedoston ensimmäistä riviä. Jos esimerkiksi ensimmäinen käsiteltävä tiedosto oli doc/source/english/chapter1.xml ja paikkatiedoston ensimmäinen rivi on Index: english/chapter1.xml, sinun on käytettävä paikka kansiossa doc/source/. Jos kuitenkin valitset väärän kansiotason (mutta työkopiosi on oikea), TortoiseSVN huomaa sen ja ehdottaa oikeaa hakemistotasoa.

Käyttääksesi paikan työkopioosi tarvitset ainakin lukuoikeuden arkistoon. Tämä siitä syystä, että yhdistämiskomennon on noudettava yhdistämisen pohjaksi versio, jota vastaan paikan tekijä teki muutoksensa.

Valitse kansion kontekstivalikosta komento TortoiseSVN → Käytä paikkatiedosto... Tämä avaa tiedoston avausikkunan, josta voit valita käytettävän paikkatiedoston. Oletusarvoisesti vain .patch ja .diff -päätteiset tiedostot näytetään, mutta voit valita näytettäväksi ”Kaikki tiedostot”. Jos talletit aiemmin paikan leikepöydälle, voit napsauttaa painiketta Avaa leikepöydältä... tiedoston avausikkunassa. Huomaa, että tämä valinta on käytössä vain, jos talletit paikan leikepöydälle käyttämällä komentoa TortoiseSVN → Luo paikkatiedosto.... Paikan kopioiminen leikepöydälle muista sovelluksista ei tuo painiketta näkyville.

Vaihtoehtoisesti, jos paikkatiedoston pääte on .patch tai .diff , voit valita sen kontekstivalikosta komennon TortoiseSVN → Käytä paikkatiedosto... ja valita esiin aukeavasta hakemistoikkunasta sen työkopiosi kansion, johon paikka käytetään.

Kyseessä on vain kaksi tapaa tehdä sama asia. Ensimmäisellä tavalla valitset ensin työkopion ja haet sitten paikkatiedoston. Toisella tavalla valitset ensin paikkatiedoston ja haet sitten työkopion.

Kun olet valinnut paikkatiedoston ja työkopion, TortoiseMerge käynnistetään yhdistämään paikkatiedoston muutokset työkopioosi. Esiin aukeaa pieni ikkuna, joka luettelee muuttuneet tiedostot. Kaksoisnapsauta tiedostot läpi yksi kerrallaan, katselmoi muutokset ja tallenna yhdistetyt tiedostot.

Paikkatiedosto on nyt käytetty työkopioosi, joten sinun on toimitettava muutokset arkistoon saattaaksesi ne muiden kehittäjien saataville.

Kuva 4.64. Selvitä tekijät -ikkuna

Jos et ole kiinnostunut muutoksista aiemmissa versioissa, voit asettaa alkuversion, mistä tekijöiden selvityksen tulisi alkaa. Aseta se arvoon 1 jos haluat selvittää tekijät jokaiselle versiolle.

Oletusarvoisesti tulostiedosto näytetään TortoiseBlame-ohjelmalla, joka korostaa eri versiot tehdäkseen lukemisesta helpompaa. Jos haluat tulostaa tai muokata tuloksia, ruksaa valinta Käytä tekstieditoria tekijätietojen katsomiseen.

Voit määritellä, miten rivinloppu- ja tyhjämerkkien muutoksia käsitellään. Nämä valinnat on kuvattu luvussa ”Rivinlopetin- ja tyhjämerkkiasetukset”. Oletusarvoisesti kaikkia tyhjä- ja rivinloppumerkkien muutoksia käsitellään todellisina muutoksina, mutta jos haluat ohittaa esim. sisennyskorjaukset ja löytää muutoksen "todellisen" tekijän, voit valita sopivan vaihtoehdon tästä.

Voit myös halutessasi ottaa mukaan yhdistämistiedot, vaikkakin tämä valinta vaikuttaa suorituskykyyn. Kun rivit yhdistetään toisesta lähteestä, tekijätiedot näyttävät, missä versiossa muutos tehtiin alkuperäisessä versiossa, samoin kuin version, jossa se yhdistettiin tähän tiedostoon.

Kun napsautat OK, TortoiseSVN käynistää haun tulostiedoston luomiseksi. Kun tekijöiden selvitys on päättynyt, tulokset kirjoitetaan väliaikaiseen tiedostoon ja pääset tutkimaan niitä.

Kuva 4.65. TortoiseBlame

TortoiseBlame, joka sisältyy TortoiseSVN-pakettiin, tekee tekijätietojen lukemisesta helpompaa. Kun viet hiiren jonkun rivin päälle tekijäsarakkeessa, kaikki saman version rivit korostetaan tummemmalla taustalla. Saman tekijän muissa versioissa muuttamat rivit näytetään puolestaan vaalealla taustalla. Väritys ei välttämättä ole kovin selkeä, jos käytössä ei ole riittävästi värejä (esim. jos näyttösi on 256 värin tilassa).

Jos vasen-napsautat riviä, kaikki saman version rivit korostetaan, ja saman tekijän muissa versioissa muuttamat rivit näytetään vaalealla värillä. Tämä korostus jää päälle, joten voit siirtää hiirtä menettämättä korostuksia. Napsauta versiota uudestaan poistaaksesi korostuksen.

Version kommentit (lokiviesti) näytetään työkaluvihjeessä aina, kun hiiri on tekijäsarakkeen yllä. Jos haluat kopioida version lokiviestin, käytä kontekstivalikkoa, joka aukeaa, kun napsautat hiiren oikealla näppäimellä tekijäsaraketta.

Voit etsiä merkkijonoja tekijätietoraportista komennolla Muokkaa → Etsi.... Voit etsiä versionumeroita, tekijöitä ja itse tiedoston sisältöä. Lokiviestit eivät sisälly hakuun - käytä niistä etsimiseen loki-ikkunaa.

Voit myös siirtyä tietylle riville käyttämällä komentoa Muokkaa → Siirry riville....

Kun hiiri on tekijätietosarakkeiden päällä, saatavilla on kontekstivalikko, joka auttaa versioiden vertailua ja historian tutkimista käyttämällä lähtötietona hiiren aseman perusteella valittua versiota. Komento Kontekstivalikko → Selvitä tekijät edelliselle versiolle luo tekijätietoraportin samalle tiedostolle, mutta käyttäen edellistä versiota ylärajana. Tämä tuottaa tekijätietoraportin tiedoston tilasta juuri ennen kuin katsomaasi riviä viimeksi muutettiin. Komento Kontekstivalikko → Näytä muutokset käynnistää vertailuohjelman, joka näyttää, mitä muutoksia viitatussa versiossa on. Komento Kontekstivalikko → Näytä loki näyttää versiolokin viitatusta versiosta alkaen.

Jos tarvitset esitystavan, jonka avulla helpompi löytää vanhemmat ja uudemmat muutokset, anna komento Näytä → Väritä rivien ikä. Toiminto käyttää värigradientteja näyttäen uudet rivit punaisina ja vanhat sinisinä. Oletusarvoinen värjäys on varsin vaalea, mutta voit muuttaa sitä TortoiseBlame-asetuksista.

Jos käytät yhdistämisten jäljitystä ja pyysit yhdistämistietoja, tekijöiden selvitys näyttää yhdistetyt rivit hieman eri tavalla. Jos rivi on muuttunut toisen polun kautta tulleen yhdistämisen seurauksena, TortoiseBlame versio- ja tekijätiedot alkuperäisen tiedoston viimeisimmälle muutokselle yhdistämisversion sijaan. Tällaiset rivit erottaa siitä, että versio ja tekijä on kursivoitu. Versio, jossa yhdistäminen tapahtui, näytetään työkaluvihjeessä, kun siirrät hiiren sarakkeen päälle. Jos et halua yhdistettyjen rivien näkyvän tällä tavoin, poista valinta Sisällytä yhdistämistiedot tekijöitä selvitettäessä.

Jos haluat nähdä yhdistämiseen liittyvät polut, valitse Näytä → Yhdistämispolut. Valinta näyttää polun, jossa riviä viimeksi muutettiin, jättäen pois yhdistämisestä seuraavat muutokset.

Tekijätiedoissa näkyvä versio ilmaisee viimeisimmän version, jossa rivin sisältö muuttui. Jos tiedosto luotiin kopioimalla toisesta tiedostosta, tekijätiedot näyttävät alkuperäisen tiedoston viimeisimmän muutoksen version, ei siis versiota, jossa kopio tehtiin (kunnes muutat kopioitua tiedostoa). Tämä pätee myös yhdistämistietojen polkuihin. Polku näyttää arkistosijainnin, jossa riviä viimeksi muutettiin,

TortoiseBlame-ohjelman asetuksia voidaan muuttaa komennon TortoiseSVN → Asetukset... TortoiseBlame-sivulla. Katso lisää luvusta ”TortoiseBlame-asetukset”.

Yksi tekijäraportin rajoituksista on se, että se näyttää tiedoston tietyn version ja viimeisimmän henkilön, joka muutti kutakin riviä. Joskus on tarpeen tietää myös, mikä muutos tehtiin. Napsauttamalla hiiren oikeaa näppäintä TortoiseBlamen rivillä voit valita komennon, joka näyttää versiossa tehdyt muutokset. Jos taas haluat nähdä muutokset sekä yhdistämistiedot yhtä aikaa, tarvitset yhdistelmän tiedostojen vertailusta ja tekijäraportista.

Loki-ikkunassa on useita vaihtoehtoja, joiden avulla voit tehdä tämän.

Jokainen versiograafin solmu vastaa sellaista arkistoversiota, jossa jotain muuttui katselemaasi puun suhteen. Erityyppiset solmut erotellaan värin ja muodon perusteella. Muotoa ei voi muuttaa, mutta värit voi asettaa komennolla TortoiseSVN → Asetukset

Huomaa, että oletusarvoisesti graafi näyttää vain paikat, joissa tiedostoja lisättiin, kopioitiin tai poistettiin. Projektin jokaisen version näyttäminen tuottaa hiemankin monimutkaisemmissa tapauksissa hyvin suuren graafin. Jos todella haluat nähdä kaikki versiot, joissa muutoksia tehtiin, niin Näytä-valikossa ja työkalupalkissa on komento sitä varten.

Oletusnäkymä (ryhmitys pois päältä) sijoittaa solmut pystysuunnassa versiojärjestykseen, joten näet suoraan järjestyksen, jossa asiat tehtiin. Kun kaksi solmua sijoittuu samaan sarakkeeseen, järjestys on ilmeinen. Kun kaksi solmua on vierekkäisissä sarakkeissa, välimatka on paljon pienempi, koska solmujen mahdollista päällekkäisyyttä ei tarvitse ottaa huomioon; tämän seurauksena asioiden tekojärjestys ei ole yhtä ilmeinen. Tällaiset optimoinnit ovat tarpeen, jotta monimutkaiset graafit pysyvät siedettävän kokoisina. Huomaa, että järjestäminen käyttää solmun vanhemman puolen reunaa lähtökohtana, ts. solmun alareunaa, kun graafi piirretään vanhin solmu alimmaisena. Lähtökohtainen reuna on merkittävä, koska kaikki solmutyypit eivät ole saman korkuisia.

Koska versiograafi on usein varsin monimutkainen, työkalussa on joukko valintoja, joiden avulla sen voi räätälöidä mieleisekseen. Valinnat löytyvät Näytä-valikosta ja työkalupalkista.

Käytä yleisnäkymäikkunaa helpottamaan suunnistamista suuressa graafissa. Yleisnäkymäikkuna näyttää koko graafin pienessä ikkunassa korostaen parhaillaan näytetyn osan. Voit raahata korostettua osaa vaihtaaksesi näytettyä aluetta.

Version päiväys, tekijä ja kommentit näytetään työkaluvihjeessä aina, kun hiiri viedään versiosolmun päälle.

Kun valitset kaksi versiota (Käytä CTRL-vasen napsautus), voit näyttää kontekstivalikon avulla niiden väliset erot. Voit valita erot näytettäväksi haaran luontipisteissä, mutta yleensä erot kannattaa näyttää haaran loppupisteissä (ts. HEAD-versioissa).

Voit katsella eroja unified diff -muodossa, joka näyttää erot yhtenä tiedostona. Jos päätät kuitenkin suorittaa vertailun komennolla Kontekstivalikko → Vertaa versioita, esiin aukeaa lista muuttuneista tiedostoista. Kaksoisnapsauta tiedoston nimen päällä hakeaksesi sen molemmat versiot ja käynnistääksesi vertailutyökalun.

Jos oikea-napsautat versiota, voit käyttää komentoa Kontekstivalikko → Näytä loki katsellaksesi version historiaa.

Voit myös yhdistää muutokset valituista versioista toiseen työkopioon. Voit valita kansioikkunasta työkopion, johon yhdistäminen tehdään. Tämän jälkeen ei ole enää varmistusta tai mahdollisuutta testiajoon! Kannattaa tehdä yhdistäminen muuttamattomaan työkopioon, jotta voit perua muutokset helposti tarvittaessa! Tämä on hyödyllinen ominaisuus, jos haluat yhdistää valitut versiot haarasta toiseen.

Jos haluat tarkistaa palvelimelta uudet tiedot, voit päivittää näytön helposti painamalla F5. Mikäli käytät lokivälimuistia (oletusarvoisesti päällä), komento tarkistaa arkistosta vain uudet toimitukset ja noutaa muuttuneet. Jos lokivälimuisti on yhteydettömässä tilassa, komento koettaa myös siirtyä takaisin yhteydelliseen tilaan.

Jos käytät lokivälimuistia ja luulet viestin sisällön tai tekijän muuttuneen, sinun kannattaa käyttää loki-ikkunaa tarvitsemiesi viestien päivittämiseen. Koska versiograafi toimii arkiston juuresta käsin, se joutuisi päivittämään koko lokivälimuistin, ja siihen voi mennä hyvin kauan.

Suuressa puussa on hankalaa navigoida, ja joskus on tarpeen piilottaa siitä osia tai jakaa se pienempien puiden metsäksi. Kun viet hiiren solmun ja linkin yhteyskohdan päälle, esiin aukeaa yksi tai useampia painikkeita, joiden avulla voit tehdä tämän.

Napsauta miinusnäppäintä sulkeaksesi kytketyn alipuun.

Napsauta plusnäppäintä avataksesi suljetun puun. Kun puu on suljettu, tämä painike pysyy näkyvillä ilmaisten piilossa olevan alipuun olemassaolon.

Napsauta ristinäppäintä jakaaksesi kytketyn alipuun ja näyttääksesi sen erillisenä puuna graafissa.

Napsauta ympyränäppäintä kytkeäksesi jaetun puun takaisin. Kun puu on jaettu, tämä näppäin säilyy näkyvillä, ilmaisten siten erillisen alipuun olemassaolon.

Napsauta graafin taustaa avataksesi kontekstivalikon, jossa on valinnat Laajenna kaikki ja Yhdistä kaikki. Jos haaroja ei ole suljettu tai jaettu, valikkoa ei näytetä.

Joskus on tarpeen muuttaa työkopio tavalliseksi kansioksi ilman .svn -hakemistoa. Tällöin riittää poistaa kansio .svn työkopion juuresta.

Vaihtoehtoisesti voit viedä kansion itseensä. Oikea-raahaa työkopion juurihakemisto Windows-resurssienhallinnassa tiedostopaneelista itsensä päälle kansiopaneeliin. TortoiseSVN havaitsee tämän erikoistapauksen ja kysyy haluatko tehdä työkopiostasi versioimattoman. Jos vastaat kyllä, kontrollihakemisto poistetaan ja lopputuloksena kansiopuu on versioimaton.

Voit integroida haluamasi vikaseurantatyökalun TortoiseSVN:ään. Tehdäksesi tämän sinun on määriteltävä muutamia ominaisuuksia, jotka kaikki alkavat etuliitteellä bugtraq:. Ne on asetettava kansioille: (”Projektiasetukset”)

Kuva 4.70. Bugtraq-ominaisuusikkuna

Kun muokkaat bugtraq-ominaisuuksia, käytössä on erikoiseditori, jotta sopivien arvojen asetus olisi helpompaa.

On kaksi tapaa integroida TortoiseSVN virheenjäljitysohjelmiin. Toinen perustuu yksinkertaisiin merkkijonoihin, toinen taas säännöllisiin lausekkeisiin. Molemmat tavat jakavat seuraavat asetukset:

Jos molemmat ominaisuudet bugtraq:message ja bugtraq:logregex on asetettu, logregex vie voiton.

Jotkut tsvn:-ominaisuudet tarvitsevat arvon true/false. Tällöin sanaa yes voidaan käyttää synonyyminä arvolle true ja sanaa no synonyyminä arvolle false.

Kun lisäät työkopioon uusia alikansioita, TortoiseSVN lisää yläkansion projektiominaisuudet niihin automaattisesti.

Vikaseurantaa voi käyttää TortoiseSVN:n ohella kaikkien Subversion-pohjaistan ohjelmien kanssa. Katso lisätietoja TortoiseSVN-arkistosta osoitteessa Issue Tracker Integration Specification (”Lisenssi” kertoo, miten arkistoon kytkeydytään.)

Edellinen luku käsitteli vikatietojen lisäämistä lokiviesteihin. Entäpä jos tarvitset tietoja vikaseurantaohjelmasta? Toimitusikkunalla on COM-rajapinta, johon voidaan kytkeä ulkoinen ohjelma, joka keskustelee vikaseurantaohjelmasi kanssa. Saatat esimerkiksi haluta luettelon korjattavaksesi määrätyistä vioista, jotta voit poimia ne, joihin käsillä oleva toimitus liittyy.

Tällainen rajapinta on tietysti tiukasti sidoksissa käyttämääsi vikaseurantajärjestelmään, eikä sitä toimitetan TortoiseSVN:n mukana. Rajapinnan määritys sekä C#/C++ -esimerkkiohjelmia löytyy TortoiseSVN -arkiston contrib -hakemistosta (”Lisenssi” kertoo, miten arkistoon kytkeydytään). Rajapinnan API-yhteenveto löytyy myös osoitteesta Luku 7, IBugtraqProvider-rajapinta. Gurtle on (toimiva) C#-kielellä toteutettu ohjelma, joka toteuttaa Google Code -vikaseurannan vaatiman COM-rajapinnan.

Oletetaan esimerkin vuoksi, että järjestelmänvalvojasi on toimittanut lisäosan vikaseurantaan kytkeytymistä varten. Olet asentanut ohjelman ja kytkenyt työkopiosi käyttämään sitä TortoiseSVN-asetusten kautta. Kun avaat tästä työkopiosta toimitusikkunan, näet uuden painikkeen ikkunan oikeassa ylänurkassa.

Kuva 4.71. Esimerkki vikaseurantaohjelman kyselyikkunasta

Tässä esimerkissä voit valita yhden tai useampia vikoja. Ohjelma voi sitten lisätä muotoillun tekstin lokiviestiisi.