Go to file
Jeremy Fincher df45ce1195 Fixed html stripping in foldoc. 2003-03-26 10:14:10 +00:00
docs New style guidelines for SQL. 2003-03-26 00:15:08 +00:00
examples Initial revision 2003-03-12 06:26:59 +00:00
others Initial import; workaround for bug in Python 2.2 rfc822.py 2003-03-25 23:24:38 +00:00
plugins Fixed html stripping in foldoc. 2003-03-26 10:14:10 +00:00
sandbox Removing sandbox/makescript.py 2003-03-26 01:16:20 +00:00
scripts Initial import; expect function and roadmap done. 2003-03-25 07:13:59 +00:00
src PyChecker found unused imports 2003-03-26 10:09:06 +00:00
tools Added vim:set ... : strings to source in order to keep file formatting 2003-03-24 08:41:19 +00:00
.cvsignore Initial revision 2003-03-12 06:26:59 +00:00
ACKS Initial revision 2003-03-12 06:26:59 +00:00
BUGS Added link to SF.net page 2003-03-25 23:21:42 +00:00
CHANGELOG Initial revision 2003-03-12 06:26:59 +00:00
LICENSE Initial revision 2003-03-12 06:26:59 +00:00
README Initial revision 2003-03-12 06:26:59 +00:00
TODO Took out a few things, added a few things. 2003-03-26 06:33:03 +00:00

README

EVERYONE:
---------
Read LICENSE.  It's a 2-clause BSD license, but you should read it anyway.


PROGRAMMERS:
------------
Read OVERVIEW to see what the modules are used for.  Read EXAMPLE to see some
examples of callbacks and command written for the bot.  Read STYLE if you ever
wish to contribute.

All contributions need to assign the copyright to Jeremiah Fincher for
licensing and modification purposes.  I'll probably change the modules to fit
STYLE if they don't already fit.  (Of course, that doesn't mean 'all
modifications'; only if you want your code to be included in the *standard
distribution* of Supybot do you need to assign to me the copyright.  If you
don't mind distributing your modifications or additions elsewhere, by all means
keep the copyright.)

Use PyChecker.  Believe me, it makes things better.


USERS:
------
Read conf.py to see what kind of configuration options you have available.  In
order to actually connect to a server on the internet, you'll want to modify
the "drivers" option, changing the server "localhost" to the appropriate value.
You'll probably also want to change the channels that are joined by modifying
the configuration for the "callbacks.ChannelJoiner" callback.  This should all
be done in a separate file, as per the example in sample.conf.

To run the bot, do it from this directory, like this:

src/bot.py

If you have your own configuration file (the bot will still use conf.py as its
set of defaults, but will override it with whatever it finds in your file) use:

src/bot.py -c yourconfig.py

I've included slightly patched versions of asyncore and asynchat so they don't
make PyChecker complain, and use some newer features (mostly {}.iter*) of 2.2.