README for the web-interface component of CVSZilla.
----------------------------------------------------------------------

1. Introduction
2. Installation instructions

======================================================================
1. Introduction

The software in this directory is used to query and view transactions
recorded by the CVS-support component of CVSZilla.

It integrates with Bugzilla and CVSWeb to provide a richly-linked
interface to the source-code repository and job-tracking system.

This software is released under Perl's "Artistic License". Please see
http://www.perl.com/language/misc/Artistic.html for details.

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

That is, if this code breaks your repository, it's not my
fault. Similarly for s/repository/bugzilla/.

======================================================================
2. Installation instructions

These CGI scripts need to be run on a webserver with access to the
Bugzilla (and VC (from the CVS-support component)) MySQL databases -
be it locally, or via the network. You need to have the MySQL Perl
modules installed as for Bugzilla itself.

1. Configure globals.pl
   - modify $help_url to point to a help file describing various
     general-job IDs
   - modify $bugzilla_path_url to point to the URL (absolute or
     relative) where Bugzilla's CGIs live
   - modify $cvsweb_cgi_url to point to the CVSWeb or ViewCVS CGI script
   - modify $logo_url to point to a pretty picture for the banner
   - modify $maintainer_email to contain the address of the webmaster
     responsible for CVSZilla administration.
   - change $table_bg to the colour you would like table rows to use
     if you're not happy with the default (#eeeeff is quite nice)

   - Check the line

	$db = Mysql->Connect("localhost", "vc", "vc", "")
	    || diePrinting("Could not connect to VC database");

     in globals.pl to make sure that it will connect to your database
     correctly.

2. Put the files in your webtree and configure your webserver for CGI
   execution.

That should take care of it.
