README.txt for CVSZilla 2.0
======================================================================
This is CVSZilla, a small piece of Perl-glue to integrate CVS,
Bugzilla and CVSWeb or ViewCVS with each other. It also extends CVS to
give rudimentary support to "change-sets", or "transactions", after a
fashion. (They're probably not *exactly* what most people refer to as
change-sets, but they're close enough for our use here.)

The 'cvssupport' directory contains code to plug in to CVS to make it
record information about every commit or tag that goes into the
repository into a MySQL database.

The 'cvszilla' directory contains CGI scripts which allow querying of
the recorded information - for instance:

	- what transactions went against bug 1234?
	- what transactions did user jsmith make against module FOO?
	- what transactions have been committed since Sep 4th, 4pm?
	- which tags have been created since Jan 1st?

It's minimally documented in README.txt files in each directory. Note
that the code is short and concise - it's the best documentation there
is. If you're not sure, Use The Source!

I'd love to hear about any projects that end up using this software -
every author likes to know that he/she is read :-) - and if you make
any changes you think others would be interested in, please send them
to me at:

	Tony Garnock-Jones <tonyg@eservglobal.com>

See the file AUTHORS for a list of some of the contributors to the
current version of CVSZilla.

One last thing - the whole thing is licensed under Perl's Artistic
License, so you can do more-or-less what you please with it. For
details, see http://www.perl.com/language/misc/Artistic.html.

Hope you enjoy the software :-)
 -- Tony
