Synopsis: history [-report] [-flags] [-options args] [files...]
Requires: the file $CVSROOT/CVSROOT/history
cvsnt can keep a history file that tracks each use of the checkout, commit, rtag, update, and release commands. You can use history to display this information in various formats.
Logging must be enabled by creating the file $CVSROOT/CVSROOT/history.
Warning: history uses -f, -l, -n, and -p in ways that conflict with the normal use inside cvsnt (the section called “Common command options”).
Several options (shown above as -report) control what kind of report is generated:
Report on each time commit was used (i.e., each time the repository was modified).
Everything (all record types). Equivalent to specifying -x with all record types. Of course, -e will also include record types which are added in a future version of cvsnt; if you are writing a script which can only handle certain record types, you'll want to specify -x.
Report on a particular module. (You can meaningfully use -m more than once on the command line.)
Report on checked-out modules. This is the default report type.
Report on all tags.
Extract a particular set of record types
type from the cvsnt history. The types are
indicated by single letters, which you may specify in
Certain commands have a single record type:
One of four record types may result from an update:
A merge was necessary but collisions were detected (requiring manual merging).
A merge was necessary and it succeeded.
A working file was copied from the repository.
The working copy of a file was deleted during update (because it was gone from the repository).
One of three record types results from commit:
A file was added for the first time.
A file was modified.
A file was removed.
The options shown as -flags constrain or expand the report without requiring option arguments:
Show data for all users (the default is to show data only for the user executing history).
Show last modification only.
Show only the records for modifications done from the same working directory where history is executing.
The options shown as -options
args constrain the report based on an
Show data back to a record containing the string
str in either the module name, the file name,
or the repository path.
Show data since
date. This is slightly
different from the normal use of -D
date, which selects the newest
revision older than
Show data for a particular file (you can specify several -f options on the same command line). This is equivalent to specifying the file on the command line.
Show data for a particular module (you can specify several -n options on the same command line).
Show data for a particular source repository (you can specify several -p options on the same command line).
Show records referring to revisions since the revision or
rev appears in individual rcs
files. Each rcs file is searched for the revision or tag.
Show records since tag
tag was last
added to the history file. This differs from the
-r flag above in that it reads only the
history file, not the rcs files, and is much faster.
Show records for user
Show times in the selected records using the specified time zone instead of UTC.