Краткий справочник по командам CVS | CVS

В этом приложении описано, как вызывать CVS, со ссылками на места в руководстве, где детально описана каждая возможность. Дополнительную информацию можно получить, выполнив cvs --help или изучив section Индекс.

Команда CVS выглядит так:

cvs [ global_options ] command [ command_options ] [ command_args ]

Глобальные ключи:

--allow-root=rootdir: Разрешает использование каталога CVSROOT (только для сервера) (не реализовано в @cvsver{1.9} и ранее). См. section Настройка сервера для парольной аутентификации.
-a: Аутентифицировать все взаимодействие (только для клиента) (не реализовано в @cvsver{1.9} и ранее). См. section Глобальные ключи командной строки.
-b: Задает местонахождение программ RCS (@cvsver{1.9} и ранее). См. section Глобальные ключи командной строки.
-d root: Задает CVSROOT. См. section Репозиторий.
-e редактор: Редактировать сообщение с помощью редактора. См. section Фиксирование изменений.
-f: Не читать файл `~/.cvsrc'. См. section Глобальные ключи командной строки.
-H
--help: Выдает справочное сообщение. См. section Глобальные ключи командной строки.
-l: Не журналировать команду в файле `CVSROOT/history'. См. section Глобальные ключи командной строки.
-n: Не изменять файлы на диске. См. section Глобальные ключи командной строки.
-Q: Совсем не выдавать сообщений. См. section Глобальные ключи командной строки.
-q: Почти совсем не выдавать сообщений. См. section Глобальные ключи командной строки.
-r: Создавать новые рабочие файлы в режиме "только для чтения". См. section Глобальные ключи командной строки.
-s variable=value: Установить пользовательскую переменную. См. section Подстановки в административных файлах.
-T tempdir: Создавать временные файлы в каталоге tempdir. См. section Глобальные ключи командной строки.
-t: Отслеживать ход выполнения CVS. См. section Глобальные ключи командной строки.
-v
--version: Напечатать информацию об версии программы CVS и авторских правах.
-w: Создавать новые рабочие файлы в режиме для чтения и записи. См. section Глобальные ключи командной строки.
-x: Шифровать все переговоры с сервером (только для клиента). См. section Глобальные ключи командной строки.
-z gzip-level: Установить коэффициент сжатия (только для клиента).

Режимы подстановки ключевых слов (see section Режимы подстановки):

-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 не подставлять, файл является двоичным

Ключевые слова (see section Список ключевых слов):

$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

Команды, их ключи и параметры:

@macro short-option-a

-a actions Задает действия, за которыми нужно следить. actions может быть edit, unedit, commit, all или none. См. section Как редактировать файлы, за которыми наблюдают?. @macro short-option-f

-f Использовать головную ревизию (HEAD), если не найдено указанной метки или даты. См. section Стандартные ключи командной строки. @macro short-option-k

-k kflag Задать режим подстановки ключевых слов. См. section Подстановка ключевых слов. @macro short-option-l

-l Работать только в текущем каталоге. See section Рекурсивное поведение. @macro short-option-N

