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