annotate doc/roundup-demo.1 @ 3682:193f316dbbe9

More transitive-property support. - Implemented transitive properties in sort and group specs. Sort/group specs can now be lists of specs. - All regression tests except for one metakit backend test related to metakit having no representation of NULL pass - Fixed more PEP 8 whitespace peeves (and probably introduced some new ones :-) - Moved Proptree from support.py to hyperdb.py due to circular import - Moved some proptree-specific methods from Class to Proptree - Added a test for sorting by ids -> should be numeric sort (which now really works for all backends) - Added "required" attribute to all property classes in hyperdb (e.g., String, Link,...), see Feature Requests [SF#539081] -> factored common stuff to _Type. Note that I also converted to a new-style class when I was at it. Bad: The repr changes for new-style classes which made some SQL backends break (!) because the repr of Multilink is used in the schema storage. Fixed the repr to be independent of the class type. - Added get_required_props to Class. Todo: should also automagically make the key property required... - Add a sort_repr method to property classes. This defines the sort-order. Individual backends may use diffent routines if the outcome is the same. This one has a special case for id properties to make the sorting numeric. Using these methods isn't mandatory in backends as long as the sort-order is correct. - Multilink sorting takes orderprop into account. It used to sort by ids. You can restore the old behaviour by specifying id as the orderprop of the Multilink if you really need that. - If somebody specified a Link or Multilink as orderprop, we sort by labelprop of that class -- not transitively by orderprop. I've resited the tempation to implement recursive orderprop here: There could even be loops if several classes specify a Link or Multilink as the orderprop... - Fixed a bug in Metakit-Backend: When sorting by Links, the backend would do a natural join to the Link class. It would rename the "id" attribute before joining but *not* all the other attributes of the joined class. So in one test-case we had a name-clash with priority.name and status.name when sorting *and* grouping by these attributes. Depending on the order of joining this would produce a name-clash with broken sort-results (and broken display if the original class has an attribute that clashes). I'm now doing the sorting of Links in the generic filter method for the metakit backend. I've left the dead code in the metakit-backend since correctly implementing this in the backend will probably be more efficient. - updated doc/design.html with the new docstring of filter.
author Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
date Mon, 21 Aug 2006 12:19:48 +0000
parents 4992da7c96ae
children 5cd913b94e25
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2795
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
1 .TH ROUNDUP-SERVER 1 "27 July 2004"
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
2 .SH NAME
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
3 roundup-demo \- create a roundup "demo" tracker and launch its web interface
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
4 .SH SYNOPSIS
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
5 \fBroundup-demo\fP [\fIbackend\fP [\fBnuke\fP]]
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
6 .SH OPTIONS
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
7 .TP
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
8 \fBnuke\fP
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
9 Create a fresh demo tracker (deleting the existing one if any). If the
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
10 additional \fIbackend\fP argument is specified, the new demo tracker will
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
11 use the backend named (one of "anydbm", "sqlite", "metakit", "mysql" or
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
12 "postgresql"; subject to availability on your system).
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
13 .TH DESCRIPTION
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
14 This command creates a fresh demo tracker for you to experiment with. The
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
15 email features of Roundup will be turned off (so the nosy feature won't
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
16 send email). It does this by removing the \fInosyreaction.py\fP module
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
17 from the demo tracker's \fIdetectors\fP directory.
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
18
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
19 If you wish, you may modify the demo tracker by editing its configuration
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
20 files and HTML templates. See the \fIcustomisation\fP manual for
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
21 information about how to do that.
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
22
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
23 Once you've fiddled with the demo tracker, you may use it as a template for
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
24 creating your real, live tracker. Simply run the \fIroundup-admin\fP
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
25 command to install the tracker from inside the demo tracker home directory,
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
26 and it will be listed as an available template for installation. No data
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
27 will be copied over.
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
28 .SH AUTHOR
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
29 This manpage was written by Richard Jones
4992da7c96ae roundup-demo man page
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
30 <richard@users.sourceforge.net>.

Roundup Issue Tracker: http://roundup-tracker.org/