Подраздел

• 14.29.1 Параметры команды log

14.29 log - выдать протокольную информацию для файлов

• Использование:
  cvs log [options] [files...]

• Требуется: хранилище, рабочий каталог.

• Изменения: ничего не изменяется.

Команда отображает информацию о файлах в хранилище и в рабочем каталоге (точнее выводит информацию на устройство стандартного вывода). Для выполнения команда log вызывала ранее утилиту системы RCS. Сейчас это не соответствует действительности (по меньшей мере для версии CVS 1.10), но стиль вывода и способ использования параметров чуть отличаются от обычного в CVS.

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

Предупреждение.
Команда log использует параметр -R необычным способом, который отличается от обычного внутри CVS.

14.29.1 Параметры команды log

По умолчанию log печатает всю имеющуюся информацию о файлах. Параметры используются для того, чтобы ограничить объ©м вывода.

-b

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

-d dates

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

d1<d2 d1>d2 Выбрать версии, которые были помещены в хранилище между датами d1 и d2.

<d d> Выбрать все версии, которые были внесены в хранилище с датой d или раньше.

>d d< Выбрать все версии, которые были внесены в хранилище с датой d или позже.

d Выбрать одну версию, датированную d или ранее.

За знаками > (больше) и < (меньше) могут следовать знак = (равно), чтобы обозначить замкнутый интервал, а не разомкнутый.

Заметим, что разделителем является знак ';' (точка с запятой).

-h

Напечатать только имя файла RCS, имя файла в рабочем каталоге, заголовок, ветвь по умолчанию, список доступа, защиту, символические имена и суффикс.

-l

Локально; выполнять только в локальном каталоге (без подкаталогов). Умолчание - выполнять рекурсивно, с подкаталогами.

-N

Не выводить список тегов для файла. Этот параметр очень полезен, если в вашей группе разработчиков используется много тегов, например, пять страниц.

-R

Вывести только имя файла RCS.

-rrevisions

Вывести информацию о версиях. Нижеследующая таблица показывает допустимые форматы строки revisions.

rev1:rev2 Версии oт rev1 до rev2, которые должны быть в одной ветви.

:rev Версии начиная с ветви по умолчанию до rev включительно.

rev: Версии начиная с rev до конца ветви, содержащей rev.

branch Аргумент означает имя ветви, т.е. имеются в виду все версии из этой ветви.

branch1:branch2 Ряд ветвей, подразумеваются все версии из этого ряда ветвей.

branch. Наиболее свежая версия в ветви branch (в параметре точка на конце).

Параметр -r без аргументов означает наиболее свежую версию в ветви по умолчанию. Обычно это основной ствол. Между параметром -r и аргументом не должно быть пробелов.

-s states

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

-t

Выдать то же самое, что и -h плюс поле комментариев.

-wlogins

Выдать информацию о версиях, которые были внесены в хранилище пользователями, имена которых перечислены в списке им©н, раздл©нных запятыми, в строке logins. Если logins опущена, то подразумевается имя пользователя, который выполняет команду log. Между параметром w и его аргументом не должно быть пробелов.

Команда log выда©т пересечение (intersection) версий, выбранных параметрами -d, -s, -w с объединением версий, отобранных посредством параметров -b и -r.