A.12.1 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 cvs; 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 cvs
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 five 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.
P
- A working file was patched to match 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.