On Fri, 6 Dec 2013, Eitan Adler wrote:

On Fri, Dec 6, 2013 at 9: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 is not documentation.  It it surprising to hear that,
especially on this list.

This is a bit puzzling. If -q is secret somehow, let's take it out of the synopsis. If it's real, it should be in the synopsis and description.

  -q    No-op, does nil, nothing, nada.  Emphatically not for
        compatibility with GNU bc, but coincidentally allows scripts
        from icky other platforms where -q does something to run without error.
        May occasionally print "gravy-sucking pig-dog" or contain traces
        of soy, nuts, eggs, titanium, and riboflavin, all part of a
        really interesting alibi.
_______________________________________________
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