On Wed, Nov 24, 2010 at 11:10:15PM +0100, Francesco Cosoleto wrote:
> Usage text old version:
>
> Usage:
> renice [-n] priority [-p|--pid] pid [... pid]
> renice [-n] priority -g|--pgrp pgrp [... pgrp]
> renice [-n] priority -u|--user user [... user]
> renice -h | --help
> renice -v | --version
>
> Usage text new version:
> Usage: renice [-n] priority [[-p] pid ...] [-g pgrp ...] [-u user ...]
Not sure if this usage text is better. The command line format is
-p *or* -g *or* -u.
From my point of view is better to have a separate description for all
basic modes. My suggestion is to remove the long options from the usage
text only, for example:
renice [-n] <priority> [-p] <pid> [<pid> ...]
renice [-n] <priority> -g <pgrp> [<pgrp> ...]
renice [-n] <priority> -u <user> [<user> ...]
We use this concept for many utils and IMHO is it more readable that
write all to the one line.
Karel
--
Karel Zak <kzak@xxxxxxxxxx>
http://karelzak.blogspot.com
--
To unsubscribe from this list: send the line "unsubscribe util-linux-ng" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
