history--Show status of files and users

history--Show status of files and users
Prev	Appendix A. Guide to CVS commands	Next

Synopsis: history [-report] [-flags] [-options args] [files...]
Requires: the file $CVSROOT/CVSROOT/history
Changes: nothing.

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”).

history options

Several options (shown above as -report) control what kind of report is generated:

-c

Report on each time commit was used (i.e., each time the repository was modified).

-e

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.

-m module

Report on a particular module. (You can meaningfully use -m more than once on the command line.)

-o

Report on checked-out modules. This is the default report type.

-T

Report on all tags.

-x type

Extract a particular set of record types type from the cvsnt history. The types are indicated by single letters, which you may specify in combination.

Certain commands have a single record type:

F: release
O: checkout
E: export
T: rtag

One of four record types may result from an update:

C: A merge was necessary but collisions were detected (requiring manual merging).
G: A merge was necessary and it succeeded.
U: A working file was copied from the repository.
W: 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: A file was added for the first time.
M: A file was modified.
R: A file was removed.

The options shown as -flags constrain or expand the report without requiring option arguments:

-a: Show data for all users (the default is to show data only for the user executing history).
-l: Show last modification only.
-w: 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 argument:

-b str: Show data back to a record containing the string str in either the module name, the file name, or the repository path.
-D date: Show data since date. This is slightly different from the normal use of -D date, which selects the newest revision older than date.
-f file: 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.
-n module: Show data for a particular module (you can specify several -n options on the same command line).
-p repository: Show data for a particular source repository (you can specify several -p options on the same command line).
-r rev: Show records referring to revisions since the revision or tag named rev appears in individual rcs files. Each rcs file is searched for the revision or tag.
-t 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.
-u name: Show records for user name.
-z timezone: Show times in the selected records using the specified time zone instead of UTC.

Prev	Up	Next
export--Export sources from CVS, similar to checkout	Home	import--Import sources into CVS, using vendor branches