Date: Fri, 06 Dec 2013 23:13:08 -0800 From: Xin Li <delphij@delphij.net> To: Eitan Adler <lists@eitanadler.com>, Xin LI <d@delphij.net> Cc: "freebsd-doc@freebsd.org" <freebsd-doc@freebsd.org>, Xin LI <delphij@freebsd.org>, "Ronald F. Guilmette" <rfg@tristatelogic.com> Subject: Re: docs/184550: bc -q option not documented in man page Message-ID: <52A2CA84.1060700@delphij.net> In-Reply-To: <CAF6rxg=BmrJ6wey2HmoJAMV=Fg0TG-jptddmy8txp0CXTGddDg@mail.gmail.com> References: <201312070107.rB717SAW015758@freefall.freebsd.org> <CAF6rxgk50a0gL7_O3t=iFM-XGjnwam07ZNkOOgsWV=Tu7OKDXQ@mail.gmail.com> <52A2C3C3.9010703@delphij.net> <CAF6rxgmfrUn8Kghx-j50FKNU5xadjjJKdYHmuiSO3pnaFHHYSQ@mail.gmail.com> <52A2C9A0.4050800@delphij.net> <CAF6rxg=BmrJ6wey2HmoJAMV=Fg0TG-jptddmy8txp0CXTGddDg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 On 12/6/13, 11:11 PM, Eitan Adler wrote: > On Sat, Dec 7, 2013 at 2:09 AM, Xin Li <delphij@delphij.net> > wrote: >> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 >> >> On 12/6/13, 10:48 PM, Eitan Adler wrote: >>> On Sat, Dec 7, 2013 at 1:44 AM, Xin Li <delphij@delphij.net> >>> wrote: >>>> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 >>>> >>>> On 12/6/13, 6:12 PM, Eitan Adler wrote: >>>>> On 12/6/13, delphij@freebsd.org <delphij@freebsd.org> >>>>> wrote: >>>>>> Synopsis: bc -q option not documented in man page >>>>>> >>>>>> State-Changed-From-To: open->closed State-Changed-By: >>>>>> delphij State-Changed-When: Sat Dec 7 01:06:05 UTC 2013 >>>>>> State-Changed-Why: This is intentional. Won't fix. >>>>>> >>>>>> >>>>>> Responsible-Changed-From-To: freebsd-doc->delphij >>>>>> Responsible-Changed-By: delphij Responsible-Changed-When: >>>>>> Sat Dec 7 01:06:05 UTC 2013 Responsible-Changed-Why: >>>>>> Take. >>>>>> >>>>>> http://www.freebsd.org/cgi/query-pr.cgi?pr=184550 >>>>>> _______________________________________________ >>>>>> freebsd-doc@freebsd.org mailing list >>>>>> http://lists.freebsd.org/mailman/listinfo/freebsd-doc To >>>>>> unsubscribe, send any mail to >>>>>> "freebsd-doc-unsubscribe@freebsd.org" >>>>>> >>>>> >>>>> all options should be documented. An undocumented option >>>>> is a bug. If we don't want people using it we should >>>>> document as such. >>>> >>>> Well, no, it's not an undocumented option but a bug-for-bug >>>> compatibility shim. >>> >>> Eh? >>> >>>> However as Warren pointed out, it's a bug having it in >>>> synopsis and usage. >>> >>> It is not a bug. >>> >>>> This is fixed in r259058. >>> >>> This is a bug. >>> >>>> With our limited manpower, I think it's more important to >>>> improve our documentation in the direction that we describe >>>> our stuff better, like how to write a vt(4) driver, etc. >>> >>> I agree that we need better documentation for our own >>> features; however, this is not a dichotomy. >>> >>>> rather than documenting the bug-for-bug features which would >>>> just give the reader an impression like "I can write program >>>> according to GNU command line standard and expect the BSD >>>> people to diligently implement bug-for-bug compatibility". >>> >>> A similar discussion occurred when we implemented '==' for >>> test(1). If a program accepts some flag as input, or some text >>> as input, it must be documented. We may document it as a >>> non-portable, to be avoided feature, but it should not be left >>> alone. >> >> Fair enough, how about this? > > Works for me. Thank you very much! Ok, committed as 259060 and thanks for your patience. Cheers, -----BEGIN PGP SIGNATURE----- iQIbBAEBCgAGBQJSosqEAAoJEJW2GBstM+nsneIP+ND+hIQUUFP6ndKvJqvBvqst gOLdX/hLA98Z8htPv4CIY/gz5UCVdatP8gtDRXgu/RE6QV3ZEMJz1pGLd16ZN+y5 SsCckwYNIibzt4zj3X1Yx+yKIf9FI80r6X2fGAh6LlyISI86QNCeFs5BU6ycXyMp FOhDDrJ0byoelly1kjAZiECuEwr+WcxtR7aSn4So7HT0/efzl16oSyb+lmyDdx+8 un88cFlArtpbn0MuQ390LE6LEEbQh8pvOh5dzR1yNgdn+bNkjnIUYrxc8sb7PAJ4 VZ+06KEojLThiVcvVdKJpm6MHEJZ6fJOeOevXm1kjpchbzTVAaFBpX/emkP7XR2t Nfj5MxmmMEFpjWMmYslAq9VZgQwDKxP6CR2Y8Cv7FVICCse1FAnmd5TSVxK4zM5H W5bzFBfLQTVX8P5PV2Bjc4Jz5SHeIQgfLcE2eLwNXe5MASC6eBLToK93BDCdGYxH 8GY2aIlJfVUbbLG0BY3pYGGGa0i77Fh00+qGQb/rguteYrCqCF1908a62M56GiOR rW6KqLSSu7Uv9lIKavp9ngLNwI4D7qAXz2J3U0lUclZ10lbsAA6EvFDAdi9hQ/Py XafPAvdRg+IkdYZLp0Ll0NZJzOJsRp/mTIkUalzfOEYsy0DGC/G9qHIbDOZmsZHo DzIiN1lXnjXdEXZgeUw= =/eYz -----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52A2CA84.1060700>