rcs - изменить атрибуты файла RCS
rcs - изменить атрибуты файла RCS
С О Д Е Р Ж А Н И Е
1. ИМЯ 1 2. ФОРМАТ 1 3. ОПИСАНИЕ 1 4. ОПЦИИ 1 5. СОВМЕСТИМОСТЬ 6 6. ФАЙЛЫ 6 7. СРЕДА 6 8. ДИАГНОСТИКА 6 9. ИДЕНТИФИКАЦИЯ 6 10. СМ. ТАКЖЕ 7 11. ОШИБКИ 7
1. ИМЯ
rcs - изменить атрибуты файла RCS
2. ФОРМАТ
rcs options file...
3. ОПИСАНИЕ
rcs создает новые файлы RCS или изменяет атрибуты существующих.
Файл RCS содержит множественные модификации текста, список дос-
тупа, запись изменений, поясняющий текст и некоторые управляющие
атрибуты. Для запуска rcs регистрационное имя пользователя долж-
но быть в списке доступа, за исключением случаев, когда: список
пуст, пользователь - владелец файла или привилегированный поль-
зователь, или присутствует опция -i.
Имена путей, соответствующие RCS-суффиксу, означают файлы RCS;
все другие означают рабочие файлы. Имена спарены, как объяснено
в ci(1). Номера модификаций используют синтаксис, описанный в
ci(1).
4. ОПЦИИ
-i Создать и инициализировать новый RCS-файл, но не со-
хранять никакой модификации. Если RCS-файл не имеет пу-
тевого префикса, то попробуйте поместить его сначала в
поддиректорий ./RCS, а затем в текущий директорий. Если
RCS-файл уже существует, то выдать ошибку.
-alogins
Добавить регистрационные имена из разделенного запятыми
списка logins в список доступа файла RCS.
-Aoldfile
Добавить список доступа файла oldfile к списку доступа
файла RCS.
-e[logins]
Стереть регистрационные имена, появляющиеся в разделенном
запятыми списке logins, из списка доступа файла RCS. Если
- 2 -
logins опущен, то стереть весь список доступа.
-b[rev]
Установить ветвь по умолчанию на rev. Если rev опущена,
то ветвь по умолчанию переустанавливается на (динамичес-
ки) наивысшую ветвь на стволе.
-cstring
Установить начальный участок с комментариями в string.
Первоначальная ci или rcs -i без -c "сочиняет" начальный
участок с комментариями, исходя из суффикса имени рабо-
чего файла.
Эта опция устарела, так как RCS обычно использует пре-
фикс предшествующей строки $Log$ при вставке регистраци-
онных строк во время оформленного ввода (см. co(1)). Од-
нако старые версии RCS используют начальный участок с
комментариями вместо префикса строки $Log$, так что если
вы планируете доступ к файлу и со старой и с новой вер-
сиями RCS, то убедитесь, что его начальный участок с
комментариями соответствует его префиксу строки $Log$.
-ksubst
Установить подстановку ключевых слов по умолчанию на
subst. Эффект подстановки ключевых слов описан в co(1).
Давая явную опцию -k для co, rcsdiff и rcsmerge перекры-
вают это умолчание. Остерегайтесь rcs -kv, так как -kv
несовместима с co -l. Используйте rcs -kkv для восста-
новления нормальной подстановки ключевых слов по умолча-
нию.
-l[rev]
Блокировать модификацию с номером rev. Если задана
ветвь, то блокировать самую позднюю модификацию на этой
ветви. Если rev опущена, то блокировать самую позднюю
модификацию на ветви по умолчанию. Блокирование пре-
дотвращает перекрытие изменений. Если кто-то еще уже
поставил блокировку, то она нарушается, как при rcs -u
(см. ниже).
- 3 -
-u[rev]
Разблокировать модификацию с номером rev. Если задана
ветвь, то разблокировать самую позднюю модификацию на
этой ветви. Если rev опущена, то удалить самую позднюю
блокировку, наложенную пользователем. В норме только
блокиратор модификации может разблокировать ее. Кто-то
другой, разблокируя модификацию, нарушает блокировку.
Это вызывает посылку сообщения первоначальному блокира-
тору. Сообщение содержит комментарий от имени нарушите-
ля. Сообщение кончается концом_файла или строкой, содер-
жащей `.'.
-L Установить блокировку на строгую. Это означает, что
владелец файла RCS не отстранен от блокировки для оформ-
ленного ввода. Эту опцию нужно использовать для совмест-
но используемых файлов.
-U Установить блокировку на нестрогую. Это означает, что
владелец файла не нуждается в блокировке модификации для
оформленного ввода.Эта опция не будет полезной для сов-
местно используемых файлов. Строгое ли блокирование по
умолчанию, определяется вашим системным администратором,
но в норме оно строгое.
-mrev:msg
Заменяет журнальную запись модификации rev на msg.
-M Не посылать сообщения при нарушении блокировки кем-то
другим. Эта опция - не значащая для случайного (нерегу-
лярного) употребления; ее имеет смысл применять только
для программ, которые предупреждают пользователей други-
ми средствами и вызывают rcs -u как низкоуровневую опе-
рацию, нарушающую блокировку.
-nname[:[rev]]
Ассоциировать символическое имя name с ветвью или моди-
фикацией rev. Удалить символическое имя, если и `:' и
rev опущены; иначе печатать сообщение об ошибке, если
- 4 -
rev уже ассоциирована с другим номером. Если rev сим-
вольная, то она расширяется перед ассоциированием. rev,
состоящая из номера ветви с последующей точкой, означает
текущую самую позднюю модификацию на ветви. Двоеточие с
пустой rev означает текущую самую позднюю модификацию на
ветви по умолчанию, в норме на стволе. Например, rcs
-nname: RCS/* ассоциирует name с текущей самой поздней
модификацией из всех именованных файлов RCS; это конт-
растирует с rcs -nname:$ RCS/* , которая ассоциирует
name с номерами модификаций, извлеченными из строк клю-
чевых слов в соответствующих рабочих файлах.
-Nname[:{rev]]
Действует наподобие -n, только перезаписывает любое пре-
дыдущее присвоение name.
-orange
удаляет модификации, заданные диапазоном range. Диапа-
зон, состоящий из одного номера модификации, означает
эту модификацию. Диапазон, состоящий из номера ветви,
означает самую позднюю модификацию на этой ветви. Диапа-
зон в форме rev1:rev2 означает модификации от rev1 до
rev2 на одной ветви, :rev означает от начала ветви, со-
держащей rev, до rev включительно и rev: означает от мо-
дификации rev до конца ветви, содержащей rev. Ни одна из
удаляемых модификаций не может иметь ветви или блоки-
ровки.
-q Исполнять "молча"; не печатать диагностику.
-I Исполнять интерактивно, даже если стандартный выход - не
терминал.
-sstate[:rev]
Установить атрибут состояния модификации rev на state.
Если rev - номер ветви, то предполагается самая поздняя
модификация на этой ветви. Если rev опущена, то предпо-
лагается самая поздняя модификация на ветви по умолча-
нию. Для state приемлем любой идентификатор. Полезен на-
- 5 -
бор состояний: Exp (экспериментальное), Stab
(стабильное) и Rel (released). По умолчанию ci(1) уста-
навливает состояние модификации на Exp.
-t[file]
Записать поясняющий текст из содержимого файла file в
файл RCS, удалив существующий текст. Имя пути файла не
может начинаться с - . Если file опущен, то получить
текст со стандартного ввода, заканчивающийся концом_фай-
ла или строкой, содержащей точку. Делать подсказку для
текста, если возможна интерактивная работа; см. -I. При
-i поясняющий текст получается, даже если не задана -t.
-t-string
Записать поясняющий текст из строки string в файл RCS,
удалив существующий текст.
-T Сохранить время модифицирования в файле RCS, если модифи-
кация не удаляется. Эта опция может подавлять лишнюю пе-
рекомпиляцию, вызванную зависимостью некоторой копии ра-
бочего файла от файла RCS через make(1). Используйте эту
опцию осторожно; она может подавлять перекомпиляцию, да-
же когда она нужна, т.е. когда изменение в файле RCS оз-
начало бы изменение в строках ключевых слов в рабочем
файле.
-V Печатать номер версии RCS.
-Vn Эмулировать RCS версии n. См. co(1) для деталей.
-xsuffixes
Использовать suffixes для характеризации файла RCS. См.
ci(1) для деталей.
-zzone Использовать zone как часовой пояс по умолчанию. Эта оп-
ция бездействует; она представлена для совместимости с
другими командами RCS.
Должна быть задана минимум одна явная опция для обеспечения сов-
- 6 -
местимости с будущими планируемыми расширениями команды rcs.
5. СОВМЕСТИМОСТЬ
Опция -brev генерирует файл RCS, который не может быть проанали-
зирован системой RCS версии 3 или ранее.
Опции -ksubst (исключая -kkv) генерируют файл RCS, который не мо-
жет быть проанализирован системой RCS версии 4 или ранее.
Используйте rcs -Vn, чтобы сделать файл RCS приемлемым для RCS
версии n путем устранения информации, которая могла бы "сму-
тить" версию n.
RCS версии 5.5 и ранее не поддерживает опцию -x и требует суф-
фикса ,v в имени пути RCS.
6. ФАЙЛЫ
rcs имеет доступ к файлам примерно так же, как ci(1), только она
использует номинального пользователя для всех видов доступа, не
записывает рабочий файл или свой директорий и даже не читает ра-
бочий файл, если не специфицирован номер модификации $.
7. СРЕДА
RCSINIT
опции добавляются к началу списка аргументов, разделенных
пробелами. См. ci(1) для деталей.
8. ДИАГНОСТИКА
Имя пути RCS и удаляемые модификации пишутся на диагностический
выход. Статус выхода = 0, если и только если все операции были
успешными.
9. ИДЕНТИФИКАЦИЯ
Автор: Walter F. Tichy.
Manual Page Revision: 5.13; Release Date: 1995/06/05.
Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995 Paul
Eggert.
- 7 -
10. СМ. ТАКЖЕ
rcsintro(1), co(1), ci(1), ident(1), rcsclean(1),
rcsdiff(1), rcsmerge(1), rlog(1), rcsfile(5)
Walter F. Tichy, RCS--A System for Version Control,
Software--Practice & Experience 15, 7 (July 1985),
637-654.
11. ОШИБКИ
Катастрофа (например, развал системы) может принудить RCS оста-
вить семафорный файл, что приведет позднее к вызовам RCS для
подтверждения того, что файл RCS используется. Для исправления
этого удалите семафорный файл. Имя семафорного файла обычно на-
чинается с `,' или кончается на ` _'.
Разделитель для диапазонов модификаций в опции -o должен бы быть
- вместо :, но это ведет к путанице, когда символические имена
содержат -. Для обратной совместимости rcs -o еще поддерживает
старый разделитель - , но она предупреждает об этом устарелом
употреблении.
Символические имена не обязаны ссылаться на существующие модифи-
кации или ветви. Например, опция -o не удаляет символические
имена для устраненных модификаций; надо использовать -n для уда-
ления имен.