Увага! Цей переклад дуже застарів, дивіться, будь ласка, оригінал.

Використання CVS

CVS — це програма, що допомагає керувати процесом роботи при одночасному опрацюванні декількома людьми одного й того ж матеріалу. Кожен користувач створює локальну копію головного сховища (репозиторію). Локальні копії можуть знаходитись на тій же машині, чи в будь-якому куточку світу. Користувачі можуть змінювати локальну копію на власний розсуд і, по завершенні внесення змін до матеріалів, фіксувати ці зміни в головному сховищі.

Отримати доступ лише для читання, можна скориставшись веб-frontend'ом. Також, існує багато графічних клієнтів CVS, наприклад, cervisia з KDE. В цьому документі описується процес роботи з утилітою командного рядка, cvs, інші клієнти забезпечують схожу функціональність.

CVS не дозволить зафіксувати зміни в файлі, якщо його копія в головному сховищі була змінена з моменту вашого останнього оновлення. Зазвичай, це не є проблемою, оскільки ви все одно можете оновити локальну копію. Якщо зміни відбулись в частині, відмінній від тієї, над якою працювали ви, вони будуть об'єднані без жодних питань. Якщо ж зміни стосувалися однієї ділянки, то ви будете попереджені про конфлікт та повинні будете відредагувати файл, щоб усунути цю проблему перед подальшою спробою фіксування ваших змін в головному сховищі.

В подальшому в якості прикладу буде використовуватись анонімний доступ. Якщо ви маєте доступ до іншого рахунку, що дає вам право запису до сховища, скористайтесь ним замість анонімного. Якщо ви плануєте робити зміни до сховища, ви спочатку повинні отримати такий рахунок, оскільки анонімним користувачам модифікувати вміст головного сховища не дозволяється. Щоб отримати більше інформації, перегляньте розділ щодо права на запис.

Перед тим як почати використовувати CVS необхідно зареєструватись (login) на CVS-сервері:

   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml login

(просто натисніть enter при вводі пароля)

Для створення копії wml-файлів на вашій локальній машині використовується команда:

   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout webwml

Ви можете скопіювати лише підмножину сторінок, наприклад:

   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout -l \
          webwml webwml/<мова>
   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout \
          webwml/Perl webwml/english/template webwml/<мова>/Pics
   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout \
          webwml/<мова>/<шлях_до_вибраних_файлів>

Повторіть для всіх підтек чи файлів, які вам потрібні. Другий рядок включає всі файли, які вам будуть потрібні, якщо ви хочете створити html-файли з файлів wml. Часткові копіювання, подібні до цього, в загальному випадку не підтримуються, тому ці команди можуть працювати не завжди.

Якщо ви отримали ім'я користувача з паролем, вставте його замість anonymous, приблизно ось так:

   cvs -d :ext:username@cvs.debian.org:/cvs/webwml checkout webwml/english/doc

Після цього вам вже не потрібно буде використовувати в параметрах '-d :ext:...' За бажанням, через кожні кілька днів ви можете запускати

   cvs update -d

щоб оновити ті файли з головного сховища, які за цей час зазнали змін. Параметр -d при оновленні додає всі нові теки автоматично. Також буде здійснено перевірку всіх опущених вами при частковому копіюванні тек — скористайтесь сценарієм cvsup.py, щоб уникнути цього.

Ви також можете створити файл ~/.cvsrc, щоб не додавати деякі опції постійно. Наприклад, в ньому можуть міститись такі рядки:

cvs -z9
update -d -P
diff -u

Подальші рядки призначено тим, хто має право запису до сховища. Якщо ви завершили редагування сторінки, ви можете затвердити ваші зміни на сервері за допомогою команди

   cvs commit <файл>.wml

чи

   cvs commit <тека>    (для затвердження всіх змін в <теці>)

чи

   cvs commit          (внести всі зміни в поточній теці та нижче)

Якщо ви перекладаєте сторінку першим, ви повинні виконати

   cvs add <файл>.wml

перед тим, як підтверджувати зміни в ньому. Зауважте, що команда cvs add не є рекурсивною, ви повинні додати теку перед тим, як займатись її вмістом.

Щоб отримати більше інформації про CVS, скористайтесь info cvs.

Доступ до CVS з правом запису

Якщо ви хочете отримати доступ до CVS з правом запису, приєднуйтесь до проекту webwml на Alioth. Щоб ознайомитись з вказівками щодо того, як здобути доступ до CVS з правом запису, перегляньте http://people.debian.org/~joey/misc/webwml.html.