Added module docstrings to all modules.

git-svn-id: http://svn.roundup-tracker.org/svnroot/roundup/trunk@418 57a73879-2fb5-44c3-a270-3262357dd7e2

diff --git a/roundup/cgi_client.py b/roundup/cgi_client.py
index 4875f95edb0370967d548bfacf2504a86b19b24c..437989637653b1c82b4a0d95fd935c666f561168 100644 (file)
--- a/roundup/cgi_client.py
+++ b/roundup/cgi_client.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: cgi_client.py,v 1.60 2001-11-21 22:57:28 jhermann Exp $
+# $Id: cgi_client.py,v 1.61 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+WWW request handler (also used in the stand-alone server).
+"""
 
 import os, cgi, pprint, StringIO, urlparse, re, traceback, mimetypes
 import binascii, Cookie, time
@@ -978,6 +982,10 @@ def parsePropsFromForm(db, cl, form, nodeid=0):
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.60  2001/11/21 22:57:28  jhermann
+# Added dummy hooks for I18N and some preliminary (test) markup of
+# translatable messages
+#
 # Revision 1.59  2001/11/21 03:21:13  richard
 # oops
 #

diff --git a/roundup/cgitb.py b/roundup/cgitb.py
index 9c9d0ed0ea9c3ead17ca83121997c1418d967c33..cc9217b77912ea62406a87b1b78be2fc1f1a4af7 100644 (file)
--- a/roundup/cgitb.py
+++ b/roundup/cgitb.py
@@ -1,7 +1,11 @@
 #
 # This module was written by Ka-Ping Yee, <ping@lfw.org>.
 # 
-# $Id: cgitb.py,v 1.6 2001-09-29 13:27:00 richard Exp $
+# $Id: cgitb.py,v 1.7 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Extended CGI traceback handler by Ka-Ping Yee, <ping@lfw.org>.
+"""
 
 import sys, os, types, string, keyword, linecache, tokenize, inspect, pydoc
 
@@ -118,6 +122,10 @@ def handler():
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.6  2001/09/29 13:27:00  richard
+# CGI interfaces now spit up a top-level index of all the instances they can
+# serve.
+#
 # Revision 1.5  2001/08/07 00:24:42  richard
 # stupid typo
 #

diff --git a/roundup/date.py b/roundup/date.py
index ef65d87f86fb7c1c099777fc8910f11f13094d26..8382ec3fd162c78d01189080c9c0489895b596a5 100644 (file)
--- a/roundup/date.py
+++ b/roundup/date.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: date.py,v 1.13 2001-09-18 22:58:37 richard Exp $
+# $Id: date.py,v 1.14 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Date, time and time interval handling.
+"""
 
 import time, re, calendar
 
@@ -379,6 +383,10 @@ if __name__ == '__main__':
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.13  2001/09/18 22:58:37  richard
+#
+# Added some more help to roundu-admin
+#
 # Revision 1.12  2001/08/17 03:08:11  richard
 # fixed prettification of intervals of 1 week
 #

diff --git a/roundup/htmltemplate.py b/roundup/htmltemplate.py
index 9afbd099ae3db685bd46f99b2cf880e5bdb2a5b4..040b9a8a2c70ae183bd09a5dcdbb11daf7192590 100644 (file)
--- a/roundup/htmltemplate.py
+++ b/roundup/htmltemplate.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: htmltemplate.py,v 1.44 2001-11-21 23:35:45 jhermann Exp $
+# $Id: htmltemplate.py,v 1.45 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Template engine.
+"""
 
 import os, re, StringIO, urllib, cgi, errno
 
@@ -861,6 +865,9 @@ class NewItemTemplate(TemplateFunctions):
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.44  2001/11/21 23:35:45  jhermann
+# Added globbing for win32, and sample marking in a 2nd file to test it
+#
 # Revision 1.43  2001/11/21 04:04:43  richard
 # *sigh* more missing value handling
 #

