natgillin/translations-raw huggingface dataset:
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.
Просте встановлення мітки — це те, що ви зазвичай робите під час створення випуску. Це потрібно для того, що ви могли будь- коли повернутися до стану проекту у відповідний час. Міткам, зазвичай, надають назви, у яких вказують назву проекту і номер версії. Наприклад, доступ до & cervisia; 1. 0 можна отримати за міткою CERVISIA_ 1_ 0. & cervisia; повністю виконує строгі правила & CVS; щодо побудови коректної назви мітки. Назва має починатися з літери і може містити літери, цифри, дефіси і символи підкреслювання.
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.
Зазвичай, у вас має виникнути потреба у створенні мітки для всього проекту (хоча, звичайно ж, & CVS; надає вам змогу створити мітку для підмножини списку файлів). Для прикладу, позначте теку верхнього рівня у області перегляду і скористайтеся пунктом меню Додаткові Мітка/ Гілка. Після цього введіть назву мітки, натисніть клавішу Enter, ось і все.
Creating a branch is not significantly more difficult: In the tag dialog, check the box Create branch with this tag. You can also delete an existing tag: Choose Advanced Delete Tag in the main view.
Створення гілки нічим не складніше: у діалоговому вікні позначте пункт Створити гілку з цією міткою. Крім того, ви можете вилучити існуючу мітку: скористайтеся пунктом меню Додаткові Вилучити мітку у основному вікні програми.
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 dialog that appears now gives you two options:
Іншим аспектом створення гілок є об’ єднання версій з певної гілки та поточної гілки. Якщо ви маєте намір виконати таке об’ єднання, скористайтеся пунктом меню Додаткові Об’ єднати.... У діалоговому вікні, яке відкриється, ви зможете обрати один з двох варіантів:
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
Ви можете об’ єднати всі зміни, внесені у гілці, до поточної гілки. У такому випадку позначте пункт Об’ єднати з гілок і вкажіть гілку, з якою ви бажаєте виконати об’ єднання. & cervisia; виконає команду
cvs update -j branchtag
cvs update - j мітка_ гілки
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
Іншим варіантом застосування є випадок, коли у вас виникне бажання об’ єднати лише зміни, які було внесено між двома мітками у гілці. Таке зазвичай трапляється, якщо ви виконуєте об’ єднання між однією гілкою і дослідною гілкою декілька разів. У такому випадку позначте пункт Об’ єднати зміни і введіть (у правильному порядку) дві відповідних гілки. Програма виконає команду
cvs update -j branchtag1 -j branchtag2
cvs update - j мітка_ гілки_ 1 - j мітка_ гілки_ 2
Using Watches
Користування спостерігачами
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.
Спостерігач — це загальноприйнята назва для функціональної можливості & CVS;, використання якої надає користувачам сховища змогу дізнаватися про зміну певного файла або про те, що розробник почав редагування файла. Використання спостерігачів потребує того, щоб файл $CVSROOT / CVSROOT/ notify було налаштовано належним чином. Це налаштування ми не будемо тут обговорювати, якщо вам потрібні додаткові відомості щодо налаштування з точки зору адміністратора, прочитайте одну з книжок, назви яких наведено у додатку.
& cervisia; 's main support of watches are six menu items.
Для забезпечення підтримки спостереження & cervisia; існує шість пунктів меню.
In order to add a watch to one or several files, use Advanced Add Watch.... In the dialog 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 dialog is
Щоб додати спостерігач до одного або декількох файлів, скористайтеся Додаткові Додати спостерігачів.... За допомогою діалогового вікна, яке буде відкрито, ви зможете обрати тип події, які підтримує & CVS; і про яку має сповіщати вас & CVS;. Наприклад, якщо ви бажаєте, щоб програма сповіщала вас лише про ті випадки, коли файл було передано, позначте пункти Тільки і Передачі. Якщо ви бажаєте отримувати сповіщення про будь- яку подію, яка стосується позначених файлів, позначте пункт Все. Після натискання кнопки Гаразд програма виконає таку команду:
cvs watch add -a commit file names
cvs watch add - a commit назви файлів
or with a similar option, depending on the events you chose to watch.
або подібний параметр, який залежить від подій, які ви обрали для перегляду.
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 dialog you get here, the same options are offered as in the form you filled out when adding the watch. When you confirm this dialog, & cervisia; issues the command
Якщо ви більше не цікавитеся змінами у певних файлах, ви можете вилучити спостерігачі для цих файлів. Для цього можна скористатися пунктом меню Додаткові Вилучити спостерігача.... У діалоговому вікні, яке буде відкрито, ви побачите ті самі пункти, які ви вже бачили, коли додавали спостерігача. Після натискання кнопки Гаразд & cervisia; виконає таку команду:
cvs watch remove file names
cvs watch remove назви файлів
possibly with an option -a for the chosen events.
можливо, з параметром - 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
Нарешті, ви можете отримати список людей, які спостерігають за файлами. Скористайтеся пунктом Додаткові Показати спостерігачів. За допомогою цього пункту меню ви можете наказати програмі виконати таку команду:
cvs watchers file names
cvs watchers назви файлів
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; кожен з розробників окремо працює над власною звантаженою пісочницею. Якщо розробник бажає змінити якийсь з файлів, він може відкрити його у власному редакторі і почати з ним працювати. Ніхто інший не дізнається про роботу, виконану цим розробником, до того часу, коли файл буде передано до сховища.
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 Files. This will execute the command
Для деяких груп розробників така модель є не зовсім прийнятною моделлю співпраці. Розробники у таких групах бажали б бути сповіщеними про те, що хтось працює над файлом одразу після того, як розробник почне роботу над файлом. Цього можна досягти за допомогою додаткових команд & CVS;. Перш ніж почати редагування певного файла, позначте його у головному вікні & cervisia; і скористайтеся пунктом меню Додаткові Редагувати файли. У відповідь програма виконає таку команду:
cvs edit file names
cvs edit назви файлів
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
Ця команда надішле сповіщення всім, хто обрав спостерігач зміни для цього файла. Крім того, ця команда зареєструє вас як редактора відповідного файла. Ви можете отримати список всіх редакторів певного файла за допомогою пункту меню Додаткові Показати редакторів. Використання цього пункту меню рівноцінне виконанню такої команди:
cvs editors file names
cvs editors назви файлів
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 Files. 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 Files will be lost. Precisely, & cervisia; uses the command line
Сеанс редагування буде автоматично завершено після передавання файла, який редагує розробник. Після цього всім користувачам, які зареєстрували спостерігачі для файла, буде надіслано сповіщення про завершення редагування. Звичайно ж, іноді ви передумаєте передавати файл, перервати сеанс редагування і повернутися до попередньої версії файла. Досягти цього можна за допомогою пункту меню Додаткові Закінчити редагування. Зауважте, що & cervisia; не запитуватиме у вас підтвердження. Це означає, що якщо ви скористаєтеся цим пунктом меню, всію роботу, виконану з часу вибору пункту меню Додаткові Редагувати файли буде втрачено. Якщо бути точним, & cervisia; виконає таку команду:
echo y _BAR_ cvs unedit file names
echo y _BAR_ cvs unedit назви файлів
So far, we have only 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 Files, the file becomes writable. It is made read-only again when you commit the file or use Advanced Unedit Files.
Вище ми обговорювали лише випадок, коли встановлення міток редагування або завершення редагування відбувається розробниками у добровільному порядку. Крім того, & CVS; підтримує модель, за використання якої користування цими командами є примусовим. Відповідною командою, призначеною для вмикання такої моделі, є cvs watch on. Ми не будемо докладно обговорювати цю команду, оскільки здебільшого цією командою користуються адміністратори сховища. Важливою особливістю з точки зору розробника є те, що, коли у проекті примусово використовуються позначки редагування, робочі копії звантажуються як придатні лише для читання. Це означає, що, типово, ви не зможете редагувати файл (якщо не скористаєтеся трюками на зразок chmod). Лише після того, як ви скористаєтеся пунктом меню Додаткові Редагувати файли, файл стане придатним для запису. Файл знову стане придатним лише для читання після того, як ви передасте файл або скористаєтеся пунктом меню Додаткові Закінчити редагування.
& 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; передбачено і інший спосіб, який допоможе вам працювати з проектами, у яких використовують примусове встановлення міток редагування. Якщо ви тільки- но запустили редактор для файла, позначеного лише для читання, подвійним клацанням лівою кнопкою миші або за допомогою пункту меню Файл Правка, ви не зможете згодом зберегти внесені вами зміни. Звичайно ж, для цього є причина: кожного разу, коли ви бажаєте змінити файл, вам слід спочатку виконати команду cvs edit, щоб усі люди, які спостерігали за файлом, отримали сповіщення про те, що ви працюєте над цим файлом.
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.
У такому випадку радимо вам позначити пункт меню Параметри За потреби виконати cvs edit автоматично. Якщо ви це зробите, кожного разу, коли ви викликатимете вікно редагування файла подвійним клацанням лівою кнопкою миші на його позначці, & cervisia; виконуватиме команду cvs edit, перш ніж запускати редактор. Після цього ви зможете редагувати файл у звичайному режимі. Після завершення редагування ви зможете надіслати змінені файли, — у сховищі вони знову стануть придатними лише для читання.
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;, називається необмеженими звантаженнями. Кожен з розробників має власну пісочницю, у якій він або вона може редагувати файли, як йому чи їй заманеться. Якщо після цього ви скористаєтеся можливостями спостереження, — зокрема cvs edit, — над файлами можуть синхронно працювати декілька розробників. Зміни, внесені іншим розробником, буде об’ єднано з локальною пісочницею під час виконання наступного оновлення.
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 cannot 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 organizational 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.
У інших системах керування версіями, — зокрема RCS і SourceSafe використовується інша модель. Якщо розробник бажає змінити певний файл, він має заблокувати його. Блокувати певний файл може одночасно лише один розробник. Після завершення редагування блокування буде знято. З іншого боку, за використання цієї моделі конфлікти ніколи не трапляться. З іншого боку, над файлом не можуть працювати одразу декілька розробників, навіть якщо внесені ними зміни не впливатимуть одна на одну. Це може значно сповільнити розробку. Ми не будемо обговорювати всі організаційні переваги обох підходів. Крім того, ми вже згадували, що хоча у & CVS; і передбачено певну підтримку блокування, — цей спосіб не є основним способом роботи з & CVS;. Вам не слід використовувати всі ці можливості, якщо ви не впевнені, що ваш інструмент керування проектом їх підтримує.
With & cervisia;, you lock files as follows. Select the desired files in the main view. Then choose Advanced Lock Files. This runs the command
За допомогою & cervisia; ви можете заблокувати файли. Оберіть бажані файли у головній області перегляду програми. Скористайтеся пунктом меню Додаткові Заблокувати файли. Програма виконає команду
cvs admin -l file names
cvs admin - l назви файлів
The reverse effect is achieved by using Advanced Unlock Files. This runs the command
Зворотного ефекту можна досягти за допомогою пункту меню Додаткові Розблокувати файли. Програма виконає команду
cvs admin -u file names
cvs admin - u назви файлів
Customizing & cervisia;
Налаштування & cervisia;
& cervisia; can be customized in various ways to your needs and preferences. Some options which you may want to change regularly are directly available in the Settings menu.
У & cervisia; передбачено можливість налаштування програми у різні способи згідно до ваших потреб і уподобань. Деякі з параметрів, потреба у зміні яких може у вас виникнути, може бути безпосередньо змінено за допомогою меню Параметри.
User name for the change log editor:
Ім' я користувача для редактора файла змін:
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; automatically adds the full name and email address entered here.
Кожного разу, коли ви користуватиметеся пунктом меню Файл Вставити запис до файла змін..., програма створюватиме новий запис у файлі ChangeLog за поточною датою і з вашим іменем користувача. Зазвичай, вважається ознакою доброго смаку додавати ваше ім’ я повністю і вашу адресу електронної пошти до кожного з ваших записів у файлі ChangeLog. & cervisia; автоматично додасть ваше ім’ я і адресу електронної пошти, введені у цьому вікні.
Path to CVS executable, or'cvs':
Шлях до файла програми CVS або '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;.
Тут ви можете вказати назву (або шлях) клієнта командного рядка cvs. Типово, & cervisia; буде використано виконуваний файл & CVS;, який буде знайдено за шляхом, вказаним змінною середовища $PATH.
Diff Viewer
Перегляд різниці
Number of context lines in the diff dialog:
Кількість рядків в діалозі порівняння:
For the diff dialog, & 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; використовує параметр - U, переданий команді diff. За його використання diff покаже лише обмежену кількість рядків навколо кожного з діапазонів відмінностей (рядків контексту). Тут ви можете вказати аргумент параметра - U.
Additional options for cvs diff:
Додаткові параметри для cvs- порівняння:
Here you can add additional arguments to the diff. A popular example is -b which lets diff ignore changes in the amount of whitespace.
Тут ви можете вказати додаткові аргументи для команди diff. Поширеним прикладом є параметр - b, за використання якого diff ігнорувати зміни у кількості пробілів.
Tab width in diff dialog:
Ширина вкладки у діалозі порівняння:
In the diff dialog, 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.
У діалоговому вікні відмінностей символи табуляції, які міститимуться у вашому файлі або у виводі команди diff, буде розгорнуто до фіксованої кількості символів пробілу. Типово, кожен символ табуляції буде замінено вісьмома пробілами, але ви можете змінити це значення.
External diff frontend:
Зовнішня оболонка для diff:
When you use any of the features which show the diff dialog, 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.
Коли ви користуєтеся будь- якою з функціональних можливостей, які відкривають діалогове вікно відмінностей, зокрема пунктом меню Перегляд Відмінність від сховища..., & cervisia; викликає свою вбудовану оболонку diff. Якщо ви бажаєте скористатися іншою оболонкою, на зразок & kompare;, TkDiff або xxdiff, ви можете ввести у це поле назву файла і шлях для нього.
When opening a sandbox from a remote repository, start a File-gt; Status command automatically
Під час відкриття пісочниці з віддаленого сховища автоматично запускати команду, яка відповідає пункту меню Файл- gt; Стан
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).
Якщо ви позначите цей пункт, кожного разу, коли ви відкриватимете віддалену пісочницю, програма виконуватиме команду, яка виконується пунктом меню Файл Стан. Виконання цієї команди може тривати певний час, а також потребує з’ єднання з сервером для віддалених сховищ (що робить її непридатною для автономного використання).
When opening a sandbox from a local repository, start a File-gt; Status command automatically
Коли відкривається пісочниця з віддаленого сховища, автоматично запускати команду Файл- gt; Стан
When you check this option, the File Status command is started whenever you open a local sandbox.
Якщо ви позначите цей пункт, вибір пункту меню Файл Стан буде виконано кожного разу, коли ви відкриватимете локальну пісочницю.
Timeout after which a progress dialog appears (in ms):
Тайм- аут, після якого з' являється діалогове вікно поступу (в мс):
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 dialog which indicates that the command is still running and which allows you to abort it. Furthermore, this dialog is used to show you error messages from & CVS;. As this dialog 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.
Практично всі команди & CVS;, запущені у пісочниці, яка належить віддаленому сховищу, потребує з’ єднання з сервером & CVS;. На їх виконання може вплинути затримка у мережевому з’ єднанні або високе навантаження на сервер. З цієї причини, для команд на зразок Перегляд Відмінність від сховища... & cervisia; відкриває діалогове вікно, у якому повідомляє вам про те, що команда все ще виконується, і надає вам змогу перервати її виконання. Крім того, у цьому діалоговому вікні буде показано повідомлення про помилку від & CVS;. Оскільки це діалогове вікно може з часом вам набриднути, його буде показано лише після певного проміжку часу, типово, 4 секунд. За допомогою цього поля ви можете змінити це значення.
Default compression level:
Типовий рівень стиснення: