The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

rlog - печать журнальных записей и другой информации о файлах RCS



С О Д Е Р Ж А Н И Е
1. ИМЯ                                                               1
2. ФОРМАТ                                                            1
3. ОПИСАНИЕ                                                          1
4. ПРИМЕРЫ                                                           4
5. СРЕДА                                                             4
6. ДИАГНОСТИКА                                                       4
7. ИДЕНТИФИКАЦИЯ                                                     4
8. СМ. ТАКЖЕ                                                         5
9. ОШИБКИ                                                            5

 1. ИМЯ
       rlog - печать журнальных записей и другой  информации  о  файлах
       RCS.

 2. ФОРМАТ
       rlog [ options ] file...

 3. ОПИСАНИЕ
       rlog печатает информацию о файлах RCS.

       Имена путей,  соответствующие суффиксу RCS,  означают файлы RCS;
       все другие означают рабочие файлы.  Имена спарены, как объяснено
       в ci(1).

       rlog печатает  следующую  информацию для каждого файла RCS:  имя
       пути RCS,  рабочее имя пути,  "голову" (т.е. номер самой поздней
       модификации на стволе), ветвь по умолчанию, список доступа, бло-
       кировки, символьные имена,  суффикс,  полное число  модификаций,
       число модификаций, выбранных для печати и поясняющий текст. За
       этим следуют вхождения для выбранных модификаций в обратном хро-
       нологическом порядке  для  каждой ветви.  Для каждой модификации
       rlog печатает номер модификации,  автора, дату/время, состояние,
       число добавленных/удаленных строк (относительно предыдущей моди-
       фикации), блокиратора модификации (если есть) и  журнальную  за-
       пись. Все  времена  даются  в Координированном Всемирном Времени
       (КВВ) по умолчанию;  это может быть перезаписано  опцией  -z.Без
       опций rlog печатает полную информацию. Следующие опции ограничи-
       вают этот выход.

       -L  Игнорировать файлы RCS, которые не имеют установки блокирова-
           ния. Это удобно в комбинации с -h, -l, и -R.

       -R  Печатать только имя файла RCS. Это удобно для трансляции ра-
           бочего имени пути в имя пути RCS.
       -h  Печатать только имя пути RCS, рабочее  имя  пути,  "голову",
           ветвь по умолчанию, список доступа,  блокировки,  символьные
           имена и суффикс.

                                - 2 -

       -t  Печатать то же, что -h, плюс поясняющий текст.

       -N  Не печатать символьные имена.

       -b  Печатать информацию о модификациях на ветви по  умолчанию,  в
           норме на наивысшей ветви на стволе.

       -ddates
           Печатать информацию о модификациях с  датой/временем  оформ-
           ленного ввода в диапазонах, заданных списком дат dates, раз-
           деленных точками с запятыми.  Диапазон  в  форме  d1d1  выбирает модификации,  которые расположены между d1 и
           d2 исключительно.  Диапазон в форме   выбирает  все
           модификации  раньше  d.  Диапазон в форме d< или >d выбирает
           все модификации,  датированные позже d. Если за < или > сле-
           дует = ,  то диапазоны - включительные, а не исключительные.
           Диапазон в форме d выбирает единственную,  самую позднюю мо-
           дификацию,  датированную d или ранее. Строки даты/времени d,
           d1 и d2 - в свободном формате,  объясненном в co(1). Кавычки
           в норме необходимы,  особенно для < и >. Заметим, что разде-
           литель - точка с запятой.

       -l[lockers]
           Печатать информацию  только о блокированных модификациях.  В
           добавление, если дан разделенный запятыми список регистраци-
           онных имен блокираторов lockers,  то игнорировать все блоки-
           ровки,  кроме заданных блокираторами.  Например,  rlog -L -R
           -lwft RCS /*  печатает имена файлов RCS, блокированных поль-
           зователем wft.
       -r[revisions]

           печатает информацию о модификациях,  заданных в  разделенном
           запятыми списке revisions модификаций и диапазонов. Диапазон
           rev1:rev2 означает модификации от rev1 до rev2 на одной вет-
           ви, :rev означает модификации от начала ветви до rev включи-
           тельно, rev: означает модификации от rev до конца ветви, со-
           держащей rev. Ветвь как аргумент означает все модификации на

                                - 3 -

           этой ветви. Диапазон ветвей означает все модификации на вет-
           вях в этом диапазоне. Ветвь с точкой на конце означает самую
           позднюю модификацию на этой ветви. Чистое -r без модификаций
           означает самую  позднюю модификацию на ветви по умолчанию, в
           норме на стволе.

       -sstates
           печатает информацию  о модификациях,  чьи атрибуты состояния
           соответствуют одному из состояний,  заданных  в  разделенном
           запятыми списке states.

       -w[logins]
           печатает информацию  о  модификациях,  оформленно  введенных
           пользователями с  регистрационными  именами  из разделенного
           запятыми списка logins. Если logins опущен, то предполагает-
           ся регистрационное имя пользователя.

       -T  Эта опция бездействует; она введена для совместимости с дру-
           гими командами RCS.

       -V  Печатать номер версии RCS.

       -Vn Эмулировать RCS версии  n при генерации журналов. См. co(1)
           для большего.

       -xsuffixes
           Использовать suffixes для  характеризации  файлов  RCS.  См.
           ci(1) для большего.

       rlog печатает пересечение модификаций, выбранных опциями -d, -l,
           -s, и -w, пересеченных с объединением модификаций, выбранных
           через -b и -r.

       -zzone
           специфицирует выходной формат даты и часовой пояс по умолча-
           нию для даты в опции -ddates.  zone должна быть пустой, чис-
           ленным смещением КВВ или специальной строкой LT для местного
           времени. Умолчание - пустая zone,  которая использует тради-

                                - 4 -

           ционный RCS-формат КВВ без указания часового пояса и со слэ-
           шами, разделяющими части даты; иначе времена выдаются в фор-
           мате ISO 8601 с указанием  часового  пояса.  Например,  если
           местное время  - 11 января 1990г.,  8pm Тихоокеанского Стан-
           дартного Времени, восемь часов к западу от КВВ, то время бу-
           дет выдано как показано:

                опция      выход времени
                -z         1990/01/12 04:00:00       (умолчание)
                -zLT       1990-01-11 20:00:00-08
                -z+05:30   1990-01-12 09:30:00+05:30
 4. ПРИМЕРЫ

             rlog  -L  -R  RCS/*
             rlog  -L  -h  RCS/*
             rlog  -L  -l  RCS/*
             rlog  RCS/*

           Первая команда  печатает имена всех файлов RCS в поддиректо-
           рии RCS,  который имеет блокировки.  Вторая команда печатает
           заголовки этих файлов,  а третья - заголовки плюс журнальные
           записи блокированных модификаций. Последняя команда печатает
           полную информацию.

 5. СРЕДА
       RCSINIT
           опции добавляются  к началу списка аргументов,  разделенного
           пробелами. См. ci(1).

 6. ДИАГНОСТИКА
           Статус выхода  =0,  если и только если все операции были ус-
           пешными.

 7. ИДЕНТИФИКАЦИЯ
           Автор: Walter F. Tichy.
           Manual Page Revision: 5.9; Release Date: 1995/06/16.
           Copyright  (C)  1982,  1988,  1989  Walter F. Tichy.
           Copyright  (C)  1990,  1991,  1992,  1993, 1994, 1995 Paul
           Eggert.

 8. СМ. ТАКЖЕ
       	  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.

 9. ОШИБКИ

    Разделитель для диапазонов модификаций в опции -r обычно  использу-
    ется -  вместо :,  но это ведет к путанице,  когда символьные имена
    содержат -.  Для обратной совместимости rlog  -r  еще  поддерживает
    старый разделитель -,  но предупреждает, что его употребление уста-
    рело.



Спонсоры:
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2021 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру