| Сервер поддерживается Центром Информационных Технологий (095) 932-9212, 932-9213, 939-0783 E-mail: info@citforum.ru

Сервер содержит море(!) аналитической информации | CIT Forum CD-ROM

### SCCSFILE(4)

НАЗВАНИЕ
sccsfile - формат SCCS-файла

ОПИСАНИЕ
SCCS-файл является текстовым файлом. Он состоит из шести логических частей. Это контрольная сумма, таблица версий (информация о каждой версии), имена пользователей (входные имена и/или числовые идентификаторы групп пользователей, которые создавали версии), флаги (определения внутренних ключевых слов), комментарии (описательная информация о файле) и тело (реальные текстовые строки, перемешанные с управляющими строками).

В SCCS-файле могут встречаться строки, начинающиеся с кода ASCII 001. Этот символ мы будем называть управляющим символом и обозначать @. Все допустимые вхождения управляющего символа ниже оговариваются явно.

Запись вида DDDDD представляет цепочку из пяти цифр (число от 00000 до 99999).

Ниже подробно описываются логические части SCCS-файла.

Контрольная сумма
Контрольная сумма - это первая строка SCCS-файла. Формат этой строки следующий:

         @hDDDDD

Значением контрольной суммы является сумма всех символов файла, кроме символов первой строки. Сочетание @h есть магическое число SCCS-файла.

Таблица версий
Таблица версий состоит из переменного числа элементов вида

         @s DDDDD/DDDDD/DDDDD
         @d тип с_ид гг/мм/дд чч:мм:сс вх_имя DDDDD DDDDD
         @i DDDDD ...
         @x DDDDD ...
         @g DDDDD ...
         @m номер запроса на модификацию
             ....
         @c комментарий
             ...
         @e

Первая строка (@s) содержит число вставленных/удаленных/измененных строк соответственно. Вторая строка (@d) содержит тип версии (D - существующая, R - удаленная), идентификатор SCCS-версии, дату и время создания версии, входное имя пользователя, создавшего версию, порядковые номера версии и ее предшественника.

Строки @i, @x и @g содержат порядковые номера включенных, исключенных и игнорируемых версий, соответственно. Эти строки могут отсутствовать.

Строки @m (которые могут отсутствовать) содержат номера запросов на модификацию, связанные с этой версией, строки @c содержат комментарии, связанные с этой версией.

Строка @e завершает элемент таблицы версий.

Имена пользователей
Список входных имен и/или числовых идентификаторов групп пользователей, которые могут добавлять версии в файл, по одному имени в строке. Список в целом обрамляется строками @u и @U. Пустой список означает, что новые версии может создать кто угодно. Каждая строка, начинающаяся со знака !, запрещает создание новых версий указанным пользователям или группам.

Флаги
Внутренние ключевые слова [см. admin(1)]. Каждый флаг имеет вид:

         @f флаг текст

при этом текст может отсутствовать.

Определены следующие флаги:

         @f t тип программы
         @f v имя программы
         @f i
         @f b
         @f m имя модуля
         @f f мин версия
         @f c макс версия
         @f d версия по умолчанию
         @f n
         @f j
         @f l закрытые версии
         @f q значение, определенное пользователем
         @f z зарезервировано для интерфейсов

Флаг t определяет подстановку вместо идентифицирующего ключевого слова %Y%. Флаг v управляет заданием номеров запросов на модификацию в дополнение к комментариям, если присутствует текст, он задает программу проверки номеров запросов. Флаг i управляет тем, считается ли сообщение "No id keywords" предостережением или ошибкой. Если флага i нет, это сообщение является предостережением, иначе - фатальной ошибкой (то есть файл не будет извлечен или версия не будет создана). Если присутствует флаг b, в команде get можно использовать опцию -b для создания ответвления от дерева версий. Флаг m определяет первый формат размещения значения идентифицирующего ключевого слова %M%. Флаг f задает минимальную версию, которая может быть выбрана для редактирования, то есть версии ниже нее не могут быть добавлены. Флаг c задает максимальную версию, которая может быть выбрана для редактирования, то есть версии выше нее не могут быть добавлены. Флаг d задает номер версии по умолчанию, если он не указан в команде get(1). Наличие флага n приводит к тому, что delta(1) при создании новой версии будет создавать пустыми все пропущенные версии (например, создавая версию 5.1 после версии 2.7 имеем пропущенные версии 3 и 4). Эти пустые версии могут затем быть использованы для новых ветвей. Отсутствие флага n приводит к отсутствию пропущенных версий в SCCS файле, использовать их в будущем для новых ветвей нельзя. Флаг j означает, что допускается использование нескольких команд get(1) одновременно для редактирования одной и той же версии SCCS-файла. Флаг l задает список версий, закрытых для редактирования (get(1) с опцией -e). Флаг q задает подстановку вместо идентифицирующего ключевого слова %Q%. Флаг z используется в специализированных интерфейсных программах.

Комментарии
Любой текст, окруженный строками @t и @T. Обычно секция комментариев содержит описание назначения файла.

Тело
Тело состоит из текстовых и управляющих строк. Текстовые строки, в противоположность управляющим, не начинаются с управляющего символа. Имеются три вида управляющих строк: вставка, удаление и конец, имеющих формат, соответственно

         @I DDDDD
         @D DDDDD
         @E DDDDD

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

СМ. ТАКЖЕ
admin(1), delta(1), get(1), prs(1).

Comments: info@citmgu.ru Designed by Andrey Novikov Copyright © CIT