On Sat, Mar 12, 2016 at 11:52:57AM +0100, Vincent Lefevre wrote:
> Control: reopen -1
> Control: retitle -1 bsdmainutils: incomplete cal(1) man page

Seriously? I don't really like bts ping pong.

> The synopsis in a man page is not meant to list all options.

Written down somewhere, or just your opinion? Isn't the synopsis meant to show
how the options are listed etc.?

> Sometimes, only the main options are listed. Actually this is even

Can you back your claim with an example? 

> the case here. For instance:

Not exactly, your example is a bug that was since fixed.

> Moreover, contrary to what the synopsis and Usage output say,
> "ncal -ej" is invalid. But it doesn't return any error.

This statement I do not understand at all. Please elaborate.

> Even if the synopsis is completed, the description should say that
> not all options apply to cal and one should refer to the synopsis
> (if completed).

Why? Again, it's already in there so why put it down again? Can you show me
other manpages that do exactly as you say?

> Also, the synopsis is not very clear. For instance:
> ...

Before we continue, please update to the latest version which does has some
fixed to both these points.

There may be more in there and I'm more than willing to fix bugs, but the one
this bug report is about is none. 

Michael
-- 
Michael Meskes
Michael at Fam-Meskes dot De, Michael at Meskes dot (De|Com|Net|Org)
Meskes at (Debian|Postgresql) dot Org
Jabber: michael at xmpp dot meskes dot org
VfL Borussia! Força Barça! Go SF 49ers! Use Debian GNU/Linux, PostgreSQL

Reply via email to