natgillin/translations-raw huggingface dataset:
We discuss here only the technical aspects of tagging and branching. If you are only a user, not the administrator of the repository, you will probably not be confronted with the problem. If however you are your own administrator, you should first read about the non-technical problems that accompany branching, in order to get an impression of how time-consuming and error-prone maintaining different branches of a project can be. The appendix includes some references about this topic.
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.
Simple tagging is something you usually do when a release is made, so that you can at any time easily get back to the project state at that time. Tags are usually given a name consisting of the project name and the version number. For example, & cervisia; 1.0 is available under the tag CERVISIA_1_0. & cervisia; enforces & CVS; 's strict rules about what constitutes valid tag name. It must begin with a letter and may contain letters, digits, hyphens and underscores.
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.
Normally, you will want to tag the whole project (although & CVS; of course allows you to tag only a subset). To this end, mark the toplevel folder in the view and choose Advanced Tag/ Branch. Now enter the name of the tag, press Return and you are done.
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!
Creating a branch is not significantly more difficult: In the tag dialogue, check the box Create branch with this tag. You can also delete an existing tag: Choose Advanced Delete Tag in the main view.
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.
Another aspect of branching is the merging of modifications from a branch to the current branch. If you are going to do this, choose Advanced Merge.... The dialogue that appears now gives you two options:
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:
Either you may merge all modifications done on a branch to the current branch. In that case, check the box Merge from branch and fill in the branch you want to merge from. & cervisia; will then execute the command
Ü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 branchtag
cvs update - j haru_ loomise_ kuupäev
The other possibility is that you want to merge only the modifications made between two tags on a branch. This usually happens when you merge from the same branch to the trunk several times. In that case, check the box Merge modifications and enter (in the correct order) the two relevant tags. This will result in a command
Ü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 branchtag1 -j branchtag2
cvs update - j haru_ loomise_ kuupäev1 - j haru_ loomise_ kuupäev2
Using Watches
Jälgijate kasutamine
A watch is the conventional name for & CVS; 's feature to notify users of the repository whenever a file has been changed or a developer has started editing a file. The usage of watches requires that the file $CVSROOT / CVSROOT/ notify has been set up properly. This is not discussed here; if you need further information on the setup from the administrator 's point of view, read one of the books listed in the appendix.
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; 's main support of watches are six menu items.
& cervisia; tugi jälgijatele koosneb põhiliselt kuuest menüükäsust.
In order to add a watch to one or several files, use Advanced Add Watch.... In the dialogue you get, you can choose to get notified for any of the types of events that & CVS; supports. For example, if you only want to get notified when a file is committed, check the boxes Only and Commits. If you want to get notified about any event related to the marked files, check the box All. The command line used when you accept the dialogue is
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 file names
cvs watch add - a commit failinimed
or with a similar option, depending on the events you chose to watch.
või mõne muu sarnase võtmega vastavalt sellele, millise sündmuse valid.
If you are not interested in some files anymore, you can remove your watches on them. To this end, use Advanced Remove Watch.... In the dialogue you get here, the same options are offered as in the form you filled out when adding the watch. When you confirm this dialogue, & cervisia; issues the command
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 file names
cvs watch remove failinimed
possibly with an option -a for the chosen events.
(võimalik on lisada valitud sündmuste jaoks võti - a).
Finally, you can get a list of the people who are watching a couple of files. Choose Advanced Show Watchers. Using this menu item will result in a command
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 file names
cvs watchers failinimed
In the normal usage scenario of & CVS;, each developer works separately in his checked out sandbox. When he wants to modify some file, he can just open it in his editor and start working on it. Nobody else will know about this work until the file gets committed.
& 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.
For some developer groups, this is not the preferred model of cooperation. They want to get notified about someone working on a file as soon as he starts with it. This can be achieved by some further & CVS; commands. Before you start editing a file, select it in & cervisia; 's main window and choose Advanced Edit. This will execute the command
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 file names
cvs edit failinimed
This will send out a notification to everyone who has set an edit watch on this file. It will also register you as an editor of the file. You can obtain a list of all editors of a certain file by using Advanced Show Editors. This is equivalent to typing on the command line
Ü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 file names
cvs editors failinimed
An editing session is automatically ended when you commit the affected file. At that moment, an unedit notification gets sent out to all people who have registered a respective watch on the file. Of course, sometimes you may not want to commit the file, but abort the editing session and revert to the previous version of the file. This is done by using Advanced Unedit. Note that & cervisia; will not ask you for confirmation; that means if you use this menu item, all your work done since you used Advanced Edit will be lost. Precisely, & cervisia; uses the command line
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 _BAR_ cvs unedit file names
echo y _BAR_ cvs unedit failinimed
So far, we have only the discussed the case where edits and unedits are used voluntarily be the developers. In addition & CVS; supports a model which enforces the usage of these commands. The responsible command to switch to this model is cvs watch on which we will not explain further because it is mostly used by the administrator of the repository. However, the important point from the developer 's point of view is that when the project enforces edits, working copies are checked out readonly. That means you cannot edit a file by default (unless you use tricks like chmod). Only when you use Advanced Edit, the file becomes writable. It is made read-only again when you commit the file or use Advanced Unedit.
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 kirjutuskaitstult (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; 's editor interface helps you with projects that enforce watches also in a different way. If you just started an editor with a readonly file by double-clicking on it or by using File Edit, you would not be able to save your modifications later. This has of course a reason: Whenever you want to change a file, you should run cvs edit before, so that all people watching the file get a notification that you are working on it.
& 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.
In such a case, it is advisable to check the option Settings Do cvs edit Automatically When Necessary. Now, whenever you edit a file by double-clicking it, & cervisia; will run cvs edit before the editor is actually executed. Then you can edit your file as usual. When you have finished your work, commit your files, and the committed files are read-only again.
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.
The development model usually followed when & CVS; is used is called unreserved checkouts. Each developer has his own sandbox where he can edit files as he likes. If when the watch features - like cvs edit - are used, multiple developers can work on files synchronously. Changes done by a different developer are merged into the local sandbox when an update is performed.
& 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.
Other revision control systems - like RCS and SourceSafe use a different model. When a developer wants to a edit a file, he has to lock it. Only one developer at a time can a lock a file. When he has finished editing, the lock is released. On the one hand, with this model, conflicts can never happen. On the other hand, two developers can not work on the same file at the same time, even when their changes do not affect each other. This can be a bottleneck. We are not going to discuss the organisational benefits of both approaches. Nevertheless we mention that although & CVS; has some support for locking, it is not the preferred way of working with & CVS;. You should not use these features unless you are sure that your project manager allows them.
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.
With & cervisia;, you lock files as follows. Select the desired files in the main view. Then choose Advanced Lock. This runs the command
& 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 file names
cvs admin - l failinimed
The reverse effect is achieved by using Advanced Unlock. This runs the command
Vastupidise toimingu sooritamiseks kasuta menüükäsku Muud Eemalda lukustus. See annab käsu
cvs admin -u file names
cvs admin - u failinimed
Customising & cervisia;
& cervisia; seadistamine
& cervisia; can be customised in various ways to your needs and preferences. Some options which you may want to change regularly are directly available in the Settings menu. Others are united in a common dialogue which is available via Option Settings....
& 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.
User name for the ChangeLog editor:
Kasutaja andmed ChangeLog failis:
Whenever you use the menu item File Insert ChangeLog Entry..., a new ChangeLog entry is generated with the current date and your username. Normally, it is considered good style to insert your full name and your email address into each of your ChangeLog entries. & cervisia; add automatically the full name and email address entered here.
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.
Path to cvs executable, or 'cvs ':
CVS- i rakenduse asukoht või 'cvs':
Here you can set the name (or path) to the cvs command line client. By default, the & CVS; executable found in your $PATH is used by & cervisia;.
Siin saab määrata cvs käsureakliendi nime või otsingutee. Vaikimisi kasutab & cervisia; & CVS; - i käivitatavat faili, mis asub sinu otsinguteel ($PATH).
Diff Viewer
Võrdluse näitaja
Number of context lines in the diff dialogue:
Kontekstiridade arv võrdlemise dialoogis:
For the diff dialogue, & cervisia; uses the option -U to diff. This lets diff show only a limited number of lines around each difference region (context lines). Here you can set the argument to -U.
& 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.
Additional options for cvs diff:
Võrdlemise lisavalikud:
Here you can add additional arguments to the diff. A popular example is -b which lets diff ignore changes in the amount of whitespace.
Siin saab anda käsu diff lisavõtmed. Üsna levinud on võti - b, milel peale diff ignoreerib erinevusi tühikute arvus.
Tab width in diff dialogue:
Tabulaatori laius võrdlusdialoogis:
In the diff dialogue, tab characters present in your file or in the output of the diff command are expanded into a fixed number of space characters. By default, each tab is replaced by eight spaces, but here you can setup a different number.
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.
External diff frontend:
Väline võrdlemise kasutajaliides:
When you use any of the features which show the diff dialogue, like View Difference to Repository..., & cervisia; invokes its internal diff frontend. If you prefer a different one, like Kompare, TkDiff or xxdiff, enter its file name and path here.
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.
When opening a sandbox from a remote repository, start a File-gt; Status command automatically
Kaughoidla liivakasti avamisel käivitatakse Fail- gt; Olek automaatselt
When you check this option, the File Status command is started whenever you open a remote sandbox. This command may need some time and also needs a connection to the server for remote repositories (making it unusable for offline usage).
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.
When opening a sandbox from a local repository, start a File-gt; Status command automatically
Lokaalhoidla liivakasti avamisel käivitatakse Fail- gt; Olek automaatselt
When you check this option, the File Status command is started whenever you open a local sandbox.
Selle sisselülitamisel käivitatakse kohaliku liivakasti avamisel alati käsk Fail Olek.
Advanced
Täpsem
Timeout after which a progress dialogue appears (in ms):
Edenemisdialoogi näitamise ajavahemik (millisekundites):
Practically all & CVS; commands started in a sandbox which belongs to a remote repository need a connection to the & CVS; server. This is affected by delays from the network connection or a high load on the server. For this reason, for commands like View Difference to Repository... & cervisia; opens a dialogue which indicates that the command is still running and which allows you to abort it. Furthermore, this dialogue is used to show you error messages from & CVS;. As this dialogue may become annoying after some time, it is shown only after a certain timeout which is 4 seconds by default. Here you can change this value.
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.
Default compression level:
Pakkimise tase vaikimisi:
The cvs client compresses files and patches when they are transferred over a network. With the command line option -z, the compression level can be set. You can setup & cervisia; to use this option by configuring the level here. The value set here is used only as a default; additionally there is a per-repository setting available in Repository Repositories....
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....
Utilise a running or start a new ssh-agent process
Kasutatakse töötavat või käivitatakse uus ssh- agent protsess
Check this box if you use ext (rsh) repositories, the & ssh; remote shell to communicate with the repository and ssh-agent to manage your keys.
Märgi see kast, kui kasutad ext (rsh;) hoidlaid, & ssh; kaugshelli hoidlaga suhtlemiseks ning programmi ssh- agent oma võtmete haldamiseks.
Font for protocol window...
Protokolliakna font...
Press this button to open the Set Font dialogue, to set the font used in the protocol window (this is the window showing the output of the cvs client).
Sellele nupule klõpsates avaneb dialoog Fondi valik, milles saab valida fondi, mida kasutatakse protokolliaknas. See on aken, mis näitab cvs kliendi väljundit.
Font for annotate view...
Annotatsiooniakna font...
Press this button to open the Set Font dialogue, to set the font used in the annotate view.
Sellele nupule klõpsates avaneb dialoog Fondi valik, milles saab valida fondi, mida kasutatakse annotatsioonivaates.
Font for diff view...
Võrdlemisakna font...
Press this button to open the Set Font dialogue, to set the font used in diff dialogs.
Sellele nupule klõpsates avaneb dialoog Fondi valik, milles saab valida fondi, mida kasutatakse võrdlusdialoogides.