2009/8/2 Helmut Hullen <[email protected]>

> 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/
_______________________________________________
Nut-upsdev mailing list
[email protected]
http://lists.alioth.debian.org/mailman/listinfo/nut-upsdev

Reply via email to