/ 
VCS-SnapshotCM-0.02
River stage zero No dependents
/ whistory

NAME

whistory - Show history between snapshots

SYNOPSIS

whistory {options} source-snapshot [target-snapshot]

options:

-h, --host, --server=SERVER     server hostname
-x, --exclude=FILE              exclude files named FILE
-X, --exclude-regexp=PATTERN    exclude files matching PATTERN
-C, --changelog                 write history in changelog format
-r, --reverse                   reverse history output

--(no)color                     (don't) use colored output
--warnings                      print additional warnings

-?, --help                      show this help
--man                           show manpage
--version                       print version information

Inside a mapped directory target-snapshot is optional. Use '.' for source-snapshot if there's no source snapshot.

DESCRIPTION

The whistory tool can be used to display the history between different snapshots of a SnapshotCM project.

OPTIONS

-h, --host, --server hostname

Specify the hostname of the SnapshotCM server. whistory uses various heuristics to figure out which hostname to use, so you'll rarely have to specify this option.

-x, --exclude file

Exclude all files named file. Can be given multiple times.

-X, --exclude-regexp pattern

Exclude all files matchin pattern. Can be given multiple times. Patterns are Perl regular expressions (see perlre).

-C, --changelog

Write output in changelog format. This output is never colored.

-r, --reverse

Write history output in reverse order, i.e. newest changes first.

--(no)color

Use or don't use color in the output. The default is chosen depending on your terminal. When piping the colored output into less, you may need to use less -R to display the colors correctly.

--warnings

Enable printing of additional warnings.

EXAMPLES

Display all changes that since snapshot 0.54 while being in a mapped directory:

whistory 0.54

Display all changes between snapshots 0.40 and 0.42 of project foobar, excluding all files named Makefile:

whistory -x Makefile /foobar/0.40 0.42

Display all changes since snapshot 0.50, excluding all *.h files and all files matching readme (case insensitive). Use changelog format:

whistory -X '\.h$' -X '/readme/i' --changelog 0.50

Display all changes made between creating the project and snapshot 0.01:

whistory - 0.01

COPYRIGHT

Copyright (c) 2004 Marcus Holland-Moritz. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SnapshotCM is copyright (c) 2000-2003 True Blue Software Company.

SEE ALSO

See whist, wannotate, VCS::SnapshotCM::Tools.