RLOG(1)
КОМАНДЫ ПОЛЬЗОВАТЕЛЯ

НАЗВАНИЕ
rlog - история изменения и прочая информация об архивном файле

СИНТАКСИС

	rlog [флаги] имя-файла ...

ОПИСАНИЕ
Команда rlog извлекает регистрационную информацию из архивного файла в системе отслеживания версий RCS.

Полное имя файла, содержащее архивный суффикс, соответствует архивному файлу, все прочие считаются рабочими файлами. О соответствии имен файлов, см. ci(1) .

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

-L

Пропустить архивные файлы, не содержащие зарезервированных версий, что эквивалентно совместному заданию -h, -l и -R.

-R

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

-h

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

-t

То же, что и -h, плюс описание файла.

-N

Не выдает символические имена.

-b

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

-ddates

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

-l[lockers]

Сообщать информацию только о версиях, забронированных для внесения изменений. Если задан список lockers пользователей с запятыми в качестве разделителей, то версии, забронированные остальными, игнорируются. Например, rlog -L -R -lwft RCS/* сообщит о всех файлах, с которыми работает пользователь wft.

-r[revisions]

prints information about revisions given in the commaseparated list revisions of revisions and ranges. A range rev1:rev2 means revisions rev1 to rev2 on the same branch, :rev means revisions from the beginning of the branch up to and including rev, and rev: means revisions starting with rev to the end of the branch containing rev. An argument that is a branch means all revisions on that branch. A range of branches means all revisions on the branches in that range. A branch followed by a . means the latest revision in that branch. A bare -r with no revisions means the latest revision on the default branch, normally the trunk.

-sstates

prints information about revisions whose state attributes match one of the states given in the commaseparated list states.

-w[logins]

prints information about revisions checked in by users with login names appearing in the comma-separated list logins. If logins is omitted, the user's login is assumed.

-T

Присутствует исключительно для совместимости с другими командами RCS , для которых задает формат даты при

-V

Посылает номер версии RCS на стандартный вывод.

-Vn

Имитирует поведение версии n комплекса программ RCS . См. co(1) .

-xsuffixes

Задает суффикс, добавляемый к имени архивного файла. См. ci(1) .

Команда rlog сообщает информацию только о версиях, удовлетворяющих одновременно всем условиям, заданным флагами -d, -l, -s и -w из тех, что удовлетворяют хотя бы одному из ограничений, наложенных флагами -b и -r.

-zzone

Задает формат даты при подстановке ключевых слов в маркеры и часовой пояс для флага -ddate . Параметр zone должен быть либо пуст, либо являться численным значением отклонения от Всемирного Времени (UTC) , либо специальной строкой LT , задающей использование местного времени. По умолчанию, и опущенный параметр zone , задают использование Всемирного Времени с использованием косой черты в качестве разделителя полей для даты (см. пример). В остальных случаях используется стандарт ISO 8601. Например, пусть текущее время 8 часов вечера, 11 января 1990, в Тихоокеанском часовом поясе США (что на 8 часов позже, чем в Гринвиче). Тогда для подстановок будет использовано

флаг	формат времени
-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

Флаг -z влияет только на маркеры, и не меняет формата даты и времени в архивном файле, которые всегда задается во Всемирном Времени.

ПРИМЕРЫ

	rlog  -L  -R  RCS/*

	rlog  -L  -h  RCS/*

	rlog  -L  -l  RCS/*

	rlog  RCS/*

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

ПЕРЕМЕННЫЕ СРЕДЫ

LOGNAME

Имя пользователя. В UNIX задано автоматически, в MS-DOS требуется задать явно командой

	set LOGNAME=имя-пользователя

TZ

Часовой пояс. В UNIX задан автоматически, в MS-DOS требуется задать явно командой set.

RCSINIT

Список флагов используемых со всеми командами системы отслеживания версий RCS. Не забудьте, что необходимы меры для того, чтобы пробелы между флагами не были обработаны командным интерпретатором преждевременно, защищайте их, например, кавычками. См. ci(1) .

СООБЩЕНИЯ
Возвращает операционной системе 0 тогда и только тогда, когда все операции завершились успешно.

СМ. ТАКЖЕ
ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rcsfile(5)

Walter F. Tichy, RCS--A System for Version Control, Software--Practice & Experience 15, 7 (July 1985), 637-654.

Copyright (C) Walter F. Tichy, Paul Eggert.

ПРОБЛЕМЫ
Из-за совместимости с предыдущими версиями RCS , в которых в качестве разделителя использовался минус вместо двоеточия, возникают проблемы с символическими номерами версий, начинающимися с минуса. Команда rlog -r воспримет минус как разделитель, но сообщит о неудачном выборе символического имени.