Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

A.12.1 history 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 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.)


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


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:









One of five 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.


A working file was patched to match 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 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.

  Published under the terms of the GNU General Public License Design by Interspire