diff --git a/roundup/hyperdb.py b/roundup/hyperdb.py
index f19ed358d2475a96e853e1f9d5878a779f9db558..515ec99327c1867d555900bdb20134eea5c14b66 100644 (file)
--- a/roundup/hyperdb.py
+++ b/roundup/hyperdb.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: hyperdb.py,v 1.34 2001-11-21 04:04:43 richard Exp $
+# $Id: hyperdb.py,v 1.35 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Hyperdatabase implementation, especially field types.
+"""
 
 # standard python modules
 import cPickle, re, string
@@ -860,6 +864,9 @@ def Choice(name, *options):
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.34  2001/11/21 04:04:43  richard
+# *sigh* more missing value handling
+#
 # Revision 1.33  2001/11/21 03:40:54  richard
 # more new property handling
 #

diff --git a/roundup/i18n.py b/roundup/i18n.py
index 81edf78477a6d08366bbc3c6f4d75e9f242f5fc2..ce69252ab7507a4734fdf00021346fd847c71445 100644 (file)
--- a/roundup/i18n.py
+++ b/roundup/i18n.py
@@ -15,9 +15,9 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: i18n.py,v 1.1 2001-11-21 22:57:29 jhermann Exp $
+# $Id: i18n.py,v 1.2 2001-11-22 15:46:42 jhermann Exp $
 
-"""
+__doc__ = """
 RoundUp Internationalization (I18N)
 
 To use this module, the following code should be used:

diff --git a/roundup/init.py b/roundup/init.py
index 7bf27e35227ab58f2bcd52719b00356f47c66b76..efc571292cb1b45db624c2c70dcdda220cc2fe5b 100644 (file)
--- a/roundup/init.py
+++ b/roundup/init.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: init.py,v 1.17 2001-11-12 23:17:38 jhermann Exp $
+# $Id: init.py,v 1.18 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Init (create) a roundup instance.
+"""
 
 import os, sys, errno
 
@@ -104,6 +108,9 @@ from roundup.backends.back_%s import Database'''%backend
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.17  2001/11/12 23:17:38  jhermann
+# Code using copyDigestedFile() that passes unit tests
+#
 # Revision 1.16  2001/10/09 07:25:59  richard
 # Added the Password property type. See "pydoc roundup.password" for
 # implementation details. Have updated some of the documentation too.

diff --git a/roundup/install_util.py b/roundup/install_util.py
index ca57d61c1a7057d1f40ad7adf8e1c7db24f4184c..8bea4cf76d5f866c71d362aa301f054301deb73d 100644 (file)
--- a/roundup/install_util.py
+++ b/roundup/install_util.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: install_util.py,v 1.5 2001-11-12 23:17:38 jhermann Exp $
+# $Id: install_util.py,v 1.6 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Support module to generate and check fingerprints of installed files.
+"""
 
 import os, sha, shutil
 
@@ -145,6 +149,9 @@ if __name__ == '__main__':
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.5  2001/11/12 23:17:38  jhermann
+# Code using copyDigestedFile() that passes unit tests
+#
 # Revision 1.4  2001/11/12 23:14:40  jhermann
 # Copy function, and proper handling of unknown file types
 #

diff --git a/roundup/instance.py b/roundup/instance.py
index 59c56fb50522909ace0cad904b53d9985ff73d1f..f2a9eaf5f1d633f68686258e705d665cd11891f5 100644 (file)
--- a/roundup/instance.py
+++ b/roundup/instance.py
@@ -15,9 +15,12 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: instance.py,v 1.4 2001-11-12 22:01:06 richard Exp $
+# $Id: instance.py,v 1.5 2001-11-22 15:46:42 jhermann Exp $
 
-''' Currently this module provides one function: open. This function opens
+__doc__ = '''
+Instance handling (open instance).
+
+Currently this module provides one function: open. This function opens
 an instance.
 '''
 
@@ -52,6 +55,9 @@ del opener
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.4  2001/11/12 22:01:06  richard
+# Fixed issues with nosy reaction and author copies.
+#
 # Revision 1.3  2001/08/07 00:24:42  richard
 # stupid typo
 #

diff --git a/roundup/mailgw.py b/roundup/mailgw.py
index e0b3ce5540d20eaeec5714e259f4a48a15cf261e..6274173e836511b409bb31f111892c3badbfad26 100644 (file)
--- a/roundup/mailgw.py
+++ b/roundup/mailgw.py
@@ -14,8 +14,9 @@
 # FOR A PARTICULAR PURPOSE.  THE CODE PROVIDED HEREUNDER IS ON AN "AS IS"
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
-# 
-'''
+#
+
+__doc__ = '''
 An e-mail gateway for Roundup.
 
 Incoming messages are examined for multiple parts:
