# &cervisia; käsiraamat

## Sissejuhatus

&cervisia; on kasutajasõbralik versioonikontrolli süsteemi kasutajaliides. Selle eesmärk on toetada &CVS;-i ja muid versioonikontrolli süsteemi programme ühtse liidesena, mis võimaldab lahendada konflikte, vaadata erinevusi ja ajalugu, näha töös olevate failide staatust ja üldse kasutada enamikku võimalusi, mida versioonikontrolli süsteemid pakuvad. &cervisia; on võimalik paigaldada kas ise moodulist kdesdk või siis kasutada sinu distributsiooni pakutavat tarkvarapaketti kdesdk. Praegu on süsteemidest toetatud ainult &CVS;, kuid tulevikus on võimalik ka teiste süsteemide tugi.

Versioonikontrolli süsteem pakub võimalust salvestada, hallata ja levitada failide erinevaid versioone. &CVS; on üks selliseid süsteeme. See lubab tehtud muudatusi hõlpsasti teistega jagada, sest iga autor võib oma versiooniga töötada kartmata, et ta kirjutab nii üle teiste muudatused või vastupidi. See süstem lubab taastada varasemaid versioone (mis tuleb kasuks vigade otsimisel), luua harusid (näiteks arendusversiooniga töötamiseks või valmisvariandi väljalaskmiseks) ja veel palju muud.

Peamine hoidla sisaldab tavaliselt mõnda koostööprojekti (olgu siis kommertsprojekt või mitte), kuid &CVS; võimaldab paindlikult ennast ära kasutada ka vaid sinu enda huvides arendatava projekti tarbeks. Väga lihtne on luua kohalik hoidla, kus võid silma peal hoida vigu tekitanud muudatustel, neid tühistada, vältida juhuslikku infokadu &etc;

Kui hoidlas asuvad projektifailid, siis iga autor võib endal hoida oma kohalikku koopiat, mis kannabki nime kohalik koopia või ka liivakast. Samas saab igaüks kanda oma muudatused peahoidlasse (see tegevus kannab nimetust "sissekandmine") ja/või uuendada enda koopiat, et see kajastaks teiste arendajate tehtud muudatusi.

## Alustamine

### Hoidla kasutamine

Selles osas selgitame, kuidas kasutada &cervisia; pakutavaid võimalusi kõige elementaarsemate versioonikontrolli süsteemi võtete jaoks ehk siis moodulite väljavõtmiseks hoidlast ja nendega töötamiseks. Selleks peab sul olema hoidlale ligipääs kliendina, mis tähendab, et keegi (arvatavasti &CVS; hoidla administraator) on sulle eraldanud serveril konto. Teine võimalus on muidugi luua vähese vaevaga oma projekti arendamiseks kohalik hoidla.

Kui kavatsed hakata arendama mõnda suuremat ja keerulisemat projekti, on mõttekas kasutada ära &CVS;-i võimalusi isegi siis, kui oled projekti ainuarendaja. Nii saad teha kohalikku koopiasse kõik vajalikud muudatused ja kasutada &cervisia;t (või ka muid &CVS;-i vahendeid) selle uuendamiseks ja sissekandmiseks. Sel moel saad hoida silma peal vigu põhjustanud muudatustel, neid tühistada, vältida juhuslikku infokadu jne. &cervisia; kasutamisel on kohaliku hoidla loomine äärmiselt lihtne.

#### Kohaliku hoidla loomine

1. Ava dialoog Uue hoidla loomine (cvs init) menüükäsuga Hoidla Loo....

2. Klõpsa nupule ... ja vali kataloog, kuhu soovid hoidla luua, või sisesta selle asukoht tekstikasti. Kui näiteks soovid hoidla luua kataloogi `/home/user` ja anda sellele nimeks `cvsroot`, tuleb tekstikasti kirjutada `/home/user/cvsroot` või valida failivalijat kasutades kataloog `/home/user` ning lisada `cvsroot`.

3. Kui oled valmis, klõpsa nuppu OK. &cervisia; loob nüüd ja initsialiseerib uue hoidla kataloogi.

4. Seejärel võid importida hoidlasse oma senise töö või luua hoidlas kataloog, kus kogu uut moodulit algusest peale arendama hakata.

&cervisia; võimadab dialoogiga Hoidlate seadistamine hallata kõiki hoidlate asukohti. Dialoogi saab avada menüükäsuga Hoidla Hoidlad....

#### &cervisia; hoidlate seadistamise dialoog

&cervisia; hoidlate seadistamise dialoog

CVS-i hoidlat saab kasutada mitme meetodiga: ligipääsu võib tagada parooliga autentimine (:pserver:), turvashell (kasutades :ext:), kohalik hoidla (:kohalik:) &etc; Hoidla asukoha vorming on järgmine (lisavõimalused on toodud ära nurksulgudes):

`[:meetod:][[kasutaja][:parool]@]masinanimi[:[port]]/hoidla/asukoht`

Hoidlale ligipääsuks pole sugugi alati vaja anda kõiki neid elemente (kasutajanime, parooli, masinanime, porti). Nõutav info sõltub kasutatavast ligipääsumeetodist, mille võib kokku võtta nii:

Kohalik

- Kohalik ligipääs on &CVS;-i vaikemeetod. Seepärast ei ole meetodi :local: lisamine hoidla asukohale vajalikki: sisestada võib ka lihtsalt kataloogi asukoha, kus &CVS;-i hoidla asub ja millele arvuti ligi pääseb, kujul `/hoidla/asukoht` või kui tuua näide elust enesest, siis `/home/cvs`.

  Füüsiliselt võib see asuda ka NFS-i vahendusel ühendatud kettal, kuid antud juhul on see ebaoluline. Kui oled loonud kohaliku hoidla, on asukoht lihtsalt tee, mida mööda sellele ligi pääseb.

rsh

