Mercurial > p > roundup > code
diff doc/user_guide.txt @ 3696:790363e96852
Sorting/grouping by multiple properties.
- Implement sorting/grouping by multiple properties for the web
interface. I'm now using @sort0/@sortdir0,@sort1/@sortdir1,... and
@group0/@groupdir0,... when generating URLs from a search template.
These are converted to a list internally. When saving URLs (e.g. when
storing queries) I'm using @sort=prop1,prop2,... and @group=... with
optional '-' prepended to individual props.
This means saved URLs are backward compatible with existing trackers
(and yes, this was a design goal).
I need the clumsy version with @sort0,@sort1 etc, because I'm
currently using several selectors and checkboxes (as the classic
template does, too). I don't think there is a way around that in HTML?
- Updated (hopefully all) documentation to reflect the new URL format
and the consequences in the web-interface.
- I've set the number of sort/group properties in the classic template
to two -- this can easily be reverted by changing n_sort to 1.
Richard, would you look over these changes? I've set a tag before and
(will set) after commit, so that it would be easy to merge out.
Don't be too scared about the size of the change, most is documentation,
the guts are in cgi/templating.py and small changes in the classic
template.
| author | Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net> |
|---|---|
| date | Wed, 30 Aug 2006 20:28:26 +0000 |
| parents | 77e067e64035 |
| children | 9f4dd27ae843 |
line wrap: on
line diff
--- a/doc/user_guide.txt Wed Aug 30 09:35:31 2006 +0000 +++ b/doc/user_guide.txt Wed Aug 30 20:28:26 2006 +0000 @@ -2,7 +2,7 @@ User Guide ========== -:Version: $Revision: 1.33 $ +:Version: $Revision: 1.34 $ .. contents:: @@ -338,9 +338,11 @@ Argument Description ============ ============================================================= @sort sort by prop name, optionally preceeded with '-' to give - descending or nothing for ascending sorting. + descending or nothing for ascending sorting. The sort + argument can have several props separated with comma. @group group by prop name, optionally preceeded with '-' or to sort - in descending or nothing for ascending order. + in descending or nothing for ascending order. The group + argument can have several props separated with comma. @columns selects the columns that should be displayed. Default is all. @filter indicates which properties are being used in filtering. @@ -356,7 +358,7 @@ /issue?status=unread,in-progress,resolved& topic=security,ui& - @group=priority& + @group=priority,-status& @sort=-activity& @filters=status,topic& @columns=title,status,fixer