On Thu, Nov 25, 2010 at 12:37:45AM +0100, Karel Zak wrote: > 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. I have used this my version. 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