NAME:

   cvshis - converts a history file into readable format, and summaries
            number of events.

SYNOPSIS:

   cvshis [-acdhqxT] [-m mod] [-s date] [-t date] [-u user] [-z zone] [file]

DESCRIPTION:

   cvshis converts a cvs history file into readable format. Since history
file is normally very large, use '-s', '-t', '-m', '-u' options to reduce
the output.


MAJOR OPTIONS:

    -m module:
        report events of this module only. e.i. 'cvshis -m bbsim'.

    -s date:
        report events since this date. The date can be in almost any
        conceivable format. e.i.

          -s yesterday
          -s "-3 days"
          -s "last year"
          -s "1996"
          -s "6/23/95"

    -t date:
        report events til this date. The date can be in almost any
        conceivable format (see -s option).

    -u name:
        report events generated by this user only. e.i. 'cvshis -u terryh'.

MINOR OPTIONS:
    -a:
        report the whole history file. This may take VERY long time.

    -c:
        count events only, default is printing report plus counting events.

    -d:
        debug

    -h:
        help

    -q:
        quiet

    -T:
        trace

    -x dir:
        split history file into years and save them in <dir>. This option
        is meant to be used by system managers only. Typical sequence is
        split history file with 'cvshis -x $CVSROOT/CVSROOT', then remove
        $CVSROOT/CVSROOT/history, and copy $latest.history (e.g.
        1997.history) to $CVSROOT/CVSROOT/$history.

    -z zone:
        display in this time zone, e.g. -z -0200, -z LT. "LT" means local
        time zone. Default Time zone is -0700 (Pacific Time), which is also
        the time zone of SLAC.

    file:
        take this history file. Default input file is
        $CVSROOT/CVSROOT/history.

EXAMPLES:

    cvshis
        get usage of cvshis.

    cvshis -a
        report every events in $CVSROOT/CVSROOT/history. This may take very
        long time.

    cvshis -m bbsim
        report all bbsim events

    cvshis -u mark
        report all events done by mark.

    cvshis -s "-3 days" -t "-1 days"
        report all events occurred in a time period.

    cvshis -c -s yesterday
        report a event count since yesterday.

FILES:

    $CVSROOT/CVSROOT/history: the CVS history file. Contains log of most operations
        except remove.

    $CVSROOT/CVSROOT/commitlog: the CVS commitlog file. Contains log of commit and
        remove.

    $CVSROOT/bin.$ARCHNAME/cvshis: this executable

OLDER HISTORY:

    Older history records are kept in $CVSROOT/CVSROOT/ARCHIVE. e.g:
    $ ls $CVSROOT/CVSROOT/ARCHIVE
      commitlog-98-99
      commitlog-99-00
      history-1999
      history-2000

   To get previous history with cvshis, simply specify the history file:

   cvshis /afs/slac.stanford.edu/g/babar/repo/CVSROOT/ARCHIVE/history-1999

   To get previous history with 'cvs history' command, there must be a
soft link $CVSROOT/CVSROOT/ARCHIVE/<year>/CVSROOT/history pointing to
the history file. e.g.

   $ ls -l $CVSROOT/CVSROOT/ARCHIVE/*/CVSROOT/history

   /afs/slac.stanford.edu/g/babar/repo/CVSROOT/ARCHIVE/1999/CVSROOT/
   history -> ../../history-1999

   select the year and use the 'cvs history' command with '-d' option
pointing to this year:

   cvs -d $CVSROOT/CVSROOT/ARCHIVE/1999 history