cvs

Система управления версиями

Синтаксис:

cvs [ глобальные_опции ] команда [ опции_команды ] [ аргументы ]

Поддерживаемые платформы:

QNX Neutrino, Linux, Microsoft Windows

Опции:

К опциям глобальные_опции относятся следующие:

--allow-root=корн_каталог

Определить действительный каталог CVSROOT (только для сервера).

-a

Выполнять аутентификацию всех соединений (только для клиента).

-b

Определить местоположение RCS (CVS 1.9 и выше).

-d root

Определить каталог CVSROOT.

Примечание
. В ОС Windows утилита cvs проверяет переменные среды в следующем порядке:
  1. HOME

  2. HOMEDRIVE

  3. HOMEPATH

Если эти переменные не заданы, доступ к репозиториям :pserver: отсутствует.

-eредактор

Редактировать сообщения с использованием программы редактор.

-f

Не считывать файл `~/.cvsrc'.

-H
--help

Вывести справочное сообщение.

-l

Не регистрировать в файле CVSROOT/файл истории.

-n

Не изменять файлы.

-Q

Установить строгий режим вывода краткой информации.

-q

Установить нестрогий режим вывода краткой информации.

-r

Установить для новых рабочих файлов режим "только для чтения".

-s переменная=значение

Установить пользовательскую переменную.

-T временный_каталог

Размещать временные файлы в каталоге временный_каталог.

-t

Отслеживать выполнение утилиты CVS.

-v
--version

Показать версию и информацию об авторских правах для CVS.

-w

Установить для новых рабочих файлов режим чтения и записи.

-x

Шифровать все сообщения (только для клиента).

-z уровень_gzip


Установить уровень сжатия (только для клиента).

Описание:

CVS – система управления версиями, которую можно использовать для отслеживания исходных файлов. Далее описаны команды cvs, их опции и аргументы; для получения дополнительной информации см. книгу Version Management with CVS ("Управление версиями с помощью CVS"), автор Пер Седерквист (Per Cederqvist) и др.

Примечание. На данную утилиту распространяются условия общедоступной лицензии GNU Public License (GPL). Она предназначена для использования в системах разработки программ.

add

add [опции] [файлы...]

Добавить новый файл или каталог. Доступны следующие опции:

-k флаг_k

Установить расширение ключевого слова. См. раздел "Подстановка ключевого слова" далее.

-m сообщение


Установить описание файла.

admin

admin [опции] [файлы...]

Эта команда предназначена для управления файлами истории в репозитории. Доступны следующие опции:

-b[редакция]

Установить ветвь по умолчанию.

-cстрока

Установить префикс комментария.

-kподстановка

Настроить подстановку ключевого слова. См. раздел "Подстановка ключевого слова" далее.

-l[редакция]

Блокировать редакцию редакция или последнюю редакцию.

-mредакция:сообщение

Заменить журнальное сообщение редакции редакция на сообщение.

-oдиапазон

Удалить редакции из репозитория.

-q

Режим вывода краткой информации; без вывода диагностических сообщений.

-sсостояние[:редакция]

Установить состояние.

-t

Установить описание файла, полученное из потока стандартного ввода.

-tфайл

Установить описание файла, полученное из файла файл.

-t-строка

Установить описание файла в соответствии со значением строка.

-u[редакция]


Деблокировать редакцию редакция или последнюю редакцию.

annotate

annotate [опции] [файлы...]

Эта команда используется для вывода последней редакции, в которой были изменены все строки. Доступны следующие опции:

-D дата

Аннотировать последнюю редакцию не позже значения дата.

-f

Использовать основную редакцию, если указанный тег или дата не найдены.

-l

Работать локально; только в текущем рабочем каталоге.

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег


Аннотировать редакцию тег.

checkout

checkout [опции] модули...

Получить копию исходных файлов. Доступны следующие опции:

-A

Сбросить любые теги/даты/опции со свойством sticky.

-c

Вывести базу данных модулей.

-D дата

Выгрузить редакции начиная с указанной даты (sticky).

-d каталог

Выгрузить в каталог.

-f

Использовать основную редакцию, если указанный тег или дата не найдены.

-j редакция

Объединить изменения.

-k ключевое_слово_флага

Раскрыть ключевое слово ключевое_слово_флага. См. раздел "Подстановка ключевого слова" далее.

-l

Работать локально; только в текущем рабочем каталоге.

-N

Не сокращать пути модулей, если указана опция -d.

-n

Не выполнять программу модуля (если она существует).

-P

Удалить пустые каталоги.

-p

Выгружать файлы на стандартное устройство вывода (предотвращает получение свойства sticky).

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег

Выгрузить тег редакции (sticky).

-s


Аналогично -c, но включить статус модуля.

commit

commit [опции] [файлы...]


Внести изменения в репозиторий. Доступны следующие опции:

-F файл

Считывать журнальное сообщение из файла файл.

-f

Принудительно применить изменения в файле; рекурсия деактивируется.

-l

Работать локально; только в текущем рабочем каталоге.

-m сообщение

Использовать сообщение сообщение в качестве журнального сообщения.

-n

Не выполнять программу модуля (если она существует).

-R

Обрабатывать рекурсивно (по умолчанию).

-r редакция


Применить изменения к редакции редакция.

diff

diff [опции] [файлы...]

Вывести различия между редакциями. Помимо представленных ниже опций для команды diff доступно большое количество опций, позволяющих управлять форматом вывода, например `-c' для контекстных отличий.

