Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 07 Dec 2013 00:16:21 -0800
From:      "Ronald F. Guilmette" <rfg@tristatelogic.com>
To:        Glen Barber <gjb@FreeBSD.org>
Cc:        freebsd-doc@freebsd.org, delphij@freebsd.org
Subject:   Re: docs/184550: bc -q option not documented in man page
Message-ID:  <26435.1386404181@server1.tristatelogic.com>
In-Reply-To: <20131207021835.GK20078@glenbarber.us>

next in thread | previous in thread | raw e-mail | index | archive | help

In message <20131207021835.GK20078@glenbarber.us>, 
Glen Barber <gjb@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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?26435.1386404181>