-N Не обрезать пути к модулям, если задан ключ `-d'. См. section Ключи команды checkout. @macro short-option-R

-R Рекурсивно обходить дерево каталогов (по умолчанию это именно так). See section Рекурсивное поведение.

add [options] [files...]

Добавить новый файл или каталог. См. section Добавление файлов в каталог.

-m msg: Задать описание файла.

admin [options] [files...]

Административные функции файлов истории версий в репозитории. См. section Команда admin: администрирование.

-b[rev]: Установить ветку по умолчанию. См. section Возврат к последней версии от поставщика.
-cstring: Задать префикс комментария. @short-option-k
-l[rev]: Блокировать ревизию rev или последнюю ревизию.
-mrev:msg: Заменить журнальную запись ревизии rev сообщением msg.
-orange: Удалить ревизии из репозитория. См. section Ключи команды admin.
-q: Выполнять команды, не выдавая сообщений.
-sstate[:rev]: Установить состояние ревизии.
-t: Получить описание файла со стандартного ввода.
-tfile: Получить описание файла из file.
-t-string: Установить описание файла в string.
-u[rev]: Разблокировать ревизию rev или последнюю ревизию.

annotate [options] [files...]

Для каждой строки показать последнюю ревизию, когда она была изменена. См. section Команда annotate.

-D date: Аннотировать самую последнюю ревизию, созданную не позже date. См. section Стандартные ключи командной строки. @short-option-f @short-option-l @short-option-R
-r tag: Аннотировать ревизию tag. См. section Стандартные ключи командной строки.

checkout [options] modules...

Извлечь копию исходных текстов. См. section Команда checkout: извлечение исходных текстов для редактирования.

-c: Напечатать содержимое базы данных модулей. См. section Ключи команды checkout.
-D date: Извлечь ревизии, датированные date (это липкий ключ). См. section Стандартные ключи командной строки.
-d dir: Извлекать в каталог dir. См. section Ключи команды checkout. @short-option-f
-j rev: Слить изменения. См. section Ключи команды checkout.
-k kflag: Использовать режим подстановки ключевых слов kflag. См. section Режимы подстановки. @short-option-l @short-option-N
-n: Не выполнять никаких программ. См. section Ключи команды checkout.
-P: Удалять пустые каталоги. См. section Перемещение и переименование каталогов.
-p: Извлекая файлы, печатать их в стандартный вывод (избегая липкости). См. section Ключи команды checkout. @short-option-R
-r tag: Извлечь ревизию tag (ключ липкий). См. section Стандартные ключи командной строки.
-s: Похоже на `-c', но выдает также статус модуля. См. section Ключи команды checkout.

commit [options] [files...]

Помещает изменения в репозиторий. См. section Команды commit: поместить файлы в репозиторий.

-F файл: Читает журнальное сообщение из файла. См. section Ключи команды commit.
-f: Принудительно фиксирует файл; запрещает рекурсию. См. section Ключи команды commit. @short-option-l
-m msg: Использовать msg в качестве журнального сообщения. См. section Ключи команды commit.
-n: Не выполнять программ. См. section Ключи команды commit. @short-option-R
-r rev: Фиксировать в ревизию rev. См. section Ключи команды commit.

diff [options] [files...]

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

-D date1: Выдать изменения от ревизии, датированной date1, до рабочего файла. См. section Ключи команды diff.
-D date2: Выдать изменения от rev1 или date1 до date2. См. section Ключи команды diff. @short-option-l
-N: Включает изменения для добавленных и удаленных файлов. См. section Ключи команды diff. @short-option-R
-r rev1: Выдать изменения от rev1 до рабочего файла. См. section Ключи команды diff.
-r rev2: Выдать изменения от rev1 или date1 до rev2. См. section Ключи команды diff.

edit [options] [files...]

Приготовиться к редактированию файла, за которым ведется наблюдение. См. section Как редактировать файлы, за которыми наблюдают?.

@short-option-a @short-option-l @short-option-R

editors [options] [files...]

Посмотреть, кто редактирует файл, за которым ведется наблюдение. section Информация о том, кто следит и кто редактирует.

@short-option-l @short-option-R

export [options] modules...

Экспортировать файлы из CVS. См. section Команда export: экспортировать исходные тексты.

-D date: Извлечь ревизии, датированные date. См. section Стандартные ключи командной строки.
-d dir: Извлекать в каталог dir. См. section Ключи команды export. @short-option-f @short-option-k @short-option-l @short-option-N
-n: Не выполнять программ перед извлечением. См. section Ключи команды export.
-P: Удалять пустые каталоги. См. section Перемещение и переименование каталогов. @short-option-R
-r tag: Извлечь ревизию tag (липкий ключ). См. section Стандартные ключи командной строки.

history [options] [files...]

