X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=README.txt;h=808be60a4a0ecd75868012bfa756ac55fb0f51de;hb=b02a4830aa756d66176b909cdd04a91ac04d031d;hp=a15d3f9e2622040c7038054e9c623f6194333b99;hpb=b998daa9fb3c2af443c78bc2310ac1f2c5f50ac8;p=roundup.git diff --git a/README.txt b/README.txt index a15d3f9..808be60 100644 --- a/README.txt +++ b/README.txt @@ -1,9 +1,20 @@ - Roundup - ======= +Installation +============ +For installation instructions, please see installation.txt in the "doc" +directory. -1. License -========== +Upgrading +========= +For upgrading instructions, please see upgrading.txt in the "doc" directory. + +Usage and Other Information +=========================== +See the index.txt file in the "doc" directory. + + +License +======= Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/) This module is free software, and you may redistribute it and/or modify @@ -12,8 +23,8 @@ disclaimer are retained in their original form. IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING -OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE -POSSIBILITY OF SUCH DAMAGE. +OUT OF THE USE OF THIS CODE, EVEN IF BIZAR SOFTWARE PTY LTD HAS BEEN ADVISED +OF THE POSSIBILITY OF SUCH DAMAGE. BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS @@ -22,100 +33,21 @@ BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. -The stylesheet included with this package has been copied from the Zope -management interface and presumably belongs to Digital Creations. - - -2. Installation -=============== -For installation notes, please see the file INSTALL.TXT - - -3. Usage -======== -The system is designed to accessed through the command-line, e-mail or web -interface. Roundup has some useful doucmentation in its docstrings, so -"pydoc roundup" will give useful information. - -3.1 Command-line ----------------- -The command-line tool is called "roundup-admin" and is used for most low-level -database manipulations such as: - . creating a database instance - . redefining the list of products ("create" and "retire" commands) - . adding users manually, or setting their passwords ("create" and "set") - . other stuff - run it with no arguments to get a better description of - what it does. - - -3.2 E-mail ----------- -See the docstring at the start of the roundup/mailgw.py source file. -Use "pydoc roundup.mailgw". - - -3.3 Web -------- -Hopefully, this interface is pretty self-explanatory... - -Index views may be modified by the following arguments: - :sort - sort by prop name, optionally preceeded with '-' - to give descending or nothing for ascending sorting. - :group - group by prop name, optionally preceeded with '-' or - to sort in descending or nothing for ascending order. - :filter - selects which props should be displayed in the filter - section. Default is all. - :columns - selects the columns that should be displayed. - Default is all. - propname - selects the values the node properties given by propname - must have (very basic search/filter). - +PageTemplates Licensing +----------------------- +Portions of this code (roundup.cgi.PageTemplates, roundup.cgi.TAL and +roundup.cgi.ZTUtils) have been copied from Zope. They have been modified in +the following manner: -3. Design -========= -See the information in the "doc" directory. - - - -4. TODO -======= -Most of the TODO items are captured in comments in the code. In summary: - -in general: - . more unit tests - . more back-ends - . better error handling (nicer messages for users) -hyperdb: - . transaction support - . more efficient reverse lookups -roundupdb: - . split the file storage into multiple dirs? -roundup-mailgw: - . errors as attachments -roundup-server: - . check the source file timestamps before reloading -cgi_client - . keep form fields in form on bad submission - only clear it if all ok - - -5. Known Bugs -============= - -date: - . date subtraction doesn't work correctly "if the dates cross leap years, - phases of the moon, ..." - - -6. Author -========= -richard@users.sourceforge.net - - -7. Thanks -========= -Well, Ping, of course ;) +- removal of unit tests, Zope-specific code and support files from + PageTemplates: PageTemplateFile.py, ZPythonExpr.py, ZRPythonExpr.py, + ZopePageTemplate.py, examples, help, tests, CHANGES.txt, HISTORY.txt, + version.txt and www. From TAL: DummyEngine.py, HISTORY.txt, CHANGES.txt, + benchmark, driver.py, markbench.py, ndiff.py, runtest.py, setpath.py, + tests and timer.py. From ZTUtils: SimpleTree.py, Zope.py, CHANGES.txt and + HISTORY.txt. +- editing to remove dependencies on Zope modules (see files for change notes) -Anthony Baxter, for some good first-release feedback. And then continuing -support through development on sourceforge. +The license for this code is in doc/ZPL.txt.