Added module docstrings (which will later be used by the installer script.

plugins/BadWords.py

@@ -29,6 +29,17 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Filters bad words on outgoing messages from the bot, so the bot can't be made
+to say bad words.
+
+Commands include:
+  addbadword
+  removebadword
+  addbadwords
+  removebadwords
+"""
+
 from baseplugin import *
 
 import re

plugins/ChannelLogger.py

@@ -29,7 +29,9 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
-"""Logger: Logs channels in a format similar to most IRC clients."""
+"""
+Logs each channel to its own individual logfile.
+"""
 
 from baseplugin import *
 

plugins/ChannelStats.py

@@ -29,6 +29,15 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Silently listens to every message received on a channel and keeps statistics
+concerning joins, parts, and various other commands in addition to tracking
+statistics about smileys, actions, characters, and words.
+
+Commands include:
+  seen
+"""
+
 from baseplugin import *
 
 import re

plugins/Ctcp.py

@@ -29,6 +29,11 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Handles standard CTCP responses to PING, TIME, SOURCE, VERSION, USERINFO, 
+and FINGER.
+"""
+
 from baseplugin import *
 
 import os

plugins/Factoids.py

@@ -29,6 +29,20 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Handles "factoids," little tidbits of information held in a database and 
+available on demand via several commands.
+
+Commands include:
+  addfactoid
+  removefactoid
+  lookupfactoid
+  lockfactoid
+  unlockfactoid
+  randomfactoid
+  factoidinfo
+"""
+
 from baseplugin import *
 
 import time

plugins/FixRelayBot.py

@@ -29,6 +29,11 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Allows people behind a relaybot (which uses <nick@network> to relay messages)
+to access the bot.
+"""
+
 from baseplugin import *
 
 import re

plugins/Forums.py

@@ -29,6 +29,12 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Reads URLs from a channel, generally for web-based forums, and messages the
+channel with useful information about the URL -- its forum, title, original
+poster, etc.
+"""
+
 from baseplugin import *
 
 import re

plugins/FreeBSD.py

@@ -29,6 +29,16 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides FreeBSD ports searching and other FreeBSD-specific services.
+
+Commands include:
+  numports
+  searchports
+  randomport
+  portinfo
+"""
+
 from baseplugin import *
 
 import string

plugins/FunCommands.py

@@ -29,6 +29,34 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides a multitude of fun, useless commands.
+
+Commands include:
+  netstats
+  ord
+  chr
+  base
+  hexlify
+  unhexlify
+  xor
+  mimetype
+  md5
+  sha
+  urlquote
+  urlunquote
+  rot13
+  coin
+  dice
+  leet
+  cpustats
+  uptime
+  calc
+  objects
+  last
+  lastfrom
+"""
+
 from baseplugin import *
 
 import os
@@ -315,8 +343,6 @@ class FunCommands(callbacks.Privmsg):
         except Exception, e:
             irc.reply(msg, debug.exnToString(e))
 
-    math = calc
-
     def objects(self, irc, msg, args):
         "takes no arguments.  Returns the number of Python objects in memory."
         objs = gc.get_objects()

plugins/FunDB.py

@@ -29,6 +29,24 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides fun commands that require a database to operate.
+
+Commands include:
+  crossword
+  anagram
+  addword
+  lart
+  addlart
+  removelart
+  excuse
+  addexcuse
+  removeexcuse
+  insult
+  addinsult
+  removeinsult
+"""
+
 from baseplugin import *
 
 import string

plugins/Http.py

@@ -29,6 +29,19 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides several commands that go out to websites and get things.
+
+Commands include:
+  freshmeat
+  stockquote
+  foldoc
+  gkstats
+  zipcode
+  weather
+  slashdot
+"""
+
 from baseplugin import *
 
 import re

plugins/Quotes.py

@@ -29,6 +29,17 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Maintains a Quotes database for each channel.
+
+Commands include:
+  addquote
+  removequote
+  maxquote
+  randomquote
+  quoteinfo
+"""
+
 from baseplugin import *
 
 import re

plugins/Topic.py

@@ -29,6 +29,15 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides commands for manipulating channel topics.
+
+Commands include:
+  addtopic
+  removetopic
+  shuffletopic
+"""
+
 from baseplugin import *
 
 import re

plugins/Unix.py

@@ -29,6 +29,15 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Provides commands available only on Unix.
+
+Commands include:
+  errno
+  progstats
+  crypt
+"""
+
 from baseplugin import *
 
 import os

plugins/Utils.py

@@ -29,6 +29,14 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ###
 
+"""
+Various utility commands, mostly useful for manipulating nested commands.
+
+Commands include:
+  strjoin
+  strconcat
+"""
+
 from baseplugin import *
 
 import privmsgs