Показать историю обращений к репозиторию. См. section Команда history: показать состояние файлов и пользователей.

-a: Показать информацию обо всех пользователях (по умолчанию --- только о себе). См. section Ключи команды history.
-b str: Показывать до записи с вхождением строки str в имя модуля, файла или репозитория. См. section Ключи команды history.
-c: Сообщать о зафиксированных (измененных) файлах. См. section Ключи команды history.
-D date: Сообщать о событиях, начиная с date. См. section Ключи команды history.
-e: Сообщать о всех типах записей. См. section Ключи команды history.
-l: Last modified (committed or modified report). См. section Ключи команды history.
-m module: Сообщать о модуле module (ключ можно задать несколько раз). См. section Ключи команды history.
-n module: Сообщать об изменениях в модуле module. См. section Ключи команды history.
-o: Сообщать об извлеченных модулях. См. section Ключи команды history.
-r rev: Сообщать об изменениях, начиная с ревизии rev. См. section Ключи команды history.
-T: Produce report on all TAGs. См. section Ключи команды history.
-t tag: Сообщать об изменениях, сделанных с момента, когда была создана метка tag. См. section Ключи команды history.
-u user: Сообщать об изменениях, сделанных пользователем user (ключ можно задать несколько раз). См. section Ключи команды history.
-w: Рабочие каталоги должны совпадать. См. section Ключи команды history.
-x types: Сообщать о типах событий types, обозначаемых буквами TOEFWUCGMAR. См. section Ключи команды history.
-z zone: Использовать временн'ую зону zone. См. section Ключи команды history.

import [options] repositoryvendor-tagrelease-tags...

Импортировать файлы в CVS, используя ветки поставщика. См. section Команда import: импортировать исходные тексты.

