README.txt

   1                                     Roundup
   2                                     =======
   3
   4
   5 1. License
   6 ==========
   7 This software is released under the GNU GPL. The copyright is held by Bizar
   8 Software Pty Ltd (http://www.bizarsoftware.com.au).
   9
  10 The stylesheet included with this package has been copied from the Zope
  11 management interface and presumably belongs to Digital Creations.
  12
  13
  14 2. Installation
  15 ===============
  16 For installation notes, please see the file INSTALL.TXT
  17
  18
  19 3. Usage
  20 ========
  21 The system is designed to accessed through the command-line, e-mail or web
  22 interface.
  23
  24 3.1 Command-line
  25 ----------------
  26 The command-line tool is called "roundup-admin" and is used for most low-level
  27 database manipulations such as:
  28  . creating a database instance
  29  . redefining the list of products ("create" and "retire" commands)
  30  . adding users manually, or setting their passwords ("create" and "set")
  31  . other stuff - run it with no arguments to get a better description of
  32    what it does.
  33
  34
  35 3.2 E-mail
  36 ----------
  37 See the docstring at the start of the roundup/mailgw.py source file.
  38
  39
  40 3.3 Web
  41 -------
  42 Hopefully, this interface is pretty self-explanatory...
  43
  44 Index views may be modified by the following arguments:
  45     :sort    - sort by prop name, optionally preceeded with '-'
  46              to give descending or nothing for ascending sorting.
  47     :group   - group by prop name, optionally preceeded with '-' or
  48              to sort in descending or nothing for ascending order.
  49     :filter  - selects which props should be displayed in the filter
  50              section. Default is all.
  51     :columns - selects the columns that should be displayed.
  52              Default is all.
  53     propname - selects the values the node properties given by propname
  54              must have (very basic search/filter).
  55
  56
  57
  58 3. Design
  59 =========
  60 See the information in the "doc" directory.
  61
  62
  63
  64 4. TODO
  65 =======
  66 Most of the TODO items are captured in comments in the code. In summary:
  67
  68 in general:
  69   . more unit tests
  70   . more back-ends
  71   . better error handling (nicer messages for users)
  72   . possibly revert the entire damn thing to 1.5.2 ... :(
  73 roundup.py:
  74   . getopt() for command line
  75 hyperdb:
  76   . transaction support
  77 roundupdb:
  78   . split the file storage into multiple files
  79 roundup-mailgw:
  80   . errors as attachments
  81   . snip signatures?
  82 roundup-server:
  83   . check the source file timestamps before reloading
  84 date:
  85   . blue Date.__sub__ needs food, badly
  86 cgi_client
  87   . searching
  88   . keep form fields in form on bad submission - only clear it if all ok
  89   . e-mail messages should have the roundup CGI URL in them
  90
  91
  92 5. Known Bugs
  93 =============
  94
  95 date:
  96   . date subtraction doesn't work correctly "if the dates cross leap years,
  97     phases of the moon, ..."
  98
  99 filter:
 100   . incorrectly embeds hidden fields for filters being displayed - and
 101     doesn't use the existing values for filters being displayed either.
 102
 103
 104 6. Author
 105 =========
 106 richard@sourceforge.net
 107
 108
 109 7. Thanks
 110 =========
 111 Well, Ping, of course ;)
 112
 113 Anthony Baxter, for some good first-release feedback. And then continuing
 114 support through development on sourceforge.
 115