начинаем проект под cvs

так как переименование файлов и перемещение их между каталогами слегка неудобно, первое, что вам следует сделать, когда вы начинаете новый проект -- продумать организацию файлов. собственно, перемещать и переименовывать файлы можно, но это, во-первых, увеличивает возможность недопонимания, а во-вторых, у cvs есть некоторые неполадки, например, при переименовании каталогов. see section перемещение и переименование файлов.

дальнейшие действия зависят от конкретной ситуации.

помещение файлов в репозиторий

первым шагом будет создание файлов в репозитории. это может быть сделано несколькими различными способами.

создание дерева каталогов из нескольких файлов

когда вы начнете использовать cvs, вы, скорее всего, уже имеете несколько проектов, которые можно поместить под контроль cvs. в этих случаях самым простым методом будет использование команды import. самым простым объяснением, вероятно, будет привести пример. если файлы, которые вы хотите поместить под cvs, находятся в `wdir', а вы хотите, чтобы они появились в репозитории в каталоге `$cvsroot/yoyodyne/rdir', вы можете сказать:

$ cd wdir
$ cvs import -m "imported sources" yoyodyne/rdir yoyo start

если вы не укажете журнальное сообщение с помощью ключа командной строки `-m', то cvs запустит редактор, в котором можно будет набрать это сообщение. строка `yoyo' -- это тэг производителя, а `start' -- это тэг релиза. в данном контексте они могут не иметь назначения, но cvs требует их присутствия. see section слежение за чужими исходными текстами, за дальнейшей информацией.

теперь вы можете проверить, что все работает и удалить ваш исходный каталог.

$ cd ..
$ mv dir dir.orig
$ cvs checkout yoyodyne/dir       # объяснение следует
$ diff -r dir.orig yoyodyne/dir
$ rm -r dir.orig

было бы неплохо удалить изначальные файлы, чтобы случайно не начать редактировать их в dir без использования cvs. конечно же, перед удалением хорошо было бы убедиться, что у вас есть резервная копия исходных текстов.

команда checkout получает в качестве аргумента имя модуля (как в предыдущих примерах) или имя каталога относительно $cvsroot, как в вышеприведенном примере.

хорошо было бы проверить, что права доступа на созданные cvs каталоги правильны, и что эти каталоги принадлежат должным группам. see section права доступа к файлам.

если какие-то из файлов, которые нужно импортировать, являются бинарными, вам потребуется использовать обертки, чтобы указать, какие именно. see section файл `cvswrappers'.

создание файлов из других систем контроля версий

если у вас есть проект, который обслуживается другой системой контроля версий, например, rcs, вы можете захотеть поместить эти файлы под управление cvs и сохранить историю изменения этих файлов.

из rcs

если вы использовали rcs, найдите все rcs-файлы, обычно файлу `foo.c' будет соответствовать файл `rcs/foo.c,v' (этот файл может также находиться в другом месте, обратитесь к документации на rcs. затем создайте соответствующие каталоги в cvs, если они еще не существуют. затем скопируйте файл в соответствующие каталоги в репозитории (имя в репозитории должно совпадать с именем исходного файла с добавленным `,v'; файлы находятся прямо в соответствующем каталоге репозитория, а не в подкаталоге `rcs/'. это --- один из редких случаев, когда желателен прямой доступ к репозиторию, без использования команд cvs. теперь вы можете извлечь новый рабочий каталог. rcs-файл не должен быть заблокирован, когда вы перемещаете его под управление cvs, иначе у cvs будут проблемы при работе с этим файлом.

из другой системы контроля версий

многие системы контроля версий способны экспортировать rcs-файлы в стандартном формате. если ваша система умеет так делать, экспортируйте rcs-файлы и следуйте вышеприведенным инструкциям. если это не так, вероятно, лучшим выходом будет написать скрипт, который извлекает каждую ревизию файла, используя интерфейс командной строки старой системы, а затем фиксирующий эти ревизии в cvs. скрипт `sccs2rcs', упомянутый ниже, является хорошим примером.

из sccs

в каталоге `contrib/' среди исходных текстов cvs есть скрипт `sccs2rcs', конвертирующий файлы sccs в файлы rcs. замечание: вы должны выполнить этот скрипт на машине, на которой установлен как sccs, так и rcs, и этот скрипт не поддерживается.

из pvcs

в каталоге `contrib/' среди исходных текстов cvs есть скрипт `pvcs_to_rcs', конвертирующий архивы pvcs в файлы rcs. вы должны выполнить этот скрипт на машине, на которой установлены как pvcs, так и rcs, и как и все прочее в каталоге `contrib/', этот скрипт не поддерживается. детали описаны в комментариях к скрипту.

создание дерева каталогов с нуля

для нового проекта самым простым способом, вероятно, будет создать пустую структуру каталогов, например:

$ mkdir tc
$ mkdir tc/man
$ mkdir tc/testing

затем используйте команду import, чтобы создать соответствующую (пустую) структуру каталогов внутри репозитория:

$ cd tc
$ cvs import -m "created directory structure" yoyodyne/dir yoyo start

затем используйте команду add, чтобы добавлять файлы и новые каталог по мере их появления.

убедитесь, что права доступа, которые cvs дает новым каталогам в `$cvsroot', правильны.

определение модуля

следующим шагом будет определение модуля в файле `modules'. это необязательно, но модули удобны для группирования связанных файлов и каталогов.

в простых случаях нижеследующих шагов достаточно для определения модуля.

1. извлеките рабочую копию файла `modules':

   $ cvs checkout cvsroot/modules
   $ cd cvsroot
   

2. отредактируйте этот файл, вставив в него строку, определяющую модуль. см. see section административные файлы. полное описание файла `modules' можно найти в see section файл `modules'. например, для описания модуля `tc' можно использовать такую строку:

   tc   yoyodyne/tc
   

3. зафиксируйте ваши изменения в файле `modules'

   $ cvs commit -m "added the tc module." modules
   

4. освободите модуль cvsroot.

   $ cd ..
   $ cvs release -d cvsroot
   

go to the first, previous, next, last section, table of contents.