Re: chrt: inconsistency in --help

[Benno Schulenberg <bensberg@justemail.net>]

On Tue, Jun 9, 2015, at 11:24, Karel Zak wrote:
> On Tue, Jun 09, 2015 at 10:37:46AM +0200, Martin Steigerwald wrote:
> > Set policy:
> >   chrt [options] [-p] [<policy>] <priority> [<pid> | <command> [<arg>...]]
> 
>  Yes, I have modified --help output to this

Well, -p is just one of the possible options, so it could be simply
subsumed under [options].  Also, the brackets around "<pid> | <command>
[<arg>..." seem to say that both <pid> and <command> are optional,
but they are not when the <priority> is given.  Furthermore, <policy>
seems to suggest it is something like "WORD" or "name" or "12345",
but in fact it is a certain type of option, starting with a dash.
So I think the current synopsis is rather confusing.

The man page summarizes the command as follows:
    chrt [options] priority command [argument...]
    chrt [options] -p [priority] pid

The first line shows how to run a command with certain attributes,
the second how to query or modify the attributes of an existing process.
Quite clear.

So, to make usage synopsis clearer and correct I would suggest
rewriting it as:

Set policy:
    chrt [options] <priority> <command> [<arg>...]
    chrt [options] -p <priority> <pid>

The first of the upcoming two patches makes this change.

Benno

-- 
http://www.fastmail.com - Accessible with your email software
                          or over the web