On 2016-03-15 19:43:12 +0100, Michael Meskes wrote:
> On Sun, Mar 13, 2016 at 07:48:14PM +0100, Vincent Lefevre wrote:
> > According to the synopsis, "ncal -ej" is invalid because the option -e
> > is listed only in the second ncal line while the option -j is listed
> > only in the first ncal line. However, it doesn't fail:
> >
> > $ ncal -ej
> > March 27 2016
> >
> > Ditto with other combinations between {e,o} and {j,p,w,y}.
>
> Right, the synopsis here essentially shows which options make sense together.
> If you specify a combination that is not listed one will not have an effect.
It would be better to get an error in such a case.
Back to the man page, it seems that I'm not the only one to find
it confusing. I've just found that a few hours after reported this
bug, some other user thought that the -M option was valid for cal,
after looking at the man page:
https://lists.debian.org/debian-user-french/2016/03/msg00176.html
I think that the cause may be the fact that a same man page for two
different user commands is very unusual. Having two different man
pages (possibly generated from the same source) would be better, IMHO.
--
Vincent Lefèvre <vinc...@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)
