I was trying some of the design document example
command 
lines for roundup-admin/roundup and the
find -list option and 
output formats don't work. So I
added the following options to 
roundup-admin to
make the functionality of the design doc 
examples
work.

  -S "string" - reports output in list format 
with "string"
                   separting the elements.

  -s - like -S " " i.e. 
space separated

  -d - print item designators so 
             roundup-
admin -d get messages issue1
        produces:
             msg1
        rather 
than:
             1

I support the -c argument and added the -s 
argument
since they are so useful for interacting with 
roundup
designators (they are comma separated) and the 
shell
(which parses on spaces).

The -S can be used for 
any string including newline and multi-charater 
strings.

The display command can now take multiple 
designators.

The list command now generates a list of 
the
(optional) specified property value or class id's if -S,
-s, or -
c is used. Before it used to report only the class
id. It also reports 
an error if more than one property is
specified.

Fixed the 
usage text.

I am also attaching at diff to the 
users_guide.txt
that I hope I got the text formatting right 
on
that rejuvinates command line examples in the
design 
guide.

The users_guide examples require 
the
admin.py patch.