Доступны следующие опции:

-D дата1

Вывести различия по дате рабочего файла и редакции.

-D дата2

Вывести различия редакции редакция1/дата1 и редакции с датой дата2.

-l

Работать локально; только в текущем рабочем каталоге.

-N

Включать различия для добавленных и удаленных файлов.

-R

Обрабатывать рекурсивно (по умолчанию).

-r редакция1

Вывести различия между редакцией редакция1 и рабочим файлом.

-r редакция2

Вывести различия между редакцией редакция1/дата1 и редакцией редакция2.

edit

edit [опции] [файлы...]

Подготовиться к редактированию наблюдаемого файла. Доступны следующие опции:

-a действия

Определить действия для временного наблюдения; аргумент действия принимает значения edit, unedit, commit, all или none.

-l

Работать локально; только в текущем рабочем каталоге.

-R

Обрабатывать рекурсивно (по умолчанию).

editors

editors [опции] [файлы...]

Просмотреть автора изменений в наблюдаемом файле. Доступны следующие опции:

-l

Работать локально; только в текущем рабочем каталоге.

-R


Обрабатывать рекурсивно (по умолчанию).

export

export [опции] модули...

Экспортировать файлы из CVS. Доступны следующие опции:

-D дата

Выгружать версии на дату дата.

-d каталог

Выгружать в каталог.

-f

Использовать основную редакцию, если тег или дата не найдены.

-k флаг_k

Использовать расширение ключевого слова флаг_k. См. раздел "Подстановка ключевого слова" далее.

-l

Работать локально; только в текущем рабочем каталоге.

-N

Не сокращать пути модулей, если указана опция -d.

-n

Не выполнять программу модуля (если она существует).

-P

Удалить пустые каталоги.

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег


Выгрузить тег редакции (sticky).

history

history [опции] [файлы...]

Вывести историю обращений к репозиторию. Доступны следующие опции:

-a

Все пользователи (по умолчанию – только для себя).

-b стр

Вернуться к записи со строкой стр в поле модуля/файла/репозитория.

-c

Сообщать о подтвержденных (измененных) файлах.

-D дата

Начать с даты дата.

-e

Сообщать обо всех типах записей.

-l

Сообщать о последних изменениях (отчет о подтвержденных и измененных).

-m модуль

Сообщать об изменениях для модуля модуль (регулярно).

-n модуль

В модуле модуль.

-o

Сообщать о выгруженных модулях.

-r редакция

Начинать с редакции редакция.

-T

Сформировать отчет по всем тегам.

-t тег

Сообщать об изменениях с момента размещения тега в файле истории (от всех пользователей).

-u пользователь

Сообщать об изменениях для пользователя пользователь (регулярно).

-w

Привести рабочие каталоги в соответствие.

-x типы

Сообщать о типах типы (об одном или нескольких из TOEFWUCGMAR).

-z пояс


Выводить данные для часового пояса пояс.

import

import [опции] репозиторий тег_вендор теги_выпуск...

Импортировать файлы в CVS с использованием соответствующих ветвей вендора. Доступны следующие опции:

-b ветка

Импортировать в ветку вендора ветка.

-d

Использовать время изменения файла в качестве времени импорта.

-k флаг_k

Установить режим подстановки ключевого слова по умолчанию. См. раздел "Подстановка ключевого слова" далее.

-m сообщение

Использовать сообщение сообщение в качестве журнального.

-I игнорировать

Расширить список файлов, которые следует игнорировать (! – для очистки списка).

-W spec

Увеличить количество упаковщиков.

init

init

Создать репозиторий CVS, если он не существует.

log

log [опции] [файлы...]

Вывести историческую информацию о файлах. Доступны следующие опции:

-b

Вывести только редакции для ветви по умолчанию.

-d даты

Определить даты (d1<d2 – диапазон, d – самый крайний срок).

-h

Вывести только заголовок.

-l

Работать локально; только в текущем рабочем каталоге.

-N

Не выводить список тегов.

-R

Выводить только имя RCS-файла.

-rредакции

Выводить только редакции редакции.

-s состояния

Выводить только редакции с указанными состояниями.

-t

Вывести только заголовок и текст описания.

-wпользователи

Вывести только редакции, зарегистрированные указанными пользователями.

login

login


Запросить пароль для сервера аутентификации.

logout

logout


Удалить сохраненный пароль для сервера аутентификации.

rdiff

rdiff [опции] модули...

Вывести различия между выпусками. Доступны следующие опции:

-c

Контекстный формат вывода различий (по умолчанию).

-D дата

Выбрать редакции по дате дата.

-f

Использовать основную редакцию, если тег или дата не найдены.

-l

Работать локально; только в текущем рабочем каталоге.

-R

Обрабатывать рекурсивно (по умолчанию).

