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.

-- 
Adam
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Reply via email to