PRS(1)
НАЗВАНИЕ
prs - печать SCCS-файлов
СИНТАКСИС
prs [-d[спецификация_данных]] [-r[с_идентификатор]] [-e] [-l]
[-c[кон_время]] [-a] файл ...
ОПИСАНИЕ
Команда prs выдает на стандартный вывод части SCCS-файла или файл целиком [см. sccsfile(4)] в формате, который задает пользователь. Если указано имя каталога, prs
обрабатывает все файлы в этом каталоге, начинающиеся с
s.; файлы, к которым нет доступа на чтение, игнорируются без дополнительных сообщений. Если указано имя -,
происходит чтение со стандартного ввода, каждая строка
при этом трактуется как имя SCCS-файла, подлежащего
обработке. Файлы, не начинающиеся с s., и файлы, к которым нет доступа на чтение, также игнорируются без дополнительных сообщений.
В командной строке prs можно в любом порядке задавать
опции и имена файлов.
Каждая опция независимо применяется к каждому файлу.
- -d[спецификация_данных]
-
Используется для указания данных, подлежащих выводу. Спецификация_данных - это строка, состоящая из
ключевых слов данных [см. ниже] и дополнительного
текста, задаваемого пользователем.
- -r[с_идентификатор]
-
Указывает, информация о какой версии требуется.
Если с_идентификатор не указан, подразумевается
самая поздняя версия.
- -e
- Указывает, что требуется информация обо всех версиях, созданных не позднее версии, определенной в
опции -r, или не позднее даты, заданной в опции
-c.
- -l
- Указывает, что требуется информация обо всех версиях, созданных не ранее версии, определенной в
опции -r, или не ранее даты, заданной в опции -c.
- -c[кон_время]
-
Кон_время имеет формат:
гг[мм[дд[чч[мм[сс]]]]]
Опущенные цифры по умолчанию имеют максимально
возможные значения, например -c7502 эквивалентно
-c750228235959. Любое число любых нецифровых символов может разделять пары цифр; например, можно
задать кон_время в виде "-c77/2/2 9:22:25".
- -a
- Указывает, что требуется информация как о существующих (типа D), так и об удаленных (типа R) версиях [см. rmdel(1)]. Если опция -a не указана, выдается информация только о существующих версиях.
Ключевые слова данных
Ключевые слова данных определяют части SCCS-файла, которые должны быть извлечены и выведены. Все части
SCCS-файла [см. sccsfile(4)] имеют соответствующие ключевые слова. Каждое ключевое слово может появляться в
спецификации_данных любое число раз.
Информация, печатаемая командой prs, состоит из: (1)
пользовательского текста и (2) соответствующих значений
(извлеченных из SCCS-файла), подставленных вместо опознанных ключевых слов данных в порядке их появления в
спецификации_данных. Формат значения ключевого слова
данных может быть простым (П), при котором осуществляется прямая подстановка и многострочным (М), при котором за подставленным значением следует возврат каретки.
В спецификации_данных может использоваться также любой
другой текст, отличный от ключевых слов. Табуляция
представляется как \t, а возврат каретки/перевод строки - как \n.
КЛЮЧЕВЫЕ СЛОВА ДАННЫХ
Ключ. слово | Элемент данных | Раздел SCCS-файла | Значение | Формат
|
---|
:Dt: | Информация о фрагменте | Таблица фрагментов | см. ниже* | П
|
:DL: | Статистика строк | " | :Li:/:Ld:/:Lu: | П
|
:Li: | Число строк, вставленных в версии | " | nnnnn | П
|
:Ld: | Число строк, удаленных в версии | " | nnnnn | П
|
:Lu: | Число строк, не изменившихся в версии | " | nnnnn | П
|
:DT: | Тип версии | " | D или R | П
|
:I: | СИД | " | :R:.:L:.:B:.:S: | П
|
:R: | Номер версии | " | nnnn | П
|
:L: | Номер уровня | " | nnnn | П
|
:B: | Номер ветви | " | nnnn | П
|
:S: | Номер модификации | " | nnnn | П
|
:D: | Дата создания версии | " | :Dy:/:Dm:/:Dd: | П
|
:Dy: | Год создания версии | " | nn | П
|
:Dm: | Месяц создания версии | " | nn | П
|
:Dd: | День создания версии | " | nn | П
|
:T: | Время создания версии | " | :Th:::Tm:::Ts: | П
|
:Th: | Час создания версии | " | nn | П
|
:Tm: | Минута создания версии | " | nn | П
|
:Ts: | Секунда создания версии | " | nn | П
|
:P: | Пользователь, создавший версию | " | входное имя | П
|
:DS: | Порядковый номер версии | " | nnnn | П
|
:DP: | Порядковый номер отца | " | nnnn | П
|
:DI: | Порядковые номера включенных, исключенных,проигнорированных версий | " | :Dn:/:Dx:/:Dg: | П
|
:Dn: | Порядковые номера включенных версий | " | :DS: :DS:... | П
|
:Dx: | Порядковые номера исключенных версий | " | :DS: :DS:... | П
|
:Dg: | Порядковые номера проигнорированных версий | " | :DS: :DS:... | П
|
:MR: | Номера запросов | " | текст | М
|
:C: | Комментарии | " | текст | М
|
:UN: | Имена пользователей | Имена пользователей | текст | М
|
:FL: | Список флагов | Флаги | текст | М
|
:Y: | Флаг типа модуля | " | текст | П
|
:MF: | Флаг проверки номеров запросов | " | да или нет | П
|
:MP: | Имя программы проверки номеров запросов | " | текст | П
|
:KF: | Флаг ошибок/предупреждений | " | да или нет | П
|
:BF: | Флаг ветвления | " | да или нет | П
|
:J: | Флаг одновременного редактирования | " | да или нет | П
|
:LK: | Закрытые версии | " | :R:... | П
|
:Q: | Определяемый пользователем текст | " | текст | П
|
:M: | Имя модуля | " | текст | П
|
:FB: | Минимальный номер редактируемой версии | " | :R: | П
|
:CB: | Максимальный номер редактируемой версии | " | :R: | П
|
:Ds: | СИД по умолчанию | " | :I: | П
|
:ND: | Флаг пустоты версии | " | да или нет | П
|
:FD: | Текст, описывающий файл | Комментарии | текст | М
|
:BD: | Тело | Тело | текст | М
|
:GB: | Извлеченное тело | " | текст | М
|
:W: | Строка what(1) | Нет | :Z::M:\t:I: | П
|
:A: | Строка what(1) | Нет | :Z::Y: :M: :I::Z: | П
|
:Z: | Ограничитель строки what(1) | Нет | @(#) | П
|
:F: | Простое имя SCCS-файла | Нет | текст | П
|
:PN: | Составное имя SCCS-файла | Нет | текст | П
|
* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP:
|
ПРИМЕРЫ
- Команда
prs \
-d"Имена и/или идентификаторы пользователей для :F::\n:UN:"\
s.file
может вывести на стандартный вывод:
Имена и/или идентификаторы пользователей для s.file:
xyz
131
abc
- Команда
prs \
-d"Последнюю версию программы :M:: :I: создал :P: :D:"\
-r s.file
может вывести на стандартный вывод
Последнюю версию программы main.c: 3.7 создал cas 77/12/1
- Особый случай:
prs s.file
может вывести на стандартный вывод
D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000
MRs:
bl78-12345
bl79-54321
COMMENTS:
это строка коммментария для начальной версии
для каждой версии типа D. В особом случае можно использовать только опцию -a.
ФАЙЛЫ
/tmp/pr?????
СМ. ТАКЖЕ
admin(1), delta(1), get(1), help(1), rmdel(1).
sccsfile(4) в Справочнике программиста.
ДИАГНОСТИКА
Для раз яснений пользуйтесь командой help(1).