-r редакция

Выбрать редакции на основе редакция.

-s

Применить краткое исправление – одна строка на файл.

-t

Показать два последних различия – последнее изменение, внесенное в файл.

-u

Использовать унифицированный формат выдачи различий.

-V версия

Использовать версию RCS версия для расширения ключевого слова (устарело).

release

release [опции] каталог

Указать, что каталог больше не используется. Доступны следующие опции:

-d


Удалить данный каталог.

remove

remove [опции] [файлы...]

Удалить запись из репозитория. Доступны следующие опции:

-f

Удалить файл перед удалением из репозитория.

-l

Работать локально; только в текущем рабочем каталоге.

-R


Обрабатывать рекурсивно (по умолчанию).

rtag

rtag [опции] тег модули...

Добавить к модулям символический тег. Доступны следующие опции:

-a

Убрать единственный тег из удаленных файлов.

-b

Создать ветку с именем тег.

-D дата

Добавить тег в редакции с датой дата.

-d

Удалить данный тег.

-F

Переместить тег, если он уже существует.

-f

Принудительно привести основную редакцию в соответствие, если тег/дата не найдены.

-l

Работать локально; только в текущем рабочем каталоге.

-n

Не выполнять программу с тегом.

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег


Добавить существующий тег тег.

status

status [опции] файлы...

Вывести информацию о статусе в рабочем каталоге. Доступны следующие опции:

-l

Работать локально; только в текущем рабочем каталоге.

-R

Обрабатывать рекурсивно (по умолчанию).

-v


Включить в файл информацию о теге.

tag

tag [опции] тег [файлы...]

Добавить символический тег для выгруженной версии файлов. Доступны следующие опции:

-b

Создать ветку с именем тег.

-D дата

Добавить тег в редакции с датой дата.

-d

Удалить данный тег.

-F

Переместить тег, если он уже существует.

-f

Использовать основную редакцию, если тег или дата не найдены.

-l

Работать локально; только в текущем рабочем каталоге.

-n

Не выполнять программу с тегом.

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег


Добавить существующий тег тег.

unedit

unedit [опции] [файлы...]

Отменить результат команды редактирования. Доступны следующие опции:

-a действия

Определить действия для временного наблюдения; аргумент действия принимает значения edit, unedit, commit, all или none.

-l

Работать локально; только в текущем рабочем каталоге.

-R


Обрабатывать рекурсивно (по умолчанию).

update

update [опции] [файлы...]

Синхронизировать рабочее дерево с репозиторием. Доступны следующие опции:

-A

Сбросить любые теги/даты/опции со свойством sticky.

-D дата

Выгрузить редакции начиная с указанной даты (sticky).

-d

Создать каталоги.

-f

Использовать основную редакцию, если тег или дата не найдены.

-I игнорировать

Расширить список файлов, которые следует игнорировать (! – для очистки списка).

-j редакция

Объединить изменения.

-k флаг_k

Использовать расширение ключевого слова флаг_k. См. раздел "Подстановка ключевого слова" далее.

-l

Работать локально; только в текущем рабочем каталоге.

-P

Удалить пустые каталоги.

-p

Выгружать файлы на стандартное устройство вывода (предотвращает получение свойства sticky).

-R

Обрабатывать рекурсивно (по умолчанию).

-r тег

Выгрузить тег редакции (sticky).

-W spec


Увеличить количество упаковщиков.

watch

watch [on|off|add|remove] [опции] [файлы...]

С помощью команд on/off включается/выключается выгрузка файлов. С помощью команд add/remove добавляется или отменяется уведомление о выполняемых действиях. Доступны следующие опции:

-a действия

Определить действия для временного наблюдения, где аргумент действия принимает значения edit, unedit, commit, all или none.

-l

Работать локально; только в текущем рабочем каталоге.

-R

Обрабатывать рекурсивно (по умолчанию).

watchers

watchers [опции] [файлы...]

Просмотреть наблюдателей файла. Доступны следующие опции:

-l

Работать локально; только в текущем рабочем каталоге.

-R


Обрабатывать рекурсивно (по умолчанию).

Подстановка ключевого слова

Режимы расширения ключевого слова:

-kkv

$Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp $

-kkvl

$Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $

-kk

$Id$

-kv

file1,v 1.1 1993/12/09 03:21:13 joe Exp

-ko

Без расширения.

-kb

Без расширения, двоичный файл.

Ключевые слова:

$Author: joe $

$Date: 1993/12/09 03:21:13 $

$Header: /home/files/file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $

$Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $

$Locker: harry $

$Name: snapshot_1_14 $

$RCSfile: file1,v $

$Revision: 1.1 $

$Source: /home/files/file1,v $

$State: Exp $

$Log: file1,v $

Revision 1.1 1993/12/09 03:30:17 joe

Initial revision


Автор:

Пер Седерквист (Per Cederqvist) и др. Version Management with CVS ("Управление версиями с помощью CVS")

Copyright (C) 1992, 1993 Signum Support AB

Разрешается создавать и распространять точные копии настоящего руководства при условии наличия уведомления об авторском праве и настоящего уведомления о разрешении во всех копиях.

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

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