On 2016-03-13 18:33:19 +0100, Michael Meskes wrote:
> > > > The synopsis in a man page is not meant to list all options.
> > > Written down somewhere, or just your opinion?
> > From what I can see on other man pages (e.g., find, cp, mkdir).
>
> Na, not at all. All of these make it explicitly clear that they do not
> list all options, or better, just list the meta word OPTION. Quite a
> different situation, is it not?
Not the find(1) man page. For the cp(1) and mkdir(1) man pages,
the issue is not the options, but the arguments. For instance,
"cp --version" does not match any synopsis line.
> > I'll try, but there was a severe regression according to some
> > other bug.
>
> Depends on how you define "severe" I guess, but anyway, fixed since
> yesterday.
Now, with the current version bsdmainutils 9.0.8, the synopsis is:
cal [-31jy] [-A number] [-B number] [-d yyyy-mm] [[month] year]
cal [-31j] [-A number] [-B number] [-d yyyy-mm] -m month [year]
ncal [-C31bhjJpwySM] [-A number] [-B number] [-H yyyy-mm-dd] [-d yyyy-mm]
[-s country_code] [[month] year]
ncal [-C31bhJeoSM] [-A number] [-B number] [-d yyyy-mm] [year]
I see that there have been various fixes, but the DESCRIPTION section
says:
-N Switch to ncal mode.
while this option is no longer listed anywhere in the synopsis. It
seems that it has been removed, so that it should be removed from
the DESCRIPTION section.
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}.
Moreover, "cal -C" doesn't fail (which is consistent with the Usage
message) but the -C option is not listed in the cal lines.
--
Vincent Lefèvre <[email protected]> - 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)
