Code

issue2550678: Allow pagesize=-1 which returns all results.
[roundup.git] / README.txt
index 808be60a4a0ecd75868012bfa756ac55fb0f51de..b6cf8c6391e33772943d7c7405cefaef2f8b78ac 100644 (file)
@@ -1,53 +1,46 @@
+=======================================================
+Roundup: an Issue-Tracking System for Knowledge Workers
+=======================================================
+
+Copyright (c) 2003-2009 Richard Jones (richard@mechanicalcat.net)
+Copyright (c) 2002 eKit.com Inc (http://www.ekit.com/)
+Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/)
+
+
+INSTANT GRATIFICATION
+=====================
+
+The impatient may try Roundup immediately by typing at the console::
+
+   python demo.py
+
+To start anew (a fresh demo instance)::
+
+   python demo.py nuke
+
+Run demo.py from the *source* directory; don't try to run demo.py from
+the *installed* directory, it will *break*.
+
 
 Installation
 ============
 For installation instructions, please see installation.txt in the "doc"
 directory.
 
+
 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.
+The *.txt files in the "doc" directory are written in reStructedText. If
+you have rst2html installed (part of the docutils suite) you can convert
+these to HTML by running "make html" 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
-under the same terms as Python, so long as this copyright message and
-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 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
-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.
-
-
-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:
-
-- 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)
-
-The license for this code is in doc/ZPL.txt.
-
+See COPYING.txt