info for installing the CSV module

Author: Richard Jones

doc/customizing.txt

@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.117 $
+:Version: $Revision: 1.118 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -2923,18 +2923,17 @@ vacation". Not very useful, and relatively easy to stop.
    consists of::
 
     def nosyreaction(db, cl, nodeid, oldvalues):
+        users = db.user
+        messages = db.msg
         # send a copy of all new messages to the nosy list
         for msgid in determineNewMessages(cl, nodeid, oldvalues):
             try:
-                users = db.user
-                messages = db.msg
-
                 # figure the recipient ids
                 sendto = []
-                r = {}
+                seen_message = {}
                 recipients = messages.get(msgid, 'recipients')
                 for recipid in messages.get(msgid, 'recipients'):
-                    r[recipid] = 1
+                    seen_message[recipid] = 1
 
                 # figure the author's id, and indicate they've received
                 # the message
@@ -2945,7 +2944,7 @@ vacation". Not very useful, and relatively easy to stop.
                 if (db.config.MESSAGES_TO_AUTHOR == 'yes' and
                         users.get(authid, 'username') != 'anonymous'):
                     sendto.append(authid)
-                r[authid] = 1
+                seen_message[authid] = 1
 
                 # now figure the nosy people who weren't recipients
                 nosy = cl.get(nodeid, 'nosy')
@@ -2956,7 +2955,7 @@ vacation". Not very useful, and relatively easy to stop.
                     if users.get(nosyid, 'username') == 'anonymous':
                         continue
                     # make sure they haven't seen the message already
-                    if not r.has_key(nosyid):
+                    if not seen_message.has_key(nosyid):
                         # send it to them
                         sendto.append(nosyid)
                         recipients.append(nosyid)

doc/installation.txt

@@ -2,7 +2,7 @@
 Installing Roundup
 ==================
 
-:Version: $Revision: 1.68 $
+:Version: $Revision: 1.69 $
 
 .. contents::
 
@@ -44,6 +44,38 @@ distribution (at http://www.activestate.com/Products/ActivePython/), or you'll
 have to install the win32all package separately (get it from
 http://starship.python.net/crew/mhammond/win32/).
 
+Non-Python2.3 users may need to `install the "CSV" module`_.
+
+Install the "CSV" module
+------------------------
+
+Note: CSV stands for Comma-Separated-Value. These files are used by all
+      manner of programs (eg. spreadsheets) to exchange data.
+
+The "CSV" module is required if you wish to import or export data in the
+tracker, or if you wish to use the online generic class editing facility.
+
+If you're using a version of Python older than 2.3, then you will need to
+install the "CSV" module from `Object Craft`_. Users of Python2.3 and later
+don't need to. If you have a C compiler installed, then download the source
+and follow their installation instructions (simply ``python setup.py
+install``.)
+
+If you're on Windows and don't have a C compiler, then you'll need to
+download the pre-compiled ``csv.pyd`` file and install it. To install, just
+copy it to your Python installation in the ``lib\site-packages`` directory.
+For Python 2.2, this would be::
+
+   c:\python22\lib\site-packages
+
+Once the CSV module is installed, you *must* restart roundup-server if it
+is already running, or the new module won't be detected.
+
+If you're on some other platform and don't have a C compiler, you'll need
+to ask for help on the roundup-users mailing list.
+
+.. _`Object Craft`: http://object-craft.com.au/
+
 
 Getting Roundup
 ===============
@@ -443,6 +475,7 @@ Korean encodings the you'll need to obtain CJKCodecs from
 http://cjkpython.berlios.de/
 
 
+
 Maintenance
 ===========