-*- kwotes install instructions -*-

Thanks for trying kwotes.  Please forgive how slim this
INSTALL file is... at least there is one :)

WHAT YOU NEED:
--------------------------------------------------------------------------------------
	CGI/Perl enabled web server
	Mysql
	DBI
	DBD::Mysql

INSTALLING DBI and DBD:Mysql:
--------------------------------------------------------------------------------------
	At a console:

	perl -MCPAN -eshell

	In the CPAN console:

	install Bundle::DBI
	install DBD::mysql


EXTRACTING THE TARBALL:
--------------------------------------------------------------------------------------
	tar -zxvf kwotes.tar.gz

SETTING UP THE DATABASE:
--------------------------------------------------------------------------------------
	Add the required kwotes tables to the database (in the directory where you
	extracted kwotes):

	mysql -u database_user -D database_name -h database_host_name -p < kwotes.sql

CONFIGURING KWOTES:
--------------------------------------------------------------------------------------
	Open kwotes.conf.pl in your favorite text editor and modify as needed.  The 
	only values that you MUST change are in the database section. They are:
		
		$DB_TYPE - the database type (Must be mysql for now)
		$DB_NAME - the name of the database on the database server
		$DB_HOST - the hostname or ip address of the database server
		$DB_USER - the username for connecting to the database
		$DB_PASS - the password for connecting to the database

	Other options that are cool for tweaking the functionality of kwotes can be
	found in the "GENERAL STUFF" section of the configuration file.

SETTING PERMISSIONS:
--------------------------------------------------------------------------------------
	Setting everything to 755 (rwxr-xr-x) doesn't hurt:
	
	cd kwotes-directory;
	chmod -R 755 *

	You can come up with something more restrictive if you like.

CUSTOMIZING:
--------------------------------------------------------------------------------------
	Kwotes can be easily customized by editing the files in the "html" directory
	directly beneeth the kwotes directory.  You can change the "site name" and
	tagline (text that apears at the top of every page) by editing kwotes.conf.pl

FEEDBACK:
--------------------------------------------------------------------------------------
	"It's broken you mofos!":
	sux0r, well... submit a bug report at: 
	http://sourceforge.net/tracker/?atid=690836&group_id=121598&func=browse

	"Hey, you should implement [insert your idea here]!"
	sweet, submit a feature request here, and we'll see what we can do:
	http://sourceforge.net/tracker/?group_id=121598&atid=690839