		BotRover 1.0 Instalation notes and README

	Hello, hello again fellas. :) I'm back with another almost
great, almost complete, almost kick ass script, that (if XDCC was any
gauge) should almost work! :)

	Good thing this is still beta eh? And Lucky you! Your
gonna test it for me! (I hope). 

	As with all my previous scripts (flagnote, & xdcc) PLEASE 
mail me with problems you encounter, my E-mail is at the end of this
document, or catch me on the Eggdrop mailing list.

	First it's features, then it's Instalation... After that, there are
a few notes that I feel are REAL important if you read, (like what to do
incase of a screwup).

FEATURES:
	* Unlimited channel roaming capibility.

	* Interfaces with Keyoke's XDCC Script v2.3 & Higher
	  (Does Automatic Public Listing (APL) on channel Joins)
	
	* Actual documentation, instead of just looking at the script
	  and trying to figure out what it does itself.
          (No documentatin is my BIGGEST pet peeve, I HATE looking at 
           a script, and not knowing what the hell it does)
 
	* Compleate On-Line, Cross Refrenced help. 
          (No help is another big peeve of mine)

	* You get to read my witty humor throughout this whole document,
	  along with poor spelling, run-on sentances, and other acts of
	  sacrilige towards the English language as a whole. 
          (Fuggit, everyone should speak Keyokeism, and make my life easier)


INSTALLATION:

	Simple. (Yea, right) ;)

	1.  Place rover into your standard Tcl script directory.

	2.  Edit the file rover.dat to reflect the channels you wish
            the bot to visit. 

        3.  Edit the rover.tcl script, and find the line that looks
            like this:
           
            set rover_data_file "/home/ircstuff/bots/tcl/rover/rover.dat"
            
            And change it to point to the datafile you edited. 

       4a. FOR NON XDCC USERS:
           Place the line "source /path/to/rover.tcl" in your eggdrop
           startup file (i.e. lamestbot)

       4b. FOR XDCC USERS:
           Place the line "source /path/to/rover.tcl" in your eggdrop
           startup file (i.e. lamestbot) AFTER you've loaded the XDCC
           script.

       5.  Copy the dcc.rover* files into your bot's help directory.

       6.  Start, or rehash your bot. 


NOTES:

	There are a few things to be aware of. Scince this software is 
BETA, it might do weird things... for instance, your bot might end up in
every channel listed in your rover.dat file at the same time... I've only
been able to create this problem ONE WAY, and I strongly suggest you avoid 
getting into the above mentiond problem by READING THE FOLLOWING CAREFULLY!!

_BEFORE_ YOU ISSUE A .REHASH COMMAND, MAKE SURE TO DO A .ROVER OFF IF
BOTROVER IS ENABLED! FAILURE TO DO SO CAN CAUSE PROBLEMS!!!

	If you forget to do the above, and find yourself with your mouth
hanging open and your eyes bulging out of your head because 5 users are
DCCing 5+ meg files, and your bot is now in 5 different channels, and your
afraid that your going to have to shut the bot down to rectify the problem
because your bot isn't recognizing anyone except for those users in a dcc
chat and those ppl in the last channel it joined... don't say I didn't warn
you....

	And, because I'm such a nice guy (and I don't want ppl to bitch),
I'll tell you how to get out of that mess, so read on. :)



"OH SHIT!" PROCEDURE

	If you find yourself in the aformentioned problem, don't panic
(well, not to much anyways) it's easy enough to fix, follow the following
steps:

	1. type .rover off

	2. For each channel the bot is in that it's not supposed to be,
           type:
		.dump PART CHANNEL_NAME 
                (Lag may cause a delay in response from this command)

        3. If your bot isn't in it's origional home-channel, type the
	   following:
		.set home-channel "whatever it is"
                .set channel      "whatever your homechannel is"
                .dump JOIN "whatever your homechannel is"
		(Lag may cause a delay in response from this command)

	4. Then, preform another rehash.

	IF THE ABOVE DOESN'T WORK -- PANIC! :)



AFTERWORD:

	As you can tell, I tried to make this as professional-like as
possible. Actually, I never really claimed to be a document writer, heck, I
never even claimed to be a good Tcl Script writer, but then again... ;)

	The copy policy on BotRover is GNUish, I'd list the whole damn thing
here, but it'd wear my fingers out, and no one would really read it, so if
you decide to modify the script, please give me some credit somewhere, ok?
:)

	Oh, scince this is the only document I feel like wrighting because
it's 4am once again and I'm getting tired, and my spelling is worse than
normal.. so is my grammar for that matter... 

	anyways, read the helps. That's what they are there for. Everything
should be fairly well documented. I took the liberty of assuming that those
of us who need to use the helps will want sections highlighted, and so I
placed the ^B (ircII Bold char) infront of all the important stuff. mIRC
users will just see garbage for ever ^B character, but who cares, mIRC sucks
anyways, right? :)

	-Sweet Dreams & Happy Roving!-

		Keyoke
		(keyoke@falcon.inetnebr.com)
