                              + ZEBOT +
                                =====


Homepages:
=========
http://savannah.gnu.org/projects/zebot
http://www.freesoftware.fsf.org/zebot/

ABOUT
=====

This is the 'zebot' distro, on many irc channels better known as the
'toutou' nuisance :D. Read the html docu, or the developer POD docu
inbuild in the scripts for more info (perldoc
thefile_you_are_interested_in).

It is a ircbot (Internet Relay Chat roBot) written in perl, extensible through
self-writable perl - modules using OO-techniques. 

This IRC robot accompanies you on your favorite channels and obeys your
commands and reacts to external triggers. 

Thought more as a toy, even if channel camping facilities and user
managment are included, more coming: 
the thing acts as a dog :D 

You can teach him additionnal tricks. 

USAGE
=====

First install the package (see INSTALL file)

Run the ./zebot.pl script from a shell to start the thing.

Once started the bot connects itself to the servers specified in the
server.conf file and then joins on each server the channels as
configured in the file server.conf.

Fire up your own irc-client and connect yourself to the same servers/channels.
Depending on the functionalities/modules you installed and activated the bot
now reacts to what happens on the channel or on commands send to him directly
through private messages.
 
The use should be quite straightforward, and you might want to rely
on the online help, sending /msg toutou help [topic] to fetch it. Of course,
you can change the botname from toutou to anything else in the zebot.conf
file.


THANKS
======

J-M Libs for launching the idea and reviewing the README and INSTALL files
Rocco Caputo for extensivley helping me to understand POE and debugging this
bot
