history [ report] [ flags] [ options args] [files...]

Requires: the file '$CVSROOT/CVSROOT/history'

Changes: nothing.

cvs keeps a history file that tracks each use of the checkout, commit, rtag, update, and release commands. You can use 'cvs history' to display this information in various formats.

Warning: 'cvs history' uses ' f', ' l', ' n' and ' p' in ways that conflict with the descriptions in "Common Command 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).

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.

T Report on all tags.

x typ Extract a particular set of record types X from the cvs history. The types are indicated by single letters, which you may specify in combination. Certain commands have a single record type: checkout (type 'O'), release (type 'F'), and rtag (type 'T'). One of four record types may result from an update: 'W', when the working copy of a file is deleted during update (because it was gone from the repository); 'U', when a working file was copied from the repository; 'G', when a merge was necessary and it succeeded; and 'C', when a merge was necessary but collisions were detected (requiring manual merging). Finally, one of three record types results from commit: 'M', when a file was modified; 'A', when a file is first added; and 'R', when a file is removed.

e Everything (all record types); equivalent to specifying ' xMACFROGWUT'.

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

a Show data for all users (the default is to show data only for the user executing 'cvs history').

l Show last modification only.

w Show only the records for modifications done from the same working directory where 'cvs 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.

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 flagabove in that it reads only the history file, not the RCS files, and is much faster.

u name Show records for user name.