

	Platforms:
	Win32 [Tested on windows 95]
	Linux [Tested on Slackware Linux]

	IRCD:
	DALnet [Tested on versions Dal4.2 to first DF release]

	If you're in a unix type system, linux, whatever,
	you may need to alter the first line of code in
	the files service.pl and Configure to point to
	your perl binary.

	The quick and dirty, get to the point, lines...
	---
	read docs/SETUP (unless you're already know how to setup ircd.conf)

	perl Configure
	perl service.pl

	"send the file 'passwords.lst' to your trusted admins, auto generated
	when you run service.pl."
	---
	But you really should read the following...

	There's nothing to install really.  You should have recieved at
	least one tared and gziped file, or ziped on windows platforms.

	If you can see this INSTALL file, you've probably already
	unpacked and uncompressed the package.  One way to do this is
	to issue the command

	tar xvzf myentirefilename

	Please replace myentirefilename with the name of the package,
	which is the filename.  Now, my limited information has lead me
	to believe that all things are not the same on all UNIX type
	systems.  So let me give you another way to unpack this Control
	System...

	gzip -dc myentirefilename | tar xvf -

	Please don't forget to include the "-" or all you will get is a
	pretty display.  That last line is NOT a seperate step you need
	to take, it is an "either or" thing.  Now, like I said, my
	limited knowlage prevents me from knowing why one way will work
	and not the other but you don't need to do both.  Simply use
	what works.

	Once the package is decompressed and unpacked, which it
	probably already was, you may need to change the first line of
	two files, if you're on a linux (unix) type system. 
	DOS/WINDOWS don't care.  The first line of the file for
	Configure and service.pl must point to your perl binary, which
	many can determin by simply typeing, at the command prompt,
	"which perl".  Some comman first liners are as follows, you
	need only one!...

	#!/usr/bin/perl
	#!/usr/local/perl
	#!/usr/local/bin/perl

	Then you'll want to run the configurator, which will ask you a
	series of questions so that it can configure the application
	for your system without the need for you to edit any config
	file or perl script.  If you choose, however, to edit the
	config file yourself you'll find it in the main application
	directory with the name "service.conf".  If, instead, you use
	the Configure program, it will generate a file called
	"options.conf" which you can edit later if you like.  To get
	started, just type

	Configure

	If this produces an error, check that the perl binary, or at
	least a link to it, exists in the directory you pointed to at
	the begining of the Configure and service.pl files.

	ls -la /usr/local/bin/perl

	If all went well, and the script finished, you'll want to follow
	its instructions by typing

	service.pl

	Some other systems may require you to type a varient, like one
	of the following

	./service.pl
	perl ./service.pl
	perl service.pl

	If you're server doesn't let the service connect then you might
	want to read the file docs/SETUP

	Now, logon to your irc server and simply ask nickserv for some
	help /msg nickserv help (or whatever you chose to call your
	nick name service) and you should get a display.  If not, well,
	there's a problem.  My first suggestion is to take a look at
	the service.conf or options.conf file again.  Unless you got
	an error stating otherwise, it's probably one of those files
	that's causing your system to fail.

	I think that's about it.  I'm sure there's a more proffessional
	way to distribute this package and to explain what it does and
	how to configure it but, well, I'll learn as I go.

	Submit your bug report to Daniel <dent@abonica.net>

	Please set the subject of your message to something exciting,
	like so...

	Subject: BUG - FruitBrick IRCCS v2.0.0
	Subject: BUG - Configure v1a
	Subject: BUG - VocalChunk v1

	or whatever version you're reporting a bug on and of course a
	complete description of the bug, what you did to encounter it
	and if you were able to reproduce it.

	Thank you :)

Daniel J. Wightman <dent@abonica.net>

[ aka: UrbanFizBoz / FruitBrick ]