-b bra: Импортировать на ветку поставщика bra. См. section Несколько веток поставщика.
-d: Использовать время модификации файла в качестве времени импорта. См. section Ключи команды import. @short-option-k
-k kflag: Задать режим подстановки ключевых слов, действующий по умолчанию. См. section Ключи команды import.
-m msg: Использовать msg в качестве журнального сообщения. См. section Ключи команды import.
-I ign: Список файлов, которые нужно игнорировать (`!' очищает этот список). См. section Ключи команды import.
-W spec: Дополнительные обертки. См. section Ключи команды import.

init

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

log [options] [files...]

Напечатать информацию об истории файлов. См. section Команда log: напечатать информацию о файлах.

-b: Выдавать информацию только о ревизиях на ветви по умолчанию. См. section Ключи команды log.
-d dates: Задает даты (d1<d2 означает диапазон, d -- не позже). См. section Ключи команды log.
-h: Печатать только заголовок. См. section Ключи команды log. @short-option-l
-N: Не выдавать имена меток. См. section Ключи команды log.
-R: Печатать только имя RCS-файла. См. section Ключи команды log.
-rrevs: Печатать только информацию о ревизиях revs. См. section Ключи команды log.
-s states: Печатать только информацию о ревизиях, находящихся в указанных состояниях. См. section Ключи команды log.
-t: Печатать только заголовок и текст описания. См. section Ключи команды log.
-wlogins: Только о ревизиях, созданных указанными пользователями. См. section Ключи команды log.

login

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

logout

Удалить сохраненный пароль на сервер. См. section Использование клиента с парольной аутентификацией.

rdiff [options] modules...

Показать различия между версиями. См. section Команда rdiff: выдать изменения между версиями в формате patch.

-c: Контекстный формат выдачи изменений (по умолчанию). См. section Ключи команды rdiff.
-D date: Выбрать ревизии, созданные в date. См. section Стандартные ключи командной строки. @short-option-f @short-option-l @short-option-R
-r rev: Выбрать ревизии rev. См. section Стандартные ключи командной строки.
-s: Короткая заплатка -- одна строка на файл. См. section Ключи команды rdiff.
-t: Последнее изменение, сделанное в файле. См. section Ключи команды diff.
-u: Унифицированный формат выдачи изменений. См. section Ключи команды rdiff.
-V vers: Использовать RCS версии vers для подстановки ключевых слов (устарело). См. section Ключи команды rdiff.

release [options] directory

Указывает, что каталог больше не используется. См. section Команда release: сообщить, что модуль более не используется.

-d: Удалить указанный каталог. См. section Ключи команды release.

remove [options] [files...]

Удаляет файл из репозитория. См. section Удаление файлов.

-f: Удалить файл в рабочем каталоге перед удалением из репозитория. См. section Удаление файлов. @short-option-l @short-option-R

rtag [options] tagmodules...

Пометить набор ревизий в модуле. См. section Ревизии, а также section Создание ветвей и слияние.

-a: Убрать метку с удаленных файлов, которые в противном случае не были бы помечены. См. section Пометки при добавлении и удалении файлов.
-b tag: Создать ветку tag. См. section Создание ветвей и слияние.
-D date: Пометить ревизии, датированные date. См. section Как помечать по дате или ревизии.
-d tag: Удалить метку tag. См. section Удаление, перемещение и удаление меток.
-F: Переместить метку tag, если она уже существует. См. section Удаление, перемещение и удаление меток.
-f: Использовать головную ревизию (HEAD), если не найдена метка или дата. См. section Как помечать по дате или ревизии. @short-option-l
-n: Не выполнять программ при создании меток. См. section Стандартные ключи командной строки. @short-option-R
-r rev: Пометить существующую метку rev. См. section Как помечать по дате или ревизии.

status [options] files...

Напечатать информацию о статусе файлов в рабочем каталоге. См. section Статус файла.

-v: Сообщить также информацию о метках в файле. См. section Метки ревизий.

tag [options] tag [files...]

Пометить извлеченные версии файлов. См. section Ревизии, а также section Создание ветвей и слияние.

-b: Создать ветку tag. См. section Создание ветвей и слияние.
-c: Проверить, что рабочие файлы не изменялись. См. section Что пометить в рабочем каталоге.
-D date: Пометить ревизии, датированные date. См. section Как помечать по дате или ревизии.
-d: Удалить метку tag. См. section Удаление, перемещение и удаление меток.
-F: Переместить метку tag, если она уже существует. См. section Удаление, перемещение и удаление меток.
-f: Использовать головную ревизию (HEAD), если не найдена метка или дата. См. section Как помечать по дате или ревизии. @short-option-l @short-option-R
-r rev: Пометить существующую метку rev. См. section Как помечать по дате или ревизии.

unedit [options] [files...]

Отменить команду `edit'. См. section Как редактировать файлы, за которыми наблюдают?.

@short-option-a @short-option-l @short-option-R

update [options] [files...]

Обновить рабочее дерево каталогов из репозитория. См. section Команда update: обновить рабочий каталог из репозитория.

-D date: Извлекать ревизии, датированные date (ключ является липким). См. section Стандартные ключи командной строки.
-d: Создавать каталоги. См. section Ключи команды update. @short-option-f
-I ign: Добавить файлы в список игнорируемых (`!' очищает этот список). См. section Ключи команды import.
-j rev: Объединить изменения. См. section Ключи команды update.
-k kflag: Использовать режим подстановки ключевых слов kflag. См. section Режимы подстановки. @short-option-l
-P: Удалять пустые каталоги. См. section Перемещение и переименование каталогов.
-p: Извлекать файлы на стандартный вывод (избежав липкости). См. section Ключи команды update. @short-option-R
-r tag: Извлечь ревизию tag (ключ липкий). См. section Стандартные ключи командной строки.
-W spec: Добавить обертку. См. section Ключи команды import.

watch [on|off|add|remove] [options] [files...]

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

@short-option-a @short-option-l @short-option-R

watchers [options] [files...]

Вывести список следящих за файлом. См. section Информация о том, кто следит и кто редактирует.

@short-option-l @short-option-R