@@ -72,7 +73,7 @@ are calling the create() method to create a new node). If an auditor raises
 an exception, the original message is bounced back to the sender with the
 explanatory message given in the exception. 
 
-$Id: mailgw.py,v 1.34 2001-11-15 10:24:27 richard Exp $
+$Id: mailgw.py,v 1.35 2001-11-22 15:46:42 jhermann Exp $
 '''
 
 
@@ -521,6 +522,9 @@ def parseContent(content, blank_line=re.compile(r'[\r\n]+\s*[\r\n]+'),
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.34  2001/11/15 10:24:27  richard
+# handle the case where there is no file attached
+#
 # Revision 1.33  2001/11/13 21:44:44  richard
 #  . re-open the database as the author in mail handling
 #

diff --git a/roundup/password.py b/roundup/password.py
index 9ae02c6c6492f49f95fae13c995934fcf679561f..28c68a1382622a907404a1d2466895a3e970edfc 100644 (file)
--- a/roundup/password.py
+++ b/roundup/password.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: password.py,v 1.3 2001-10-20 11:58:48 richard Exp $
+# $Id: password.py,v 1.4 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Password handling (encoding, decoding).
+"""
 
 import sha, re
 
@@ -113,6 +117,10 @@ if __name__ == '__main__':
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.3  2001/10/20 11:58:48  richard
+# Catch errors in login - no username or password supplied.
+# Fixed editing of password (Password property type) thanks Roch'e Compaan.
+#
 # Revision 1.2  2001/10/09 23:58:10  richard
 # Moved the data stringification up into the hyperdb.Class class' get, set
 # and create methods. This means that the data is also stringified for the

diff --git a/roundup/roundupdb.py b/roundup/roundupdb.py
index f6228d9744f63d7bb559b9fc44a8e676d7f93ae7..8f33f1e6da6e29f3fda1ae8100cd2988867eca6e 100644 (file)
--- a/roundup/roundupdb.py
+++ b/roundup/roundupdb.py
@@ -15,7 +15,11 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: roundupdb.py,v 1.18 2001-11-15 10:36:17 richard Exp $
+# $Id: roundupdb.py,v 1.19 2001-11-22 15:46:42 jhermann Exp $
+
+__doc__ = """
+Extending hyperdb with types specific to issue-tracking.
+"""
 
 import re, os, smtplib, socket
 import mimetools, MimeWriter, cStringIO
@@ -389,6 +393,10 @@ Roundup issue tracker
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.18  2001/11/15 10:36:17  richard
+#  . incorporated patch from Roch'e Compaan implementing attachments in nosy
+#     e-mail
+#
 # Revision 1.17  2001/11/12 22:01:06  richard
 # Fixed issues with nosy reaction and author copies.
 #

diff --git a/roundup/templatebuilder.py b/roundup/templatebuilder.py
index cbbd0bf8a98da3168990a1c96b808e1c51d0c422..358cfdc34a25c4a5f5981f4f836520d4260a64e5 100644 (file)
--- a/roundup/templatebuilder.py
+++ b/roundup/templatebuilder.py
@@ -15,9 +15,13 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: templatebuilder.py,v 1.12 2001-11-14 21:35:21 richard Exp $
+# $Id: templatebuilder.py,v 1.13 2001-11-22 15:46:42 jhermann Exp $
 import errno, re
 
+__doc__ = """
+Collect template parts and create instance template files.
+"""
+
 preamble = """ 
 # Do Not Edit (Unless You Want To)
 # This file automagically generated by roundup.htmldata.makeHtmlBase
@@ -85,6 +89,9 @@ if __name__ == "__main__":
 
 #
 # $Log: not supported by cvs2svn $
+# Revision 1.12  2001/11/14 21:35:21  richard
+#  . users may attach files to issues (and support in ext) through the web now
+#
 # Revision 1.11  2001/08/07 00:24:42  richard
 # stupid typo
 #