14 files changed, 70 insertions, 10 deletions

diff --git a/Mailman/Archiver.py b/Mailman/Archiver.py
index 038501a82..0b7113fcf 100644
--- a/Mailman/Archiver.py
+++ b/Mailman/Archiver.py
@@ -1,3 +1,11 @@
+"""Mixin class for putting new messages in the right place for archival.
+
+Public archives are separated from private ones.  An external archival
+mechanism (eg, pipermail) should be pointed to the right places, to do the
+archival."""
+
+__version__ = "$Revision: 394 $"
+
 import sys, os, string
 import mm_utils, mm_mbox, mm_cfg, mm_message
 
diff --git a/Mailman/Bouncer.py b/Mailman/Bouncer.py
index 4e1984a63..7d2bbfc36 100644
--- a/Mailman/Bouncer.py
+++ b/Mailman/Bouncer.py
@@ -1,3 +1,7 @@
+"Handle delivery bounce messages, doing filtering when list is set for it."
+
+__version__ = "$Revision: 394 $"
+
 # It's possible to get the mail-list senders address (list-admin) in the
 # bounce list.   You probably don't want to have list mail sent to that
 # address anyway.
diff --git a/Mailman/Deliverer.py b/Mailman/Deliverer.py
index 2f8eda012..8d9f68a4c 100644
--- a/Mailman/Deliverer.py
+++ b/Mailman/Deliverer.py
@@ -1,3 +1,8 @@
+"""Mixin class with message delivery routines."""
+
+__version__ = "$Revision: 394 $"
+
+
 import string, os, sys, tempfile
 import mm_cfg, mm_message, mm_err, mm_utils
 
diff --git a/Mailman/Digester.py b/Mailman/Digester.py
index e76bb582c..8ed9fb2e7 100644
--- a/Mailman/Digester.py
+++ b/Mailman/Digester.py
@@ -1,3 +1,7 @@
+"""Mixin class with list-digest handling methods and settings."""
+
+__version__ = "$Revision: 394 $"
+
 import mm_utils, mm_err, mm_message, mm_cfg
 import time, os, string
 
diff --git a/Mailman/ListAdmin.py b/Mailman/ListAdmin.py
index d646e2c9e..61a0473fa 100644
--- a/Mailman/ListAdmin.py
+++ b/Mailman/ListAdmin.py
@@ -1,3 +1,7 @@
+"""Mixin class which handles of administrative requests."""
+
+__version__ = "$Revision: 394 $"
+
 # When an operation can't be completed, and is sent to the list admin for
 # Handling, we consider that an error condition, and raise MMNeedApproval
 
diff --git a/Mailman/MailList.py b/Mailman/MailList.py
index 2d62d7f4d..24c677fd5 100644
--- a/Mailman/MailList.py
+++ b/Mailman/MailList.py
@@ -1,8 +1,6 @@
-# Notice that unlike majordomo, message headers/footers aren't going
-# on until After the post has been added to the digest / archive.  I
-# tried putting a footer on the bottom of each message on a majordomo
-# list once, but it sucked hard, because you'd see the footer 100
-# times in each digest.
+"The class representing a mailman maillist.  Mixes in many feature classes."
+
+__version__ = "$Revision: 394 $"
 
 try:
     import mm_cfg
diff --git a/Mailman/htmlformat.py b/Mailman/htmlformat.py
index c2e568deb..53bfe1240 100644
--- a/Mailman/htmlformat.py
+++ b/Mailman/htmlformat.py
@@ -1,3 +1,10 @@
+"""Library for program-based construction of an HTML documents.
+
+Encapsulate HTML formatting directives in classes that act as containers
+for python and, recursively, for nested HTML formatting objects."""
+
+__version__ = "$Revision: 394 $"
+
 # Eventually could abstract down to HtmlItem, which outputs an arbitrary html
 # object given start / end tags, valid options, and a value.
 # Ug, objects shouldn't be adding their own newlines.  The next object should.
