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:

ПРИМЕРЫ

  1. Команда
    
            prs \
    
             -d"Имена и/или идентификаторы пользователей для :F::\n:UN:"\
    
             s.file
    
    
    может вывести на стандартный вывод:
    
            Имена и/или идентификаторы пользователей для s.file:
    
            xyz
    
            131
    
            abc
    
    
  2. Команда
    
            prs \
    
             -d"Последнюю версию программы :M:: :I: создал :P: :D:"\
    
             -r s.file
    
    
    может вывести на стандартный вывод
    
            Последнюю версию программы main.c: 3.7 создал cas 77/12/1
    
    
  3. Особый случай:
    
            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).