- Hoidla asukohaks võib olla näiteks `:ext:kasutajanimi@masin.url.org:/hoidla/asukoht`

  See meetod nõuab, et sul oleks konto serveris (antud juhul siis `masin.url.org`) ja et sa kasutaksid suhtlemiseks kaugshelli. Vaikimisi pruugib &CVS; ↱-d, kuid ↱ on juba ammu tunnistatud ebaturvaliseks ja selle asemele on üldjuhul astunud &ssh;.

  Kui kasutad &ssh;-d, pead keskkonnamuutja `CVS_RSH` määrama `cvs` klienti kasutades &ssh;-le. &cervisia; toetab seda võimalust.

  Arvesta, et &cervisia; ei suuda vastata serveri võimalikule paroolinõudele. Kontrolli, et sisselogimine toimiks ilma parooli nõudmata. Puhta ↱ korral saab seda näiteks teha usaldusväärsete masinate nimekirjaga faili `.rhosts` sinu kodukataloogis luues (vaata täpsemat infot ↱ manuaalileheküljelt).

  &ssh; korral tuleb selleks kopeerida serverile oma avalik võti `identity.pub` (see asub kataloogis `$`HOME`/.ssh/`). Sellisel juhul ei tohi võti olla krüptitud paroolifraasiga (vaata täpsemat infot &ssh; manuaalileheküljelt ja &CVS;/SSH KKK-st SourceForge'is). Kui sa ei ole päris kindel, küsi nõu oma süsteemiadministraatorilt.

pserver

- Hoidla asukohaks võib olla näiteks `:pserver:kasutajanimi@masin.url.org:/hoidla/asukoht`

  See meetod võtab serveriga ühendust erilise suhteliselt nõrga autentimisega protokolli vahendusel (`pserver` tähendabki parooliga autentimist). Enne sellise serveri kasutamist peab sul olema &CVS;-serveri administraatori antud kasutajanimi ja parool ning sa pead end sellele sisse logima. Pane tähele, et sinu &CVS;-serveri autentimisel kasutatav nimi ei pruugi olla sama, mida kasutad enda süsteemi sisselogimisel. Enne &CVS;-serveri kasutamist tuleb sul end sisse logida.

  Vaba tarkvara projektid pakuvad enamasti võimalust ka lähtekoodile ligi pääseda anonüümset CVS-i kasutades. See tähendab, et sul on võimalik ka uusim lähtekood hõlpsasti hankida, seda muuta ning luua ilma CVS-i kontot loomata paigad (erinevused) hoidlas asuvate versioonide suhtes. Reeglina kasutab anonüümne CVS parooliga autentimist (:pserver:) ning on ainult lugemisõigusega, lubamata sul muudatusi vahetult hoidlasse sisse kanda.

Hoidla ligipääsumeetodi ja asukoha määramine järel saab selle lisada &cervisia; hoidlate loendisse:

### Uue hoidla lisamine

1. Ava dialoog Hoidlate seadistamine menüükäsuga Hoidla Hoidlad...

2. Klõpsa nupule Lisa..., mis avab dialoogi Hoidla lisamine.

3. Kirjuta hoidla asukoht tekstikasti Hoidla:. &cervisia; lülitab automaatselt välja dialoogi need osad, mida valitud ligipääsumeetodi korral nagunii kasutada ei saa.

4. Kui kasutad hoidlale ligipääsemisel ext-meetodit, anna tekstikastis Kasutatakse kaugshelli kaugshelli nimi, mida soovid pruukida (⪚ &ssh;).

5. Klõpsa nupule OK ja näedki äsja sisestatud hoidlat hoidlate loendis.

6. Kui sisestatud hoidla kasutamiseks on vaja parooliga autentimist (pserver), tuleb sul enne serveriga ühendumist end sisse logida. Klõpsa loendis hoidlanimel, et see valida, ning siis nupul Logi sisse... Sisesta parool ilmuvasse dialoogi.

   Kui oled parooli edukalt sisestanud, ilmub pserveri hoidla veerus Olek kirje Pole sisse logitud asemele Sisse logitud.

7. Klõpsa muudatuste rakendamiseks nupule OK või kui tahad, jätka hoidlate asukohtade lisamist. &cervisia; suudab salvestada just nii palju asukohti, kui sa talle ette annad.

### Mooduli import hoidlasse

Selles osas vaatame, kuidas uut projekti &CVS; hoidlasse lülitada. Kui soovid kõigest töötada olemasoleva projektiga, mis juba on hoidlas, võid selle osa vahele jätta.

Projekti saab &CVS;-i lülitada kahel viisil:

- Importides failid ja kataloogid &cervisia; importimisdialoogi abil uude moodulisse. Moodulid on &CVS;-i hoidla kataloogipuu tipptaseme kataloogid, millega eristatakse ja korrastatakse erinevaid hoidlas asuvaid tarkvaraprojekte.

- Luues tühja mooduli ja lisades sinna käsitsi uued failid ja kataloogid. See tagab sulle suurema kontrolli, võtab aga usutavasti märksa enam aega.

Arvesta, et &CVS; on algselt loodud tekstifailide tarbeks. Paljud võimalused, näiteks versioonide liitmine, erinevuste näitamine loetaval kujul jne., on kasutatavad ainult tekstifailide puhul. See ei tähenda küll, et CVS-i ei saa kasutada ka binaarfailide jaoks, küll aga seda, et sul tuleb anda CVS-ile täpselt teada, kas tegu on teksti- või binaarfailiga. Kui määrad vale failitüübi, saad peagi aru, et &CVS; ei käitu nendega õigesti ning lõpuks võivad su andmed tugevasti viga saada.

Projekti importimisel (uue moodulina) on teatud eelised: võimalik on importida kõik failid ja kataloogid rekusiivselt ning moodul ise luuakse automaatselt. Nii on ka suurte projektide import hoidlasse üpris hõlpus. Kuid siin on ka mõningad puudujäägid: &cervisia; importimisdialoogi ei saa kasutada failide lisamiseks olemasolevatesse moodulitesse ning faile saab importida kas teksti- või binaarfailidena. Sellest piirangust saab küll mööda hiilida, kui luua kataloog ainult üht tüüpi failidele või anda ette failimustrid, mida importimisel ignoreerida.

Oletame näiteks, et sinu projektis on ainult tekstifailid ja mõned PNG pildid (need on siis binaarfailid). Sa võid lasta &CVS;-il ignoreerida kõik faile mustriga `*.png`, kui impordid ülejäänud failid tekstifailidena, või siis liigutada pildid omaette kataloogi ja importida seejärel ülejäänud failid (tekstifailidena). Nii või teisiti tuleb sul äsja imporditud moodulist kohaliku koopia jaoks väljavõte teha, kopeerida sellesse puuduvad failid ja kataloogid ning need hoidlasse lisada ja sisse kanda. Alles siis on import tegelikult läbi saanud.

Seepärast on teine võimalus lisada failid ja kataloogid käsitsi, luues neile eelnevalt tühja mooduli. Tühja mooduli lisamiseks hoidlasse loo lihtsalt uus kataloog &CVS;-hoidla juurkataloogis. Uue kataloogi nimi on ühtlasi mooduli nimi. Tee uuest moodulist väljavõte. Seejärel kopeeri failid ja kataloogid kohalikku koopiasse ning lisa ja kanna sisse &CVS;-hoidlasse saatmiseks.

#### &cervisia; importimisdialoog

&cervisia; importimisdialoog

screenshot-import näitab dialoogi, mis aitab importida projekti moodulina. &cervisia; importimisdialoogi avamiseks vali menüükäsk Hoidla Impordi...

Hoidla: co-repository

- &CVS; hoidla nimi, tuntud ka kui $`CVSROOT`. Sul peab olema selles kirjutamisõigus ja hoidla peab olema korrektselt initsialiseeritud. Kui hoidlat ei ole veel olemas, loo see menüükäsuga Hoidla Loo...

  Rippmenüüga kastis on näha kõik hoidlad, mille oled varem loendisse sisestanud dialoogiga Hoidlate seadistamine. Kui tegemist on kaughoidlaga, kontrolli, et autentimine töötaks, täpsemat infot annab accessing-repository.

Moodul: co-module

- Mooduli nimi, millega projekt salvestatakse. Pärast importimist saab projektist just selle nimega väljavõtteid teha. Täpsemat infot annab checkingout. See on ka vastava kataloogi nimi hoidlas.

Töökataloog:

- See on imporditava projekti ülemkataloog. Import algab sellest kataloogist ning edeneb rekursiivselt allapoole.

Tootja silt: co-vendortag

- Tootja silti kasutatakse traditsiooniliselt allikate jälgimiseks. Kui sul mingit paremat mõtet ei ole, anna siin oma kasutajanimi. Õigupoolest pole eriti tähtis, mida siin sisestad.

Väljalaske silt: co-releasetag

- Ka seda silti on traditsiooniliselt kasutatud tarkvara erinevate versioonide importimisel. Kui sa sellega ei tegele, kasuta sõna `start` või stringi `SUVA_1_0`, kus `SUVA` on projekti nimi ja `1.0` imporditava väljalaske versiooni number.

Eiratakse faile:

- Selle välja täitmisel antakse käsule `cvs import` täiendavalt võti `-I `failinimed``. Seda kirjet tõlgendatakse tühikutega eraldatud nimekirjana, kus seisavad failide nimed, mida tuleb ignoreerida. Üldiselt on mõttekam ja veakindlam viis kontrollida, millised failid hoidlasse lähevad, luua kataloog ainult nende failidega, mida soovid importida, ja siis sellest kataloogist alustadagi. Siiski võib see võti olla kasulik, kui projektis leidub faile, mida &CVS; vaikimisi eirab, nt. failid nimetusega `core`. Sellisel juhul kirjuta väljale ainult märk `!`. See tühistab &CVS;i eiratavate failide skeemi, täpsemalt vaata ignoredfiles.

Kommentaar: co-comment

- Sellele väljale saab kirjutada kommentaarid, mis sul on imporditavate failide päritolu, kasutamise, arendamise &etc; kohta.

Imporditakse binaarfailidena

- Selle märkimisel imporditakse kõik failid binaarkujul, st. käsule `cvs import` lisatakse võti `-kb`.

Faili muutmise aega kasutatakse importimisajana

- Selle märkimisel märgitakse importimise ajaks failide muutmise aeg, mitte aga importimise aeg ise.

Kui oled väljad täitnud ja klõpsanud nuppu OK, antakse järgmine &CVS; käsk:

    cvs -d hoidla import -m "" moodul tootja_silt väljalaske_silt

### Mooduli väljavõtte tegemine hoidlast

Nüüd, kui oled edukalt määranud hoidla asukoha ja esimesed failid hoidlasse importinud, on aeg &CVS;-hoidla moodulist väljavõte teha ning enda kohalik koopia luua.

Selleks võib olla vajalik teada ka, milline on õige haru või silt

Mooduli harud on selle paralleelsed versioonid. Heaks näiteks nende praktilise kasutamise kohta on tarkvaraprojektide väljalasked. Pärast väljalaset on kahtlemata lähtekoodis vigu, mis ootavad parandamist, kuid samas soovib keegi kindlasti ka mõne hoopis uue võimaluse lisada. Mõlemat korraga on reeglina päris raske saavutada, sest uued võimalused toovad enamasti kaasa uusi vigu ning seeläbi muutub vanade vigade jälgimine keerukamaks. Selle dilemma lahendamiseks lubab &CVS; luua paralleelse versiooni, mida me nimetame "stabiilseks väljalaskeharuks" ja milles parandatakse ainult vigu, samal ajal kui peaharu (HEAD) on avatud ka uute võimaluste lisamisele.

Silte kasutatakse projekti versiooni märkimiseks. &CVS; tähistab iga faili teatud versiooni sildiga, nii et kui teed väljavõtte või uuendad vastavalt konkreetsele sildile, saad alati ühe ja sama failiversiooni. Seepärast ei ole erinevalt harust sildid dünaamilised: sildiga tähistatud faile ei saa õigupoolest arendada. Sildid on kasulikud näiteks väljalaske tähistamiseks, suurte muudatuste puhul lähtetekstis &etc; Siltide abil saab projekti hõlpsasti pöörata tagasi mingisse varasemasse olekusse, et vigu tuvastada, lähtekoodi uuesti genereerida &etc;

#### &cervisia; väljavõtte tegemise dialoog

&cervisia; väljavõtte tegemise dialoog

Hoidla:

- &CVS; hoidla nimi, tuntud ka kui ``$CVSROOT``. Rippmenüüga kastis on näha kõik hoidlad, mille oled varem loendisse sisestanud dialoogiga Hoidlate seadistamine. Kui tegemist on kaughoidlaga, kontrolli, et autentimine töötaks, täpsemat infot annab accessing-repository.

Moodul:

- Moodul, millest soovid väljavõtte teha. Kui töötad olemasoleva hoidlaga, saad nime arvatavasti süsteemiadministraatorilt või kui tegemist on vaba tarkvara hoidlaga, siis projekti veebileheküljelt. Kui soovid luua uue mooduli nullist peale kohalikku hoidlat kasutades, loo lihtsalt uus kataloog kohaliku hoidla juurkataloogis. Kataloogi nimi on sama, mis tühjal moodulil.

  Kui hoidlal on aga olemas fail ``$CVSROOT`/modules`, saab olemasolevate moodulite nimekirja tõmmata klõpsuga nupul Laadi nimekiri.

  Pane tähele, et väljavõtte saab teha ka mooduli mis tahes olemasolevast alamkataloogist ilma ülejäänud moodulit kaasamata. Selleks anna lihtsalt alamkataloogi asukoht. Kui soovid näiteks teha moodulis kdesdk ainult alamkataloogi `doc/cervisia` väljavõtte, kirjutagi sellele väljale `kdesdk/doc/cervisia`.

Haru silt:

- Haru või sildi nimi, mille väljavõtte soovid teha. Kui jätad selle välja tühjaks, teeb &cervisia; väljavõtte peaharust (HEAD).

Töökataloog:

- Kataloog, kuhu mooduli väljavõte salvestatakse. Arvesta, et töövariandi ülemkataloog luuakse alati siin antud kataloogi töövariandiga sama nime kandva alamkataloogina, kui sa ei ole just andnud alternatiivset nime väljal Väljavõtte tegemine kui:.

Väljavõtte tegemine kui:

- Alternatiivne kataloog, kuhu väljavõte teha. Selle tulemusena saab väljavõetavad failid paigutada aktiivses töökataloogis mingi muu nimega kataloogi kui mooduli nimele vastav kataloog.

Ainult eksport

- Selle märkimisel failid eksporditakse, mitte aga ei tehta väljavõtet. Eksportimisel tõmmatakse mooduli koopia ilma CVS-i haldamise kataloogideta. Eksport võib olla mõttekas näiteks lähtekoodi väljalaske ettevalmistamisel.

### Peaaken, faili olek ja uuendamine

&cervisia; käivitamisel ja kohaliku koopia avamisel menüükäsuga Fail Ava liivakast... võid näha &cervisia; peaaknas kaht põhiosa: üleval asub avatud kohaliku koopia hierarhiline puuvaade, all näidatakse &CVS; käske, mida &cervisia; annab sinu sooritatud ülesannete täitmiseks, samuti nende käskude väljundit.

Vaikimisi ei näita &cervisia; alamkataloogides leiduvaid faile ning sul tuleb klõpsata kataloogidel, mille sisu soovid näha. Kohaliku koopia kõigi failide nägemiseks kasuta menüükäsku Vaade Rulli failipuu lahti . Kui soovid nüüd jälle taastada algseisu, vali menüükäsk Vaade Rulli failipuu kokku .

Vastavalt failide `.cvsignore` seadistustele ei ole näha faile, mida tavaliselt ei soovita hoidlas näha, nt. objektifaile. Iga faili korral on näha selle olek. Vaikimisi on see "Tundmatu", sest &cervisia; ei hangi infot enne, kui oled valinud menüükäsu Fail Värskenda või Fail Olek . Sellisel moel on sul võimalik üht-teist ära teha isegi juhul, kui puudub püsiühendus &CVS; serveriga.

#### &cervisia; peaaken

&cervisia; peaaken

Käsud menüüs Fail rakenduvad üldiselt ainult failidele, mis on parajasti ära märgitud. Märkida saab ka katalooge. Vali seejärel Fail Olek või vajuta klahvi F5. &cervisia; annab siis korralduse

    cvs update -n failinimed

märgitud failide olekuinfo hankimiseks. Arvesta, et &cervisia; liigub rekursiivselt alamkataloogidesse ainult juhul, kui vastav võimalus menüüs Seadistused on sisse lülitatud. Vastavalt faili staatusele on veerus Olek näha järgmised märked:

Lokaalselt muudetud

- See tähendab, et faili on muudetud võrreldes hoidlas oleva versiooniga.

Lokaalselt lisatud

- See tähendab, et faili ei ole hoidlas, küll aga sinu töökataloogis ja et see on märgitud imporditavaks. Hoidlasse jõuab see siiski alles pärast sinna sissekande tegemist.

Lokaalselt eemaldatud

- See tähendab, et oled märkinud faili eemaldatavaks, kuid see on hoidlas siiski veel alles. Hoidlast eemaldatakse see alles pärast sinna sissekande tegemist.

Vajab värskendamist

- Seda näeb siis, kui hoidlas on olemas uuem versioon, nt. kui keegi on sellesse mingi muudatuse teinud. Tavaliselt valitseb sinus kange kihu seda faili uuendada, et oma töökataloog ajakohasena hoida.

Vajab paikamist

- Sisuliselt on see sama, mis eelmine. Erinevuseks on see, et uuendamise korral saadab &CVS; server kogu faili asemel ainult paiga.

Vajab ühendamist

- See annab märku, et vajalik on antud faili töökataloogis eksisteeriva versiooni ühendamine hoidlas oleva versiooniga. See juhtub tavaliselt siis, kui oled faili muutnud ning samal ajal on seda teinud ka keegi teine. Kui valid uuendamise, liidetakse hoidlas olevad muutused sinu faili. Konflikti korral (s.t. kui keegi on muutnud mõnda rida, mida sinagi oled muutnud, aga teisiti) saab uueks olekuks "Konflikt".

Värske

- Näitab, et fail on samane hoidlas oleva versiooniga.

Konflikt

- Seda näidatakse siis, kui failis leidub konfliktimärgiseid. See võib juhtuda näiteks siis, kui oled faili varem värskendanud, kuid konfliktid lahendamata jätnud.

Pole CVSis

- Näitab, et faili ei ole registreeritud &CVS;-hoidlas. Kui soovid, et see oleks kättesaadav ka teistele, tuleb see hoidlasse lisada. Kui aga mitte, võiksid selle nime lisada oma faili `.cvsignore`.

Nüüd, kus oled saanud ülevaate CVS-i hetkeolekust, võib tekkida soov võtta ette värskendamine. Märgi mõned failid (või ka kataloogipuu juur, mis võrdub kõigi selles kataloogis olevate failide märkimisega). Vali Fail Värskenda (kuigi tegelikult võiks seda käsku kasutada kohe seanssi alustades). Mõne faili olek võib muutuda. Tavaliselt uuendatakse faile, mille olek oli "Vajab paikamist" või "Vajab värskendamist". Nüüd võivad olekuveergu ilmuda mõningad uued elemendid:

Värskendatud

- Näitab, et faili on hoidlast värskendatud.

Paigatud

- Näitab, et &CVS; server on saatnud failile paiga ja et see on edukalt lisatud. Kui see hästi ei õnnestunud, sest tekkis konflikt sinu tehtud ja kellegi teise hoidlasse saadetud muudatuste vahel, saab olekuks Konflict.

Kindlasti märkad, et vastavalt olekule on ridadel erinev värv. Need on valitud mingil määral peegeldama oleku prioriteetsust. Näiteks konfliktiga fail on märgitud punasega, mis annab märku, et konflikt tuleks lahendada, enne kui failiga edasi tegutseda. Kui kataloogis on palju faile, võib siiski ülevaade kaotsi minna. Täpsema info saamiseks mitte-päris-tavalise olekuga failide kohta klõpsa veerul Olek. Nimekiri sorteeritakse siis vastavalt prioriteedile, nii et kogu oluline info koondub nimekirja esiotsa. Et näha taas tähestiku järgi sorteeritud nimekirja, klõpsa veerul Faili nimi.

## Töö failidega

&cervisia; peaaken võimaldab kasutada vahetult kõiki &CVS;-i tavapäraseid võimalusi. Käsud rakenduvad tavaliselt mitmele failile korraga - nimelt neile, mida oled parajasti valinud. Kui valik hõlmab ka katalooge, sõltub käsu rakendamise kord menüüs Seadistused määratust. Kui näiteks on sisse lülitatud Seadistused Rekursiivne sissekannete tegemine ja eemaldamine ning sa valid menüükäsu Fail Tee sissekanne..., kusjuures valitud on mõni kataloog, siis tehakse sissekanne kõigist antud kataloogi alla kuuluvatest failidest. Vastasel juhul puudutab käsk vaid tavalisi faile kataloogis endas.

### &cervisia; kontekstimenüü

Kõige sagedamini vajaminevad toimingud leiab ka failidel puuvaates hiire parema nupuga klõpsates avanevast kontekstimenüüst. screenshot-popup näitab &cervisia; peaakna kontekstimenüüd.

Faili redigeerimiseks piisab, kui sellele topeltklõps teha vüi fail valida ja vajutada klahvile &Enter;. Seejärel käivitatakse antud failitüübi käsitlemiseks mõeldud vaikerakendus (iga failitüübi vaikerakendus on kogu KDE-s kehtiv seadistus). Kui vaikerakendus ei ole mitte see, mida sa tahaksid parajasti kasutada, võib failil teha klõpsu hiire parema nupuga, valida alammenüü Redigeeri kasutades ning sealt juba mõni muu rakendus, mis antud failitüübiga tegelda oskab.

### Failide lisamine

Failide lisamine projekti eeldab kaht sammu. Esiteks peab failid &CVS;-is registreerima ehk nad hoidlasse lisama. Kuid see ei ole veel kõik: et failid ka tegelikult hoidlasse jõuaks, tuleb nad sisse kanda. Sellel on üks oluline eelis: failid saab sisse kanda koos muudatustega projekti muudes osades. Nii võivad teised (⪚ sissekandemeilides) hõlpsasti näha, et kõik need muudatused on tehtud korraga.

Selleks märgi &cervisia; peaaknas failid, mida soovid lisada. Seejärel vali menüükäsk Fail Lisa hoidlasse... või klõpsa märgitud failidel hiire parema nupuga ja vali Lisa hoidlasse... Ilmub dialoog CVS - lisamine, mis näitab kõiki märgitud faile ja soovib saada sinu kinnitust. Klõpsa nupule OK.

&cervisia; annab käsu

    cvs add failinimed

Kui see õnnestub, ilmub lisatavate failide olekuveergu märge "Lisatud hoidlasse".

&CVS; ei ole mõeldud pakkuma korralikku versioonide kontrolli binaarfailidele. Näiteks binaarfailide ühendamisel ei ole üldjuhul mingit mõtet. Pealegi võtab &CVS; sissekande tegemisel vaikimisi ette võtmesõna täiendamise (⪚ stringis `$Revision: 1.6 $`). Binaarfailides võivad sellised asendused faili rikkuda ja muuta täiesti kasutamatuks.

Et seda ei juhtuks, tuleb binaarfailid (või ka muud, näiteks PostScript failid või PNG pildifailid) sisse kanda menüükäsuga Fail Lisa binaarfail... Ilmub dialoog CVS - Binaarfaili lisamine, mis näitab kõiki märgitud faile ja soovib saada sinu kinnitust. Klõpsa nupule OK.

&cervisia; annab käsu

    cvs add -kb failinimed

### Failide eemaldamine

Sarnaselt failide lisamisele on failide eemaldamine kaheastmeline protsess. Esmalt tuleb failid registreerida eemaldatavaks menüükäsuga Fail Eemalda hoidlast... või hiire parema nupu klõpsuga märgitud failidel ja kontekstimenüüst kirje Eemalda hoidlast... valimisega. Ilmub dialoog CVS - Eemaldamine, mis näitab kõiki märgitud faile ja soovib saada sinu kinnitust. Klõpsa nupule OK. &cervisia; annab käsu

    cvs remove -f failinimed

Seejärel tuleb see liivakastis tehtud muudatus sisse kanda, millega võib kaasneda projekti ka muude muutuste tegemine.

Ülaltoodud käsk toimib ainult siis, kui fail on värske. Muidu on tulemuseks veateade. See on üsna arukas: kui oled teinud faili võrreldes hoidlaga muutusi või on muutusi teinud keegi teine, tasuks enne kontrollida, kas need tasub tõesti täielikult unustusehõlma saata.

### Kataloogide lisamine ja eemaldamine

&CVS; käsitleb katalooge põhimõtteliselt täiesti erinevalt tavalistest failidest. Need ei allu versioonide kontrollile, s.t. sul ei ole võimalik määrata, millised kataloogid olid projektis teatud ajahetkel olemas. Lisaks sellele ei saa katalooge otseselt eemaldada, kui sa just neid vahetult hoidlast ei kõrvalda.

&CVS; järgib tava, et kataloog on projekti versioonis "olematu", kui see on tühi. Seda saab teostada võtme `-P` lisamisega käsule `cvs update` ja `cvs checkout`. Selle võimaluse saab kehtestada menüükäsuga Seadistused Värskendamisel eemaldatakse tühjad kataloogid.

Kataloogi saab lisada hoidlasse menüükäsuga Fail Lisa hoidlasse... või hiire parema nupuga märgitud kataloogil klõpsates ja ilmuvast kontekstimenüüst kirjet Lisa hoidlasse... valides. Arvesta, et erinevalt failide lisamisest ei nõua kataloogi lisamine hilisemat sissekannet. &cervisia; annab seejärel käsu

    cvs add kataloogi_nimi

### Failide sissekandmine

Kui oled oma tööversiooni teinud mitmeid muutusi ja soovid, et ka teised arendajad saaks neid kasutada, tuleb need sisse kanda. Sissekandmisega paigutad muudetud failide versioonid uute versioonidena hoidlasse. Kui nüüd mõni teine arendaja võtab ette värskendamise, jõuavad sinu tehtud muudatused tema tööversiooni.

Failide sissekandmiseks vali need &cervisia; peaaknas ja kasuta menüükäsku Fail Tee sissekanne... või klõpsa märgitud failidel hiire parema nupuga ja vali ilmuvast kontekstimenüüst kirje Tee sissekanne...

#### &cervisia; sissekande tegemise dialoog

Ilmub dialoog, mille ülaosas on näha valitud failid ning alumises osas pakutakse sulle võimalust panna kirja logiteade. &cervisia; aitab igati kaasa mõtestatud logiteadete koostamisele. Esiteks saab failide nimekirjas mõnel failil topeltklõpsu tehes või klahvi Return vajutades näha sellesse tehtud muudatusi. Teiseks näidatakse liitkastis varasemaid logiteateid. Kolmandaks on dialoog seotud allpool kirjeldatava &cervisia; faili ChangeLog redaktoriga. Kui oled dialoogis asjadega valmis saanud, antakse käsk

    cvs commit -m teade failinimed

Üsna tavaline viga sissekande tegemisel on Up-to-date check failed (värskuse kontroll ebaõnnestus). See näitab, et keegi on hoidlasse pärast sinu viimast värskendamist muudatusi teinud ehk kui tehnilisemalt rääkida, ei ole sinu `BASE`-versioon antud harus mitte kõige uuem. Sellisel juhul keeldub &CVS; sinu muudatusi hoidlasse ühendamast. Lahenduseks on värskendada, lahendada vajadusel konfliktid ja uuesti sissekanne teha. Kui töötad tarkvaraprojekti kallal, tasub mõistagi pärast värskendamist ka kontrollida, kas rakendus ikka töötab, sest lõppeks võib ju sinu ja teiste tehtud muudatuste vahel olla vastuolusid, mis koodi rikuvad.

Teine levinud veateade on Sticky tag 'X' for file 'X' is not a branch. See juhtub siis, kui püüad sisse kanda faili, mille oled varem uuendanud teatud versiooni või sildini käsuga

    %cvs update -r X

(seda saab ⪚ teha menüükäsuga Muud Värskenda silti/kuupäeva...). Sellisel juhul muutub faili silt 'kleepuvaks', s.t edasised värskendamised ei anna tulemuseks haru uusimat versiooni. Kui soovid nüüd harusse sissekannet teha, tuleb enne seda värskendada haru silti.

&cervisia; puhul on üpris lihtne hallata faili ChangeLog, mis ühildub GNU koodijuhistes kirja pandud vorminguga. Selle kasutamiseks vali menüükäsk Fail Lisa ChangeLogi kirje.... Kui liivakasti ülemkataloogis on fail `ChangeLog` olemas, avatakse see ja sul on võimalus seda redigeerida. Selleks lisatakse faili algusesse kirje käesoleva kuupäeva ja sinu kasutajanimega (seda saab kohandada, täpsemalt räägib sellest customize-general). Kui oled töö lõpetanud ja klõpsanud nupule OK, on järgmisel sissekande tegemise dialoogi avamisel sind ees ootamast logiteade, mis vastab viimati muutuste logisse tehtud muudatustele.

### Konfliktide lahendamine

Konfliktid tekivad siis, kui muudad faili, mida on samal ajal muutnud ka mõni teine arendaja. &CVS; tuvastab konfliktid muudetud faili värskendamisel. &CVS; püüab siis ühendada teise arendaja tehtud muudatused sinu tööversiooni. Ühendamine aga ei õnnestu, kui nii sina kui teine arendaja olete muutnud faili ühesuguseid osi, mispeale &CVS; annab veateate.

&cervisia; peaaknas annab konfliktidega failidest märku kirje "Konflikt" olekuveerus ning punane värv. Nüüd tuleb sul konfliktid lahendada, enne kui saad faili sisse kanda. &CVS; keeldub lubamast sisse kanda konfliktidega faile, kui neid pole redigeeritud. Konflikte saab lahendada tavapäraselt: tee peaaknas vajalikul failil topeltklõps ja redigeeri faili meelepärases redaktoris.

&CVS; tähistab konfliktsed muudatused teatud märke otse keset faili lisades järgmise reegli kohaselt:

    <<<<<<<
    Muudatused sinu kohalikus versioonis
    =======
    Muudatused hoidlas
    >>>>>>> versiooni_number

Sul tuleb kogu see plokk asendada uue, ühtse versiooniga. Mõistagi on konfliktide lahendamisel jäme ots sinu käes: iga konflikti puhul võid just sina otsustada, milline kahest võimalusest valida.Samuti võid langetada otsuse, et kumbki variant tegelikult ei kõlba ning kirjutada kogu ploki või isegi kogu faili algusest peale uuesti.

Õnneks pakub aga &cervisia; välja kena liidese konfliktide lahendamiseks. See ei tähenda, et sa ei pea kunagi faile käsitsi redigeerima, aga tavalisemate konfliktide puhul pole küll selleks vajadust. &cervisia; dialoogi CVS - Lahendamine avamiseks vali menüükäsk Fail Lahenda... või klõpsa märgitud failil hiire parema nupuga ja vali ilmuvast kontekstimenüüst kirje Lahenda...

#### &cervisia; lahendamisdialoog

&cervisia; lahendamisdialoog

Dialoogi ülaosas on vasakul näha sinu faili Sinu versioon (A) ja paremal faili versioon hoidlas ehk Teine versioon (B). Erinevused on tähistatud punase värviga. Kahest versioonist allpool on näha Ühendatud versioon. See näitab, milline antud osa sinu kohalikus koopias välja hakkab nägema pärast seda, kui oled klõpsanud nupule Salvesta.

Erinevusi sisaldavate osade vahel saab liikuda nuppudega << ja >>. Dialoogi allosas keskel on näha, millise osa juures parajasti ollakse. Näiteks `2 / 3` tähendab, et parajasti on tegemist teise erinevusega kokku kolmest erinevusest.

Seda, milline variant tuleks lõplikku versiooni jätta, saab otsustada iga osa kohta eraldi. Klõps nupule A valib sinu versiooni, nupule B aga hoidla versiooni. Klõps nupule A+B lisab mõlemad versioonid, kusjuures sinu versioon on esimene. B+A annab samasuguse tulemuse, aga teistpidi: esimesena tuleb hoidla ja seejärel sinu versioon.

Kui mitte ükski versioon sind ei rahulda, klõpsa nupule Muuda, mis avab lihtsa tekstiredaktori, kus saad kogu osa redigeerida. Kui oled valmis saanud, klõpsa nupule OK ning saad tagasi pöörduda dialoogi CVS - Lahendamine juurde ja jätkata konfliktide lahendamist. Näed nüüd osas Ühendatud versioon just äsja redigeeritud osa koos tehtud muudatustega.

Muudatuste salvestamiseks ja oma kohaliku koopia ülekirjutamiseks klõpsa nupule Salvesta. Arvesta, et sellega salvestad mitte ainult selle osa, mis on parajasti näha, vaid kõik faili tehtud muudatused. Kui soovid muudatused salvestada igaks juhuks muu nime all, klõpsa nupule Salvesta kui... Klõps nupule Sulge paneb dialoogi kinni. Kui sulged dialoogi ilma salvestamata, lähevad kõik tehtud muudatused kaotsi.

## Failide info hankimine ja paikade loomine

### Versioonide erinevuste jälgimine

&cervisia; võimaldab mitmel puhul avada akna, mis näitab failiversioonide erinevusi:

- Peaaknas saab valida menüükäsu Vaade Erinevus hoidlast (BASE).... See annab käsu `cvs diff` ning näitab erinevusi sinu liivakasti ja viimati värskendatud (tuntud ka kui `BASE`) versiooni vahel. See on eriti kasulik vahetult enne faili sissekandmist, et leida sobiv logiteade.

- Erinevusi oma liivakasti ja peamise arendusharu ehk `HEAD` vahel saab vaadata menüükäsuga Vaade Erinevus hoidlast (HEAD)...

- Valitud faili kahe viimase versiooni erinevusi saab vaadata menüükäsuga Vaade Viimane muudatus...

- Käske Erinevus hoidlast (BASE)..., Erinevus hoidlast (HEAD)... ja Viimane muudatus... saab samuti kasutada peaaknas failil, mille erinevusi soovid näha, hiire parema nupuga klõpsates.

- Sissekande tegemise dialoogis saab erinevusi lasta näidata faili nime valides ning sellel topeltklõpsu tehes või klahvi Return vajutades. Selle tulemus on sarnane menüükäsuga Vaade Erinevus hoidlast (BASE)...

- Logifailide lehitsemise dialoogis saab märkida faili kaks versiooni ja lasta näidata nende erinevusi (täpsemalt vaata browsinglogs).

Nagu oodata võibki, ei paiska &cervisia; lihtsalt käsu `diff` väljundit terminaliaknasse, vaid näitab seda graafiliselt, näiteks nagu screenshot-log.

#### &cervisia; võrdlemise dialoog

&cervisia; võrdlemise dialoog

Dialoogis olev tekst kujutab endast veidi paremaks muudetud varianti tekstist, mille annab võrdlemiskäsk võtmega `-u`. Kahes aknas on näha erinevad versioonid, kusjuures read on korraldatud nii, et neid saaks otse võrrelda. See tähendab, et seal, kus teksti on lisatud või kustutatud, on teise akna vasakus servas vastavas kohas näha tühjad read tähistusega `+++++`. Lisaks sellele on näha iga rea number.

Parempoolse akna teises veerus on näha, milline on muudatus olnud. Võimalikud tüübid on `Lisatud`, `Kustutatud` ja `Muudetud`, need read on vastavalt sinised, rohelised ja punased. Dialoogi keskel on kokkusurutult näha värvimärgised ridade kaupa. Nii saab faili muudatustest kiire ülevaate. Kokkusurutud kujundi värviribade asendit saab kasutada ka orienteerumiseks kerimisribade kasutamisel.

Tavaliselt on kerimisribad vasakus ja paremas aknas sünkroonitud, s.t. kui kerid vasakut akent, liigub vastavalt ka parem aken. Seda käitumist saab muuta märkekasti Sünkroonitud kerimisribad abil.

Seda, kuidas kohandada võrdlemisdialoogi, annab teada customize-diff.

### Paikade loomine

Mõnikord võib juhtuda, et soovid oma muudatused kõigepealt teistele ülevaatamiseks anda, enne kui need sisse kanda, või siis ei olegi sul hoidlas kirjutamisõigust ning sa ei saagi midagi sisse kanda. &CVS; pakub välja standardse vorminduse failidele, millega jagada oma kohalikku koopiasse tehtud muudatusi teistega, testida neid kohaliku koopia peal ja rakendada &CVS;-hoidlale. Selliseid erinevusi sisaldav fail kannab nimetust paik (inglise keeles patch) ja see luuakse käsuga `cvs diff` täpselt samamoodi nagu erinevused, mida kirjeldas diff. Paikade kasutamine tervete failide asemel võimaldab toime tulla ka siis, kui näiteks internetiühendus on kallis või vähese läbilaskevõimega, pealegi on paiku hõlpsam käsitleda, sest ka üksainus paigafail võib sisaldada paljude läthefailide erinevusi.

&cervisia; võimaldab seda teha menüükäsuga Muud Loo hoidla suhtes paigafail...

Käsk Loo hoidla suhtes paigafail... loob paiga, mis sisaldab kõigi sinu kohaliku koopia (liivakasti) failide kõiki muudatusi võrreldes hoidla `BASE`-versiooniga. Seepärast ei ole paiga loomisel ka oluline, kas peaaknas on mingid failid valitud või mitte.

Teine võimalus on valida peaaknas üks kindel fail ning seejärel menüüst Vaade käsk Näita logifaili... või märgitud failil hiire parema nupuga klõpsates kirje Näita logifaili..., mis avab logidialoogi. Vali nüüd versiooniks "A" versioon, mille suhtes soovid paiga luua, ning klõpsa nupule Loo paik... See tekitab paiga, mis sisaldab erinevusi sinu kohaliku koopia märgitud faili ning versiooni "A" vahel.

Enne paiga tekitamist avab &cervisia; dialoogi, milles saab kindlaks määrata väljundi vorminduse.

#### &cervisia; paikamisdialoog

&cervisia; paikamisdialoog

Väljundi vormindus

- Väljund võib olla vormindatud kolmel viisil:

  Tavaline: vormindus, millega saab näiteks redaktori ed pnna automaatselt looma vanast failist koopiat uue failiga sobimiseks. Tavalise vorminduse korral tähistavad muudatusi sümbolid < ja > ning kontekstiinfo puudub.

  Unifitseeritud: levinuim paikade vormindus. Selle puhul kasutatakse erinevuste salvestamiseks lisaks reanumbritele ka kontekstiridasid. See muudab paikade rakendamise märksa turvalisemaks. Erinevusi näidatakse kompaktses ja loetavas vormis, näidates iga asjassepuutuva faili päist ning omaette sektsioone (tükke) iga erinevuse kohta. Iga erinevuse kontekstiread muudavad muudatustest ülevaate saamise hõlpsamaks. Muudatusi tähistavad sümbolid + ja -.

  Kontekst näitab sama infot, mis unifitseeritud vorminduski, aga mitte nii kompaktselt. Kontekstivorminduse korral tähistab muudatusi sümbol !.

Kontekstiridade arv:

- Siin saab määrata kontekstiridade arvu unifitseeritud või kontekstivorminduse korral. Tavalise vorminduse puhul ei saa seda kasutada, sest sellisel juhul ju kontekstiinfot ei salvestata. Mida rohkem kontekstiinfot, seda hõlpsam on toorväljundit lugeda ja seda täpsemini saab paiku rakendada, kuid paiga suurus sel moel mõistagi kasvab. Väga mõistlik oleks siiski kasutada vähemalt kaht kontekstirida.

Ignoreerimisvalikud

- Siin saab valida, milliseid muudatusi ei peeta paiga loomisel erinevuseks.

Pärast väljundi vorminduse määramist loob &cervisia; paiga ja avab dialoogi Salvesta kui. Määra seal paigafaili nimi ja asukoht.

### Faili annoteeritud vaate jälgimine

Käsu `cvs annotate` peale pakub &CVS; võimalust rida-realt näha, kes on failis viimati muudatusi teinud. See on kasulik tuvastamaks, kes millise muutuse on sisse viinud või kellele esitada küsimus koodi tehtud muudatuse või sellesse tekkinud vea kohta.

&cervisia; võimaldab seda kasutada, kuid rikastab pakutavat infot omalt pooltki. Annotatsioonivaate saab avada menüükäsuga Vaade Näita annotatsiooni.... Teine võimalus on klõpsata logi lehitsemise dialoogis nuppu Annoteerimine, mille puhul saab valida, millist failiversiooni soovid näha. Milline see dialoog välja näeb, näitab screenshot-annotate.

#### &cervisia; annotatsioonidialoog

&cervisia; annotatsioonidialoog

Annotatsioonidialoogi aknas on näha valitud faili viimane versioon (või versioon "A", kui käivitasid annotatsioonidialoogi logi lehitsemise dialoogist). Veerud enne teksti näitavad iga rea puhul infot viimaste muudatuste kohta. Esimeses veerus näidatakse reanumbrit. Teises veerus on näha selle versiooni autori nimi ja versiooni number. Kolmandas versioonis aga rea tegelikku sisu.

Nii saab juhul, kui mingi rida paistab kahtlasena või kahtlustad, et seal võib peituda viga, kohe teada, kellele selle rea eest vastutus langeb. Lisaks sellele võib aga ka teada saada, miks seda rida muudeti. Selleks vii hiirekursor vastava versiooninumbri kohale, misjärel ilmub kohtspikker logiteate ja muutmise kuupäevaga.

### &CVS; logide lehitsemine

Kui märgid peaaknas mõne faili ja valid menüüst Vaade käsu Näita logifaili... või klõpsad märgitud failil hiire parema nupuga ja valid kontekstimenüüst Näita logifaili..., näidatakse dialoogi CVS - logifaili vaatamine (kui märgid enam kui ühe faili, ei juhtu midagi, sest &cervisia; suudab korraga luua ja parsida ainult ühe faili logi). See dialoog pakub tegelikult märksa enam võimalusi kui ainult faili ajalooga tutvumine. Selle sirvija abil on võimalik:

- Näha märgitud faili iga versiooni numbrit, autorit, kuupäeva, haru, sissekandmisteadet ja silte.

- Näha märgitud faili harru lisamist ja sildi omistamist graafiliselt puuna.

- Näha märgitud faili iga versiooni (vaikerakenduses).

- Jälgida märgitud faili iga versiooni annoteeritud vaadet.

- Näha märgitud faili mis tahes kahe versiooni erinevusi, sealhulgas ka erinevust märgitud faili parajasti kohalikus koopias olevast versioonist.

- Luua paiku erinevustega märgitud faili mis tahes kahe versiooni vahel, sealhulgas erinevustega märgitud faili parajasti kohalikus koopias oleva versiooni suhtes.

#### &cervisia; logi lehitsemise dialoog

&cervisia; logi lehitsemise dialoog

Ajalugu, nagu seda pakub käsk `cvs log` (CVS väljund) võib vaadata kas puu või nimekirja kujul. Kumb valida, sõltub sinu maitsest ning sellest, milline info sind huvitab. Puu kujutab ülevaadet, mida milline autor erinevates harudes on teinud. Kohtspikrid näitavad vastavaid logiteateid. Nimekiri on loomult lineaarne ega anna seetõttu ühe pilguga hõlmatavat ülevaadet harudest. Teisalt koondub siin rohkem asjakohast infot väiksemale ruumile, nimelt faili iga muutmise aeg ja logiteate algus. CVS väljund on põhjalik ja täielik, kuid pikk ja raskesti loetav. Selle lihtsustamiseks on võimalik väljundis teksti otsida, millist võimalust pakub nupp Otsi...

Konkreetse versiooni kohta enama info hankimiseks tuleb sellel klõpsata, olgu siis tegemist nimekirjaga või puuga. Dialoogi keskel asuvad väljad täituvad seejärel infoga, mida tagastab käsk `cvs log`. Sa võid ära märkida ka kaks versiooni, vastavalt "A" ja "B", kui soovid korraga näha huvipakkuvaid versioone. Versiooni "A" saab valida hiire vasaku, "B" keskmise nupuga. Nimekirjavaates saab liikuda ka kursoriklahvidega. Versioonide "A" ja "B" märkimiseks kasuta vastavalt kiirklahve Ctrl A ja Ctrl B. Vaates CVS väljund saab versioonide märkimiseks klõpsata nuppudele Vali versioon A ja Vali versioon B.

Klõps nupule Annoteerimine avab dialoogi, kus on näha versiooni "A" tekst. Iga rea ees on info selle viimase redigeerija ning redigeerimisaja kohta. Rohkem infot annoteeritud versioonide vaatamise kohta annab annotate.

Klõps nupule Võrdlemine kutsub välja käsu `cvs diff`, mille tulemuseks on dialoog, mis näitab kõiki erinevusi kahe märgitud versiooni vahel. Kui märgid versiooni "A", aga mitte versiooni "B", genereerib &cervisia; muudatused versiooni "A" ning faili kohalikus koopias parajasti eksisteeriva versiooni vahel. See lubab näha erinevusi faili sinu ja millise tahes &CVS;-is oleva versiooni vahel. Vaatamise hõlbustamiseks kasutatakse erinevaid värve lisatud, eemaldatud või muudetud ridade märkimiseks. Rohkem infot erinevuste vaatamise kohta annab diff.

Klõps nupule Loo paik... avab dialoogi, kus saab määrata millises vorminduses luuakse fail, mis sisaldab kõiki kahe näidatava versiooni vahelisi erinevusi. Kui märgid versiooni "A", aga mitte versiooni "B", genereerib &cervisia; muudatused versiooni "A" ning faili kohalikus koopias parajasti eksisteeriva versiooni vahel. See lubab luua paiga- ehk erinevustefaili sinu ja millise tahes &CVS;-is oleva versiooni vahel. Pärast paiga vorminduse määramist dialoogis ja klõpsu nupule OK antakse käsk `cvs diff`, mis loobki erinevustefaili. Ilmub dialoog Salvesta kui, kus tuleb määrata &cervisia; loodud paigafaili nimi ja asukoht, kui soovid seda ikka salvestada. Rohkem infot paikade loomise ja paigafailide vorminduse kohta annab creatingpatches.

Klõpsuga nupule Näita hangib &cervisia; versiooni "A" ning näitab seda antud failitüübi vaikerakenduses.

Klõpsuga nupule Sulge saab dialoogi kinni panna ja naasta peaaknasse.

Dialoogi CVS - Logifaili vaatamine aluseks oleva logi genereerimiseks annab &cervisia; käsu:

    cvs log failinimi

### Ajaloo lehitsemine

Kui hoidlas on logimine lubatud, võib &cervisia; näidata teatud sündmuste, näiteks väljavõtete ja sissekannete tegemise, värskendamiste ja väljalasete ajalugu. Vali menüüst Vaade käsk Ajalugu, mispeale &cervisia; annab käsu

    cvs history -e -a

See tõmbab serverilt kogu logifaili, s.t. nimekirja kõigi kasutajate ja kõigi moodulite sündmuste kohta. See fail võib olla päris suur.

Nüüd võid kuupäevade kaupa sorteerituna näha sündmuste nimekirja. Teises veerus näidatakse sündmuse tüüpi:

- Tehtud väljavõte - veerus 'Autor' näidatud kasutaja tegi mooduli väljavõtte

- Silt - kasutaja tarvitas käsku `cvs rtag`. Arvesta, et käsu `cvs tag` (mida teeb &cervisia; käsk Muud Silt/haru...) kasutamist ajaloo andmebaasis ei leidu. Sellel on oma ajaloolised põhjused (täpsemat infot jagab &CVS; KKK).

- Väljalase - kasutaja on mooduli välja lasknud. Tegelikult kasutatakse seda käsku väga harva ning sellel puudub eriline mõte.

- Värskendatud, kustutatud - kasutaja on värskendanud faili, mis on hoidlast kustutatud. Selle tulemusena kustutati fail ka tööversioonist.

- Värskendatud, kopeeritud - kasutaja on faili värskendanud, töökataloogi kopeeriti uus versioon.

- Värskendatud, ühendatud - kasutaja on faili värskendanud, hoidla versioonis olevad muutused ühendati tööversiooni failiga.

- Värskendatud, konflikt - kasutaja on faili värskendanud ning tuvastati konflikt tööversioonis tehtud muudatustega.

- Tehtud sissekanne, muudetud - kasutaja on muudetud faili sisse kandnud.

- Tehtud sissekanne, lisatud - kasutaja on faili lisanud ja sissekande teinud.

- Tehtud sissekanne, eemaldatud - kasutaja on faili eemaldanud ja sissekande teinud.

#### &cervisia; ajaloo dialoog

&cervisia; ajaloo dialoog

Nimekirja saab vastaval veerupäisel klõpsates selle veeru järgi sorteerida. Sorteerimaks ajalookirjeid huvipakkuva teema järgi, saab märkekastidega rakendada mitmesuguseid filtreid:

- Näita sissekannete tegemisi - näitab sissekandeid

- Näita väljavõtete tegemisi - näitab väljavõtteid

- Näita sildistamisi - näitab sildistamisi

- Näita muid sündmusi - näitab sündmusi, mida ülaltoodud võimalused ei hõlma

- Ainult kasutaja - näitab ainult konkreetse kasutajaga seotud sündmusi

- Ainult failinimed - filtreerib failinimed vastavalt regulaaravaldisele

- Ainult kataloogid - filtreerib katalooginimed vastavalt regulaaravaldisele

Regulaaravaldistes saab kasutada järgmisi erimärke:

- `x*`: sobib suvaline arv `x` esinemisi.

- `x+`: sobib üks või enam `x` esinemist.

- `x?`: sobib null või üks `x` esinemist.

- `^`: sobib stringi algus.

- `$`: sobib stringi lõpp.

- `[a-cx-y]`: sobib märgirühm, ⪚ antud juhul a,b,c,x,y.

## Kasutamine edasijõudnutele

### Värskendamine sildi, haru või kuupäeva järgi

Mooduli harud on selle paralleelsed versioonid. Heaks näiteks nende praktilise kasutamise kohta on tarkvaraprojektide väljalasked. Pärast väljalaset on kahtlemata lähtekoodis vigu, mis ootavad parandamist, kuid samas soovib keegi kindlasti ka mõne hoopis uue võimaluse lisada. Mõlemat korraga on reeglina päris raske saavutada, sest uued võimalused toovad enamasti kaasa uusi vigu ning seeläbi muutub vanade vigade jälgimine keerukamaks. Selle dilemma lahendamiseks lubab &CVS; luua paralleelse versiooni, mida me nimetame "stabiilseks väljalaskeharuks" ja milles parandatakse ainult vigu, samal ajal kui peaharu (HEAD) on avatud ka uute võimaluste lisamisele.

Silte kasutatakse projekti versiooni tähistamiseks. &CVS; märgib iga faili kindla versiooni sildiga, nii et kui teed väljavõtte või värskendad konkreetse sildi järgi, saad alati failist ühe ja sama versiooni. Sestap ei saa erinevalt harust sildiga faili õigupoolest arendada. Silte on mõtet kasutada väljalasete, koodis tehtud suuremate muudatuste &etc; korral.

Kui arendad mõnd tarkvaraprojekti, ei ole mitte alati vajalik ega mõttekaski töötada põhiharus. Pärast väljalaset näiteks on mõttekas antud versioon mõneks ajaks suhteliselt rahule jätte, parandades seal ainult vigu, lastes töötada tarkvara tõlkijatel &etc; Selleks tuleb värskendada väljalaskeharu järgi. Sellisel juhul värskendatakse kõik sinu failid antud haru failide uusima versioonini. Pärast värskendamist saad muudatuste tegemisel need samasse harusse taas sisse kanda.

Samuti võib tekkida vajadus uurida mõnd viga, mis tekkis mingi sildiga tähistatud väljalaskes. Sellisel juhul pakub &CVS; võimalust hankida tarkvara just sellisel kujul, nagu see väljalaskes esines. Kui aga soovid hankida oma projekti mõne varasema versiooni, võid kohaliku töökoopia värskendada kindla kuupäeva järgi. See on mõttekas näiteks juhul, kui mingi viga tekkis kahe väljalaske vahel ja sul on ka üsna täpne ettekujutus, millal. Kui värskendad kuupäeva või sildi järgi, saab sinu failide versiooniks sama versioon, mis on antud kuupäevaga või sildiga failidel.

Enne seda, kui värskendada mõne muu haru või sildi järgi, kontrolli, et oled oma senises tööharus kõik muudatused sisse kandnud. Kui sa seda mingil põhjusel teha ei saa ja tehtud muudatusi kaotada ka ei taha, siis ära värskenda uude harru, sest nii lähevad muudatused kaotsi. Teine võimalus on sooritada täiesti uus väljavõte ning töötada paralleelselt mõlema versiooniga.

#### &cervisia; sildi järgi uuendamise dialoog

&cervisia; sildi järgi uuendamise dialoog

Uuenda harusse

- Selle valimisel saad faile värskendada teatud haru järgi. Sisesta haru nimi tekstikasti (või klõpsa nupule Laadi nimekiri, mis hangib &CVS;-serverist harude loendi, millest saad valida endale sobiva).

Uuenda sildi järgi

- Selle valimisel saad faile värskendada teatud sildi järgi. Sisesta sildi nimi tekstikasti (või klõpsa nupule Laadi nimekiri, mis hangib &CVS;-serverist siltide loendi, millest saad valida endale sobiva).

Uuenda kuupäeva järgi

- Selle valimisel saad faile värskendada teatud kuupäeva järgi. Alloleval väljal võid mitmel moel sisestada kuupäeva. See võib olla näiteks `yyyy-mm-dd`, kus `yyyy` on aasta, `mm` kuu (numbrilisel kujul) ja `dd` päev. Kasutada saab ka mõningaid ingliskeelseid fraase, näiteks `yesterday` (eile) ja `2 weeks ago` (2 nädala eest).

Sildi või kuupäeva järgi värskendamine muudab sildi või kuupäeva 'kleepuvaks', s.t. sul ei ole enam võimalik nende failide puhul teha sissekandeid (kui just silt ei ole antud haru silt). Põhiharuga (tuntud ka kui `HEAD`) taasliitumiseks kasuta menüükäsku Muud Värskenda HEAD-harusse.

Haru või sildi järgi värskendamiseks antakse käsk:

    cvs update -r silt

Kuupäeva järgi värskendamiseks antakse käsk:

    cvs update -D kuupäev

Peaharru (HEAD) värskendamiseks antakse käsk:

    cvs update -A

### Sildi ja haru omistamine

Me puudutame siin ainult sildi ja haru omistamise tehnilist külge. Kui oled lihtsalt hoidla kasutaja, mitte administraator, ei pruugi sellised probleemid sul ette tullagi. Kui aga oled administraator, tuleks esmalt tutvuda sildi omistamisega seotud mittetehniliste küsimustega, et saada arusaam, kui aeganõudev ja vigaderohke võib ühe projekti erinevate harude haldamine olla. Mõningaid lisamaterjale selle kohta pakub käsiraamatu lisa.

Sildi omistamisega tuleb tegemist teha enamasti väljalaske korral, et alati oleks võimalik pöörduda hõlpsasti tagasi projekti sellel hetkel valitsenud olukorra juurde. Silt on tavaliselt ühtlustatud projektinime ja versiooninumbriga. Näiteks &cervisia; 1.0 silt on `CERVISIA_1_0`. &cervisia; kasutab otsustamisel, milline on sobilik silt, &CVS; rangeid reegleid: see peab algama tähega ning sisaldama vaid tähti, numbreid, sidekriipse ja alakriipse.

Tavaliselt omistatakse silt kogu projektile (kuigi &CVS; lubab mõistagi sildi omistada ainult alamprojektile). Selleks vali ülemkataloog ning seejärel menüükäsk Muud Silt/haru. Sisesta dialoogis sildi nimi, vajuta klahvi Return ja asi ants!

Haru loomine ei ole tegelikult märgatavalt keerulisem: märgista sildi omistamise dialoogis kast Luuakse selle sildiga haru. Olemasolev silt on võimalik ka kustutada, selleks vali peaaknas menüükäsk Muud Eemalda silt.

Haru omistamise veel üks aspekt on muudatuste ühendamine harust käesolevasse harru. Kui kavatsed seda teha, vali menüükäsk Muud Ühenda.... Ilmuv dialoog pakub kaks võimalust:

Ühendada kõik harus tehtud muudatused käesolevasse harru. Selleks märgi ära Ühenda harust ja kirjuta haru, millest soovid ühendada. &cervisia; annab seejärel käsu

    cvs update -j haru_loomise_kuupäev

Ühendada ainult haru kahe sildi vahelised muudatused. Seda on vaja siis, kui ühendad mitmel korral samast harust põhiharru. Selleks märgi ära Ühenda siltidevahelised muudatused ning sisesta (õiges järjekorras) kaks silti. See tähendab käsku

    cvs update -j haru_loomise_kuupäev1 -j haru_loomise_kuupäev2

### Jälgijate kasutamine

Jälgija (inglise keeles watch) on &CVS;i tavapärane viis anda hoidla kasutajatele märku, kui faili on muudetud või kui mõni arendaja on hakanud faili redigeerima. Jälgijate kasutamine nõuab faili ``$CVSROOT`/CVSROOT/notify` korrektset seadistamist. Seda siinkohal ei puudutata. Kui vajad rohkem infot, kuidas administraator taolisel korral käituma peaks, loe mõnda lisas soovitatud materjalidest.

&cervisia; tugi jälgijatele koosneb põhiliselt kuuest menüükäsust.

Jälgija lisamiseks ühele või mitmele failile vali menüükäsk Muud Lisa jälgija.... Ilmuvas dialoogis saad määrata, millist tüüpi &CVS;i toega sündmustest märku antakse. Kui näiteks soovid märku saada vaid sissekannete tegemisel, märgi ära Ainult ja Sissekande tegemine. Kui soovid teada saada kõigist märgitud failidega toimuvatest sündmustest, vali Kõik. Valiku kinnitamisel antakse käsk

    cvs watch add -a commit failinimed

või mõne muu sarnase võtmega vastavalt sellele, millise sündmuse valid.

Kui mingid failid enam huvi ei paku, saab neilt jälgija eemaldada. Selleks vali menüükäsk Muud Eemalda jälgija.... Ilmuvas dialoogis on samasugused valikud, nagu jälgija lisamise dialoogis. Valiku kinnitamisel annab &cervisia; käsu

    cvs watch remove failinimed

(võimalik on lisada valitud sündmuste jaoks võti `-a`).

On võimalik hankida ka nimekiri inimeste kohta, kes faile jälgivad. Selleks kasuta menüükäsku Muud Näita jälgijaid. See annab käsu

    cvs watchers failinimed

&CVS;i kõige tavalisema pruukimise korral töötab iga arendaja omaenda liivakastis. Kui ta soovib mõnda faili muuta, avab ta selle oma redaktoris ning asub tööle. Keegi teine ei pruugi tema tööst teada saada, enne kui ta faili hoidlasse sisse kannab.

Mõned arendajate grupid aga eelistavad teistsugust töökorraldust, kus teised saavad sellest, et keegi on asunud mõne failiga tegutsema, teada otsekohe. See on &CVS;is samuti võimalik. Enne kui alustad faili redigeerimist, vali see &cervisia; peaaknas ning kasuta menüükäsku Muud Muuda faile. See annab käsu

    cvs edit failinimed

Ühtlasi saadab see teadaande kõigile, kes on antud failile määranud jälgija `redigeerimine`. Samuti registreeritakse sind faili redigeerijana. Kõigi mingi faili redigeerijate nimekiri on võimalik saada menüükäsuga Muud Näita muutjaid. See võrdub käsurea korraldusega

    cvs editors failinimed

Redigeerimisseanss lõpeb automaatselt, kui teed antud faili sissekande. Sel hetkel saadetakse teadaanne `unedit` kõigile, kes on antud faili jälgimise sisse lülitanud. Vahel võib mõistagi juhtuda, et sa ei soovi faili sisse kanda, vaid hoopis redigeerimisseansi lõpetada ja taastada faili varasema versiooni. Seda saab teha menüükäsuga Muud Loobu muutustest. Arvesta, et &cervisia; küsib selle peale, kas sa seda tõesti soovid. Selle menüükäsu kasutamine tähendab, et kõik muutused, mida oled teinud alates menüükäsu Muud Muuda faile kasutamisest, lähevad kaotsi. Kui olla täpne, annab &cervisia; sellel puhul käsu

    echo y | cvs unedit failinimed

Seni oleme rääkinud juhtumitest, kus arendajad kasutavad failide muutmise ja muutustest loobumise võimalust vabatahtlikult. Lisaks sellele toetab &CVS; meetodit, mis sunnib peale nende käskude kasutamise. Selle meetodi kasutamise käsk on `cvs watch on`, millel me pikemalt ei peatu, sest seda kasutab ennekõike hoidla administraator. Kuid arendaja seisukohalt on oluline tähele panna, et kui projekt sunnib faili muutmise käsu peale, tehakse töökoopia väljavõtted ainult lugemisõigusega (readonly). See tähendab, et vaikimisi ei ole võimalik faili redigeerida (kui sa just ei kasuta mõnda möödahiilimisvõimalust, näiteks `chmod`). Failile tekib kirjutamisõigus alles menüükäsu Muud Muuda faile kasutamisel. See omandab taas vaid lugemisõiguse niipea, kui oled faili sisse kandnud või kasutanud menüükäsku Muud Loobu muutustest.

&cervisia; redaktoriliides võib jälgijaid peale sundivate projektide korral abiks olla veel ühel viisil. Kui käivitasid redaktori vaid lugemisõigusega failiga sellel topeltklõpsu tehes või menüükäsku Fail Redigeeri pruukides, ei saa sa tehtud muudatusi hiljem salvestada. Sellel on mõistagi oma põhjus: kui sa soovid faili muuta, pead kasutama käsku `cvs edit`, et need, kes antud faili jälgivad, saaksid teada, et oled asunud selle kallal tööle.

Sellisel juhul on soovitav lülitada sisse võimalus Seadistused Automaatse redigeerimise lubamine (cvs edit). Kui nüüd failil topeltklõpsu teed, annab &cervisia; enne redaktori käivitamist käsu `cvs edit`. Seejärel saad faili vabalt redigeerida. Kui oled töö lõpetanud, tee sissekanne ning sissekantud failid on taas vaid lugemisõigusega.

### Lukustamine

&CVS;i kasutamisel tavapäraselt rakendatav arendusmudel on piiramatud väljavõtted. Igal arendajal on oma liivakast, kus ta saab faile oma suva järgi redigeerida. Kui kasutatakse jälgimisvõimalusi, näiteks `cvs edit`, võib mitu arendajat failidega sünkroonselt töötada. Teise arendaja tehtud muudatused ühendatakse kohalikku liivakasti, kui faili värskendad.

Muud versioonikontrolli süsteemid, näiteks RCS ja SourceSafe, kasutavad teistsugust meetodit. Kui arendaja soovib faili redigeerida, peab ta selle lukustama. See tähendab, et korraga saab üht faili redigeerida vaid üks arendaja. Kui ta redigeerimise lõpetab, lukustus eemaldatakse. Ühelt poolt ei saa sellise meetodi korral kunagi ette tulla konflikte. Teisalt ei saa aga kaks arendajat korraga ühe faili kallal töötada isegi juhul, kui nad töötavad faili erinevate osade kallal. See võib tööd aeglustada. Siin ei ole õige koht arutada nende meetodite organisatoorsete plusside ja miinuste üle. Tasub siiski mainida, et kuigi &CVS; pakub lukustamisele teatud tuge, ei ole see &CVS;i korral sugugi eelistatud töömeetod. Seda ei peaks kasutama, kui sa ei ole just kindel, et projekti haldur seda soosib.

&cervisia;s saab faile lukustada järgmiselt. Vali peaaknas vajalik fail. Seejärel kasuta menüükäsku Muud Lukusta failid. See annab käsu

    cvs admin -l failinimed

Vastupidise toimingu sooritamiseks kasuta menüükäsku Muud Eemalda lukustus. See annab käsu

    cvs admin -u failinimed

## &cervisia; seadistamine

&cervisia;t saab vastavalt kasutaja vajadustele ja eelistustele mitmeti kohandada. Mõningad võimalused, mida võib olla vajadus sageli muuta, on kättesaadavad menüüs Seadistused. Teised on koondatud dialoogi, mis avaneb menüükäsuga Seadistused Cervisia seadistamine....

### Üldine

Kasutaja andmed ChangeLog failis

- Kui kasutad menüükäsku Fail Lisa ChangeLogi kirje..., luuakse uus ChangeLogi kirje käesoleva kuupäeva ja sinu kasutajanimega. Üldiselt peetakse heaks tooniks lisada igale ChangeLogi kirjele enda täielik nimi ja e-posti aadress. &cervisia; lisab need automaatselt, kui sa nad siin ära määrad.

CVS-i rakenduse asukoht või 'cvs':

- Siin saab määrata `cvs` käsureakliendi nime või otsingutee. Vaikimisi kasutab &cervisia; &CVS;-i käivitatavat faili, mis asub sinu otsinguteel (`$PATH`).

### Võrdluse näitaja

Kontekstiridade arv võrdlemise dialoogis:

- &cervisia; kasutab võrdlemisdialoogis käsul `diff` võtit `-U`. Selle tulemusena näitab `diff` igas erinevuse piirkonnas ainult piiratud arvu ridu. Siin saab määrata võtme `-U` parameetri.

Võrdlemise lisavalikud:

- Siin saab anda käsu `diff` lisavõtmed. Üsna levinud on võti `-b`, milel peale `diff` ignoreerib erinevusi tühikute arvus.

Tabulaatori laius võrdlusdialoogis:

- Võrdlemise dialoogis hõlmavad sinu failis või käsu `diff` väljundis leiduvad tabeldusmärgid teatud kindla ruumi. Vaikimisi on selleks kaheksa märgi ruum, kuid siin saab määrata ka muu suuruse.

Väline võrdlemise kasutajaliides:

- Kui kasutad mingeid võrdlusdialoogi avavaid võimalusi, näiteks Vaade Erinevus hoidlast..., kutsub &cervisia; välja välise võrdlemise kasutajaliidese. Kui mõni neist on sulle eriti meelepärane, näiteks Kompare, TkDiff või xxdiff, saad selle siin määrata.

### Olek

Kaughoidla liivakasti avamisel käivitatakse Fail->Olek automaatselt

- Selle märkimisel käivitatakse alati käsk Fail Olek, kui avad liivakasti. Et see käsk võtab veidi aega ning vajab ühendust kaughoidla serverisse (mistõttu ei ole eriti mõttekas võrguühenduse puudumise korral), on vahest parem määrata see kohaliku ja kaughoidla jaoks erinev.

Lokaalhoidla liivakasti avamisel käivitatakse Fail->Olek automaatselt

- Selle sisselülitamisel käivitatakse kohaliku liivakasti avamisel alati käsk Fail Olek.

### Täpsem

Edenemisdialoogi näitamise ajavahemik (millisekundites):

- Sisuliselt kõik liivakastis käivitatud &CVS; käsud, mis puudutavad kaughoidlat, nõuavad ühendust &CVS; serveriga. Seda mõjutab ühenduse kiirus või ka näiteks serveri koormus. Seepärast avab &cervisia; selliste käskude puhul, nagu Vaade Erinevus hoidlast..., dialoogi, mis näitab, et käsku veel täidetakse, ja ühtlasi võimaldab käsu täitmisest loobuda. Lisaks võimaldab dialoog näha &CVS;i veateateid. Et selline dialoog võib muutuda ka tüütavaks, näidatakse seda alles pärast teatud aja möödumist, milleks on vaikimisi 4 sekundit. Siin saab seda aega muuta.

Pakkimise tase vaikimisi:

- `cvs` klient tihendab failid ja paigad, kui peab neid võrgus edastama. Pakkimise taseme seab käsurea võti `-z`. Siin saab määrata &cervisia; seda võtit konkreetsel tasemel kasutama. Siin määratud väärtust kasutatakse ainult vaikimisi, lisaks on hoidlate kaupa võimalik see määrata menüükäsuga Hoidla Hoidlad....

Kasutatakse töötavat või käivitatakse uus ssh-agent protsess

- Märgi see kast, kui kasutad ext (rsh) hoidlaid, &ssh; kaugshelli hoidlaga suhtlemiseks ning programmi ssh-agent oma võtmete haldamiseks.

### Välimus

Protokolliakna font...

- Sellele nupule klõpsates avaneb dialoog Fondi määramine, milles saab valida fondi, mida kasutatakse protokolliaknas. See on aken, mis näitab `cvs` kliendi väljundit.

Annotatsiooniakna font...

- Sellele nupule klõpsates avaneb dialoog Fondi määramine, milles saab valida fondi, mida kasutatakse annotatsioonivaates.

Võrdlemisakna font...

- Sellele nupule klõpsates avaneb dialoog Fondi määramine, milles saab valida fondi, mida kasutatakse võrdlusdialoogides.

Värvid

- Klõps värvinuppudel avab dialoogi Värvi valimine, millega saab määrata värvi, mida kasutatakse peaaknas olekute Konflikt, Kohalik muudatus või Kaugmuudatus ning &cervisia; sisseehitatud võrdlusliideses olekute Võrdluse muudatus, Võrdluse lisamine või Võrdluse kustutamine näitamiseks.

Peaaken poolitatakse rõhtsalt

- &cervisia; peaaken on tavaliselt jagatud vertikaalselt ülal asuvaks failipuuks ja all asuvaks &CVS;-i väljundi osaks. Siin saab aknad korraldada horisontaalselt.

## Lisa

### Ignoreeritavad failid

&cervisia; ei näita oma peamises failipuus sugugi mitte kõiki seal tegelikult leiduvaid faile. See on sarnane käsule `cvs`, aidates ära hoida asjatut segadust, kui vaadet risustavad ebavajalikud asjad, näiteks objektifailid. &cervisia; püüab selles osas võimalikult hästi jäljendada käsku `cvs`, s.t. hankida ignoreeritavate failide nimekirjad järgmistest allikatest:

- Kirjete staatiline nimekiri, kus on sellised elemendid, nagu failid laiendiga `.o` ja `core`. Täpsemat infot leiab &CVS;i käsiraamatust.

- Failist ``$HOME`/.cvsignore`.

- Keskkonnamuutujast `$CVSIGNORE`.

- Failist `.cvsignore` vastavas kataloogis.

`cvs` uurib lisaks veel kirjeid failis ``$CVSROOT`/CVSROOT/cvsignore`, kuid see fail asub serveril ning &cervisia; peab olema võimeline käivituma ka võrguühenduse puudumisel. Kui töötad grupis, mis eelistab kasutada serveril asuvat ignoreeritavate failide nimekirja, on arvatavasti kasulik vaadata üle, mis seal seisab, ning asetada vastavad mustrid oma kodukataloogis faili `.cvsignore`.

### Täiendav info ja abi

- &CVS; pakub põhjalikku dokumentatsiooni infolehekülgede näol, mis kannab nimetust "The Cederqvist". Kui see on korrektselt paigaldatud, saab seda sirvida, kui kirjutada rakenduse kdehelp või khelpcenter asukohareale `info:/cvs`. Samuti võib lihtsalt valida &cervisia; menüükäsu Abi CVSi info. Cederqvisti võib leida ka HTML versioonina internetis.

  Et seda raamatut hooldatakse koos &CVS;iga, kajastab see üldjuhul uusimat infot. Siiski on soovitatav lugeda ka mõningaid muid materjale, kui soovid &CVS;i kasutama õppida, eriti just järgmisi.

- Karl Fogel on kirjutanud suurepärase raamatu Open Source Development with CVS (Vaba tarkvara arendamine CVSi abil). Umbes pool raamatust on pühendatud vaba tarkvara arenamisele. Teine pool kujutab endast &CVS;i tehnilist dokumentatsiooni. Tänuväärsel kombel on raamatu tehniline osa vabalt levitatav vastavalt GPLi tingimustele, nii et selle HTML versiooni võib iga soovija endale ise tõmmata. Ülalmainitud veebileheküljel on saadaval ka vigade nimekiri.

- &CVS;i teemadele on pühendatud omaette meililist.

- Seadistuse haldamisele üldiselt on pühendatud USENETi grupp `comp.software.config-mgmt`. &CVS; on seal suhteliselt kõrvaline teema, kuid seal võib leida vägagi huvitavat materjali teiste versioonikontrolli süsteemide kohta ning nende võrdlust &CVS;iga.

- Ning viimase, kuid sugugi mitte tähtsusetuimana on olemas ka (paraku üsna väheaktiivne) &cervisia; meililist.

### Käskude seletused

#### Menüü Fail

Fail Ava liivakast...

- Avab peaaknas liivakasti. Vaata mainscreen.

Fail Hiljutised liivakastid

- Võimalus avada mõni hiljuti kasutatud liivakastidest.

Fail Lisa ChangeLogi kirje...

- Avab ChangeLogi redaktori, kus saab kohe lisada uue käesoleva kuupäevaga kirje. Vaata committingfiles.

&Ctrl;U Fail Värskenda

- Rakendab valitud failidele käsku 'cvs update' ning muudab vastavalt nende olekut ja versiooninumbrit. Vaata mainscreen.

F5 Fail Olek

- Rakendab valitud failidele käsku 'cvs -n update' ning muudab vastavalt nende olekut ja versiooninumbrit. Vaata mainscreen.

Fail Redigeeri

- Avab valitud faili KDE antud failitüübile määratud vaikeredaktoris.

Fail Lahenda...

- Avab valitud faili dialoogis, kus saab lahendada ühendamisel tekkinud konflikte. Vaata resolvingconflicts.

# Fail Tee sissekanne...

- Võimaldab valitud failid sisse kanda. Vaata committingfiles.

+ Fail Lisa hoidlasse...

- Võimaldab lisada valitud failid hoidlasse. Vaata addingfiles.

Fail Lisa binaarfail...

- Võimaldab lisada valitud failid hoidlasse binaarkujul (`cvs add `-kb``). Vaata addingfiles.

- Fail Eemalda hoidlast...

- Võimaldab eemaldada valitud failid hoidlast. Vaata removingfiles.

Fail Hangi vanem versioon

- Tühistab kõik kohalikus liivakastis valitud faili(de)s tehtud muudatused ning taastab versiooni hoidla põhjal (käsk `cvs update` võtmega `-C`).

&Ctrl;Q Fail Välju

- Lõpetab &cervisia; töö

#### Vaatemenüü

Escape Vaade Peata

- Peatab kõik töötavad alamprotsessid.

&Ctrl;L Vaade Näita logifaili...

- Avab valitud failiversioonide logisirvija. Vaata browsinglogs.

&Ctrl;A Vaade Näita annotatsiooni...

- Näitab valitud faili annotatsioonivaadet, s.t. vaadet, kus iga rea puhul on näha, kes seda viimati redigeeris. Vaata annotate.

&Ctrl;D Vaade Erinevus hoidlast (BASE)...

- Näitab erinevusi liivakastis valitud faili ja viimati värskendatud versiooni (BASE) vahel. Vaata diff.

&Ctrl;D Vaade Erinevus hoidlast (HEAD)...

- Näitab erinevusi livakastis valitud faili ja viimati värskendatud versiooni (HEAD) vahel. Vaata diff.

Vaade Viimane muudatus...

- Näitab erinevusi valitud faili viimati värskendatud versiooni (BASE) ja sellele eelneva versiooni vahel. Vaata diff.

Vaade Ajalugu...

- Näitab &CVS;-i ajalugu, nagu server selle tagastab. Vaata browsinghistory.

Vaade Peida kõik failid

- Valimisel näidatakse peaaknas ainult katalooge. Vaata mainscreen.

Vaade Peida muutmata failid

- Valimisel peidetakse peaaknas tundmatud ja värsked failid. Vaata mainscreen.

Vaade Peida eemaldatud failid

- Valimisel peidetakse peaaknas eemaldatud failid. Vaata mainscreen.

Vaade Peida CVSivälised failid

- Valimisel peidetakse peaaknas failid, mida pole CVS-is. Vaata mainscreen.

Vaade Peida tühjad kataloogid

- Valimisel peidetakse peaaknas nähtavate kirjeteta kataloogid. Vaata mainscreen.

Vaade Rulli failipuu lahti

- Avab failipuu kõik harud, nii et näha on kõik failid ja kataloogid. Vaata mainscreen.

Vaade Rulli failipuu kokku

- Sulgeb failipuu kõik harud. Vaata mainscreen.

#### Menüü Muud

Muud Silt/haru...

- Valitud failidele sildi või haru omistamine. Vaata taggingbranching.

Muud Eemalda silt...

- Eemaldab valitud failidelt konkreetse sildi. Vaata taggingbranching.

Muud Värskenda sildi/kuupäeva järgi...

- Annab valitud failidele konkreetse sildi või kuupäeva, muutes selle kleepuvaks. Vaata updatingto.

Muud Värskenda HEAD-harusse...

- Annab valitud failidele vastava HEAD versiooni. Vaata updatingto.

Muud Ühenda...

- Ühendab konkreetse haru või kahe sildi vahelised muudatused valitud failidesse. Vaata taggingbranching.

Muud Lisa jälgija...

- Lisab jälgija valitud failide sündmustele. Vaata watches.

Muud Eemalda jälgija...

- Eemaldab jälgija valitud failide sündmustelt. Vaata watches.

Muud Näita jälgijaid

- Näitab valitud failide jälgijaid. Vaata watches.

Muud Muuda faile

- Rakendab valitud failidele käsku `cvs edit`. Vaata watches.

Muud Loobu muutustest

- Rakendab valitud failidele käsku `cvs unedit`. Vaata watches.

Muud Näita muutjaid

- Rakendab valitud failidele käsku `cvs editors`. Vaata watches.

Muud Lukusta failid

- Lukustab valitud failid. Vaata locking.

Muud Eemalda lukustus

- Eemaldab valitud failide lukustuse. Vaata locking.

Muud Loo hoidla suhtes paigafail...

- Loob liivakastis tehtud muudatuste põhjal paigafaili. Vaata creatingpatches.

#### Menüü Hoidla

Hoidla Loo...

- Avab dialoogi, mis võimaldab luua uue kohaliku hoidla. Vaata accessing-repository.

Hoidla Tee väljavõte...

- Avab dialoogi, mis võimaldab teha hoidlast mooduli väljavõtte. Vaata checkingout.

Hoidla Impordi...

- Avab dialoogi, mis võimaldab importida paketi hoidlasse. Vaata importing.

Hoidla Hoidlad...

- Võimaldab seadistada sageli kasutatavaid hoidlaid ja juurdepääsu neile. Vaata accessing-repository.

#### Seadistustemenüü

Seadistused Tööriistariba näitamine

- Määrab, kas tööriistariba näidata või mitte.

Seadistused Värskendamisel luuakse kataloogid

- Määrab, kas värskendamisel luuakse liivakastis kataloogid, mida seal varem polnud (käsu `cvs update` võti `-d`).

Seadistused Värskendamisel eemaldatakse tühjad kataloogid

- Määrab, kas värskendamisel eemaldatakse liivakastist tühjad kataloogid (käsu `cvs update` võti `-P`).

Seadistused Rekursiivne värskendamine

- Määrab, kas värskendamine on rekursiivne (käsu `cvs update` võti `-r`).

Seadistused Rekursiivne sissekannete tegemine ja eemaldamine

- Määrab, kas sissekandmised ja eemaldamised on rekursiivsed (vastavalt käsu `cvs add` ja `cvs remove` võti `-r`).

Seadistused Automaatse redigeerimise lubamine (cvs edit)

- Määrab, kas käsku `cvs edit` rakendatakse automaatselt alati, kui faili redigeerid.

Seadistused Kiirklahvide seadistamine...

- Avab kiirklahvide seadistamise dialoogi.

Seadistused Tööriistaribade seadistamine...

- Avab &cervisia; tööriistaribade seadistamise dialoogi.

Seadistused Cervisia seadistamine...

- Avab &cervisia; seadistustedialoogi.

#### Abimenüü

F1 Abi Käsiraamat

- Käivitab KDE abikeskuse &cervisia; käsiraamatuga (sellesamaga, mida praegu loed).

Abi Saada vearaport...

- Avab veateate saatmise dialoogi.

Abi &cervisia; info

- Näitab versiooni ja autorit.

Abi KDE info

- Näitab KDE versiooni ja muud infot.

Abi CVS käsiraamat

- Avab KDE abikeskuses &CVS; infoleheküljed.

## Autorid ja litsents

&underFDL; &underGPL;