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 еще поддерживает старый разделитель -, но предупреждает, что его употребление уста- рело.