On Fri, Dec 06, 2013 at 08:41:29PM -0600, Adam Vande More wrote:
> On Fri, Dec 6, 2013 at 8:18 PM, Glen Barber <g...@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;
> >
> 
> Source code comments IMO don't qualify for docs.
> 
> It should be documented in the man page.  There are plenty of other
> examples cite option X is there for compatibility/historical purposes.
>  Most users aren't going to review the source code for docs.
> 

Since it does nothing, it absolutely applies, IMHO.

Glen

Attachment: pgpZJTB4ZS5Ap.pgp
Description: PGP signature

Reply via email to