rascontrol help needs to be improved

[Dimitar Misev]

Try help define in rascontrol for example, it prints

define user 'username' [-passwd 'password'] [-rights 'rightsstring']
       - define user account with symbolic name 'username'
         'password' defaults to 'username' (use the raspasswd utility to change)
         -rights 'rightsstring': the rights granted to the user 
                                 (default: none; see documentation for valid rights)

The problem is that the arguments are listed in single quotes. It's easy to assume that one needs to specify the username/password/rightsstring in single quotes, which is wrong.

The way you define a new user is

define user myuser -passwd mypassword -rights RW

NOT

define user 'myuser' -passwd 'mypassword' -rights 'RW'

So I suggest to change the help text to

define user USERNAME [-passwd PASSWORD] [-rights RIGHTSSTRING]
       - define user account with symbolic name USERNAME;
         PASSWORD defaults to USERNAME if -passwd is not specified;
         RIGHTSSTRING is the rights granted to the user 
           (default: none; see documentation for valid rights)

I.e. use capital case for the arguments instead of putting them in single quotes. Capital case is pretty standard practice, e.g. check ls --help.

Note that this applies to all help text, not just define user.