radosgw-admin: mildly confusing man page and usage message

[Florian Haas <florian@hastexo.com>]

Hi,

just noticed that radosgw-admin comes with a bit of confusing content in
its man page and usage message:

EXAMPLES
       Generate a new user:

       $ radosgw-admin user gen --display-name="johnny rotten"
--email=johnny@rotten.com

As far as I remember "user gen" is gone, and it's now "user create".
However:

radosgw-admin user create --display-name="test" --email=test@demo
user_id was not specified, aborting

... is followed by a usage message that doesn't mention user_id anywhere
(the option string is --uid). So conceivably the example could also use
a mention of --uid.

Also, is there a way to retrieve the "next available" user_id or just
tell radosgw-admin to use max(user_id)+1?

If one of the Ceph guys could provide a quick comment on this, I can
send a patch to the man page RST. Thanks.

Cheers,
Florian