fix filter() doc

Author: Richard Jones

doc/Makefile

@@ -1,11 +1,11 @@
 STXTOHTML = rst2html
 STXTOHT = rst2ht.py
-WEBDIR = ../../htdocs/htdocs/doc-0.7
+WEBDIR = ../../htdocs/htdocs/doc-0.8
 
 SOURCE = announcement.txt customizing.txt developers.txt FAQ.txt features.txt \
     glossary.txt implementation.txt index.txt design.txt mysql.txt \
     installation.txt upgrading.txt user_guide.txt admin_guide.txt \
-	postgresql.txt tracker_templates.txt whatsnew-0.7.txt
+	postgresql.txt tracker_templates.txt whatsnew-0.8.txt
 
 COMPILED := $(SOURCE:.txt=.html)
 WEBHT := $(SOURCE:.txt=.ht)

doc/announcement.txt

@@ -1,24 +1,12 @@
-I'm proud to release this 7th major feature release of Roundup.
+I'm proud to release this 8th major feature release of Roundup.
 
-Version 0.7 introduces far too many features to list here so I've put
+Version 0.8 introduces far too many features to list here so I've put
 together a What's New page:
 
-  http://roundup.sourceforge.net/doc-0.7/whatsnew-0.7.html
+  http://roundup.sourceforge.net/doc-0.8/whatsnew-0.8.html
 
 Some highlights:
 
-- added postgresql backend
-- trackers using postgresql or mysql backends may have many users
-- new "actor" automatic property (user who caused the last "activity")
-- RDBMS backends have data typed columns and indexes on several columns
-- registration may be concluded by replying to the confirmation email
-- HTML templating permission checks are greatly simplified
-- database exports now include full journals
-- IMAP support in the mail gateway
-
-Known issues:
-
-- the metakit import feature currently has a bug and should not be used
 
 If you're upgrading from an older version of Roundup you *must* follow
 the "Software Upgrade" guidelines given in the maintenance documentation.

doc/customizing.txt

@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.148 $
+:Version: $Revision: 1.149 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -1679,8 +1679,18 @@ properties  return a `hyperdb property wrapper`_ for all of this class's
 list        lists all of the active (not retired) items in the class.
 csv         return the items of this class as a chunk of CSV text.
 propnames   lists the names of the properties of this class.
-filter      lists of items from this class, filtered and sorted by the
-            current *request* filterspec/filter/sort/group args
+filter      lists of items from this class, filtered and sorted. Two
+            options are avaible for sorting:
+
+            1. by the current *request* filterspec/filter/sort/group args
+            2. by the "filterspec", "sort" and "group" keyword args.
+               "filterspec" is ``{propname: value(s)}``. "sort" and
+               "group" are ``(dir, prop)`` where dir is '+', '-' or None
+               and prop is a prop name or None.
+
+            eg. ``issue.filter(filterspec={"priority": "1"},
+            sort=('activity', '+'))``
+
 classhelp   display a link to a javascript popup containing this class'
             "help" template.
 submit      generate a submit button (and action hidden element)