usage stanza

[Petr Lautrbach]

Hello,

I would like to add to upstart new stanza called 'usage' with
following syntax:

usage <usage message>

It's intended to help administrator to better understand how to control
jobs which depends on various variables, e.g:

let's have tty job with exec stanza:

exec /sbin/mingetty $TTY


Now, if I try to start, stop or show status of this job I see:
# status tty
status: Unknown parameter: TTY

So I have to open /etc/init/tty.conf and check what does it mean.
With usage stanza like this:
usage 'tty TTY=/dev/ttyX  - where X is console id'

I will see:
# status tty
status: Unknown parameter: TTY
usage: tty TTY=/dev/ttyX  - where X is console id


There is attached patch which is functional proposal of this feature.

Thanks,

Petr
-- 
Petr Lautrbach, Red Hat, Inc.
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: upstart-usage.patch
URL: <https://lists.ubuntu.com/archives/upstart-devel/attachments/20111024/149b81f9/attachment.ksh>