RE: Customised control help

[Charlie Brady <charlieb-supervision@budge.apana.org.au>]

On Wed, 2 Jan 2008, rehan khan wrote:

>>> 4) Is there a more detailed description of customised control somewhere?
>>
>> I think the man page of runsv is complete and accurate. What do you think
>> is missing? The source code might help you if you wish to learn more or to
>> confirm what you read in the man page.
>
> Heh, some of my questions might seem dumb but I have read ALL the docs many
> times over. I have found the documentation to be 100% complete. However
> sometimes it can be difficult to interpret for all situations (or the particular
> situation that is in my head :). For example in the above documentation example
> it might be better to say that the examples given are special cases or that they
> are examples that apply to all the options.

I think it reads clearly that 'o', 'd' and 'x' are special cases, and that 
'for each' really does mean 'for each', but YMMV.

> Perhaps also to expand on the description ...

How would the description be expanded if it is already complete?

> and to describe the exit codes 
> (even if it is repeated from elsewhere).

The exit codes of runsv are clearly stated. The interpretation of zero 
exit status from custom control scripts also seems clearly stated to me.

  "If the program exits with return code 0, runsv refrains from sending the
   service the corresponding signal."

What would you express differently?