docs/184550: bc -q option not documented in man page

Ronald F. Guilmette rfg at tristatelogic.com
Sat Dec 7 08:16:26 UTC 2013


In message <20131207021835.GK20078 at glenbarber.us>, 
Glen Barber <gjb at FreeBSD.org> wrote:

>On Fri, Dec 06, 2013 at 09:12:30PM -0500, Eitan Adler wrote:
>> all options should be documented.  An undocumented option is a bug.
>> If we don't want people using it we should document as such.
>>
>
>It is documented.
>
>                case 'q':
>                        /* compatibility option */
>                        break;

Apparently, there are different interpretations of the word "documentation".

For my part, my own opinion is that if there is a desire not to confuse
people who still do rely on man pages, then perhaps it would be best to
exhibit some consistancy, and also remove mention of the -q option from
the SYNOPSIS section of the relevant man page.  (This would not be _my_
first choice, but at least it would be consistant.)


Regards,
rfg


More information about the freebsd-doc mailing list