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>
