[Nut-upsdev] program "nutupsdrv"

[Arnaud Quette]

2009/8/2 Helmut Hullen <Hullen at t-online.de>

> Hallo, Arnaud,
>

Hi Again Helmut,


>
> Du meintest am 02.08.09 zum Thema Re: program "nutupsdrv":
>
> >> the man page "nutupdsdrv.8" does exist, it refers to a program
> >> "nutupsdrv". But there is no such program - is there an error in the
> >> man page?
>
> > this man page doesn't refer to such program.
> > read the first lines of the manual, the answer is there!
>
> There I find
>
>        nutupsdrv -h
>        nutupsdrv [OPTIONS]
>
> and that looks like a program. You should change these lines, please.
>

hum, right. I actually realised that.

the point is that there should be for conformance behind that (program name
=> manpage name => Synopsis...)

I've got to make a deeper check, but the only acceptable solution would be
to add:
- a note a the end of the synopsis, like: "Note: replace "nutupsdrv" by an
actual driver name". But I'm not sure we can do such a thing in the
Synopsis.
- one more line in the Description:
For information on the specific drivers, see their individual man pages.
+From the above Synopsis, replace "nutupsdrv" by an actual driver name

Do you think that this would disambiguate the situation?

Do others have any comment?

cheers,
Arnaud
-- 
Linux / Unix Expert R&D - Eaton - http://www.eaton.com/mgeops
Network UPS Tools (NUT) Project Leader - http://www.networkupstools.org/
Debian Developer - http://www.debian.org
Free Software Developer - http://arnaud.quette.free.fr/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alioth.debian.org/pipermail/nut-upsdev/attachments/20090802/7a2dff7f/attachment.htm>