Подраздел

• 14.27.1 Параметры команды history

14.27 history - показать историю изменения состояния хранилища

• Использование:
  history [-report] [-flags] [-options args] [files...]
• Требуется: файл $CVSROOT/CVSROOT/history

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

CVS может хранить историю в файле, который содержит каждое использование команд: checkout, commit, rtag, update, release. Вы можете использовать команду history, чтобы отобразить содержание файла $CVSROOT/CVSROOT/history в различных форматах.

Предупреждение. Команда history интерпретирует параметры -f, -l, -n, -p иначе, чем принято в системе CVS.

14.27.1 Параметры команды history

Ниже привед©н список параметрoв для управления какая информация будет напечатана.

-c

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

-e

Вывести все типы записей из файла $CVSROOT/CVSROOT/history.

-m module

Вывести сведения об отдельном модуле. Можно использовать этот параметр несколько раз в командной строке.

-o

Вывести информацию о том, когда выполнялась команда checkout.

-T

Вывести информацию о всех тегах.

-x type

Выдать из файла $CVSROOT/CVSROOT/history записи типа type. Типы записей указываются одной буквой. В одной строке можно указать более одного типа записей, т.е. использовать комбинацию букв.

Часть команд имеют лишь один тип записи. F - команда release. O - команда checkout. E - команда export. T - команда rtag.

Команда update может давать четыре типа записи в файл истории.

C - было необходимо слияние изменений, однако обнаружены коллизии, которые могут быть устранены только вручную.

G - Было успешно выполнено необходимое слияние изменений.

U - Рабочий файл был скопирован из хранилища.

W - Рабочая копия файла была удалена во время выполнения команды update, поскольку е© нет в хранилище.

Команда commit может порождать три типа записей в файле истории.

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

M - файл был модифицирован.

R - файл был удал©н.

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

-a

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

-l

Показать только последнюю модификацию.

-w

Показать только записи модификации, которые были выполнены из того же рабочего каталога, где выполняется команда history.

Параметры, которым предшествует знак - (минус) и за которыми следует аргумент, приводят к тому, что вывод строится в соответствии со значением аргумента.

-b str

Показать записи, которые содержат строку str в имени модуля, имени файла или в имени пути к хранилищу.

-D date

Показать записи, начиная с даты date. Это чуть-чуть отличается от обычного использования параметра -D в CVS, когда оно обозначает наиболее свежую версию до даты date.

-p repository

Показать данные для отдельного хранилища. Можно использовать несколько параметров -p в одной командной строке.

-r rev

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

-t tag

Показать записи, начиная с момента, когда тег с именем tag был добавлен к файлу истории. Это отличается от параметра -r (выше), в котором читается лишь файл истории, а не файлов RCS, что значительно быстрее.

-u name

Показать записи для пользователя с именем name.