diff --git a/modules/htmlformat.py b/modules/htmlformat.py
index c2e568deb..53bfe1240 100644
--- a/modules/htmlformat.py
+++ b/modules/htmlformat.py
@@ -1,3 +1,10 @@
+"""Library for program-based construction of an HTML documents.
+
+Encapsulate HTML formatting directives in classes that act as containers
+for python and, recursively, for nested HTML formatting objects."""
+
+__version__ = "$Revision: 394 $"
+
 # Eventually could abstract down to HtmlItem, which outputs an arbitrary html
 # object given start / end tags, valid options, and a value.
 # Ug, objects shouldn't be adding their own newlines.  The next object should.
diff --git a/modules/maillist.py b/modules/maillist.py
index 2d62d7f4d..24c677fd5 100644
--- a/modules/maillist.py
+++ b/modules/maillist.py
@@ -1,8 +1,6 @@
-# Notice that unlike majordomo, message headers/footers aren't going
-# on until After the post has been added to the digest / archive.  I
-# tried putting a footer on the bottom of each message on a majordomo
-# list once, but it sucked hard, because you'd see the footer 100
-# times in each digest.
+"The class representing a mailman maillist.  Mixes in many feature classes."
+
+__version__ = "$Revision: 394 $"
 
 try:
     import mm_cfg
diff --git a/modules/mm_admin.py b/modules/mm_admin.py
index d646e2c9e..61a0473fa 100644
--- a/modules/mm_admin.py
+++ b/modules/mm_admin.py
@@ -1,3 +1,7 @@
+"""Mixin class which handles of administrative requests."""
+
+__version__ = "$Revision: 394 $"
+
 # When an operation can't be completed, and is sent to the list admin for
 # Handling, we consider that an error condition, and raise MMNeedApproval
 
diff --git a/modules/mm_archive.py b/modules/mm_archive.py
index 038501a82..0b7113fcf 100644
--- a/modules/mm_archive.py
+++ b/modules/mm_archive.py
@@ -1,3 +1,11 @@
+"""Mixin class for putting new messages in the right place for archival.
+
+Public archives are separated from private ones.  An external archival
+mechanism (eg, pipermail) should be pointed to the right places, to do the
+archival."""
+
+__version__ = "$Revision: 394 $"
+
 import sys, os, string
 import mm_utils, mm_mbox, mm_cfg, mm_message
 
diff --git a/modules/mm_bouncer.py b/modules/mm_bouncer.py
index 4e1984a63..7d2bbfc36 100644
--- a/modules/mm_bouncer.py
+++ b/modules/mm_bouncer.py
@@ -1,3 +1,7 @@
+"Handle delivery bounce messages, doing filtering when list is set for it."
+
+__version__ = "$Revision: 394 $"
+
 # It's possible to get the mail-list senders address (list-admin) in the
 # bounce list.   You probably don't want to have list mail sent to that
 # address anyway.
diff --git a/modules/mm_deliver.py b/modules/mm_deliver.py
index 2f8eda012..8d9f68a4c 100644
--- a/modules/mm_deliver.py
+++ b/modules/mm_deliver.py
@@ -1,3 +1,8 @@
+"""Mixin class with message delivery routines."""
+
+__version__ = "$Revision: 394 $"
+
+
 import string, os, sys, tempfile
 import mm_cfg, mm_message, mm_err, mm_utils
 
diff --git a/modules/mm_digest.py b/modules/mm_digest.py
index e76bb582c..8ed9fb2e7 100644
--- a/modules/mm_digest.py
+++ b/modules/mm_digest.py
@@ -1,3 +1,7 @@
+"""Mixin class with list-digest handling methods and settings."""
+
+__version__ = "$Revision: 394 $"
+
 import mm_utils, mm_err, mm_message, mm_cfg
 import time, os, string