Go to file
2003-03-25 06:53:51 +00:00
docs Initial revision 2003-03-12 06:26:59 +00:00
examples Initial revision 2003-03-12 06:26:59 +00:00
others Added vim:set ... : strings to source in order to keep file formatting 2003-03-24 08:41:19 +00:00
plugins Added module docstrings (which will later be used by the installer script. 2003-03-25 06:53:51 +00:00
sandbox Added vim:set ... : strings to source in order to keep file formatting 2003-03-24 08:41:19 +00:00
scripts Added vim:set ... : strings to source in order to keep file formatting 2003-03-24 08:41:19 +00:00
src Added vim:set ... : strings to source in order to keep file formatting 2003-03-24 08:41:19 +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 Initial revision 2003-03-12 06:26:59 +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 Initial revision 2003-03-12 06:26:59 +00:00

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.