Date: Thu, 9 Jun 2011 21:25:24 +0100 (BST) From: Gavin Atkinson <gavin@FreeBSD.org> To: Doug Barton <dougb@FreeBSD.org> Cc: kilian.klimek@googlemail.com, freebsd-rc@FreeBSD.org, freebsd-doc@FreeBSD.org, bug-followup@FreeBSD.org Subject: Re: docs/154494: rcorder(8) not quite accurate Message-ID: <alpine.LNX.2.00.1106092040370.17356@ury.york.ac.uk.> In-Reply-To: <4DED3B7A.1010302@FreeBSD.org> References: <201106061314.p56DEhAd063030@freefall.freebsd.org> <4DED3B7A.1010302@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 6 Jun 2011, Doug Barton wrote: > I wish that you had discussed this with freebsd-rc@ before committing. :-/ I > can't see any good thing that comes from documenting this. OTOH, the benefit > of not documenting it is that eventually we can remove support for the > un-documented versions because they are no longer used. I must admit that I was a little surprised to see the man page be so explicit in saying that no other keywords were accepted, and yet the rcorder(8) code accepts them happily. I wasn't happy with the patch submitted in the PR for a number of reasons, but I felt that my rewording made it clear that these were accepted only historically, and therefore not suggested for use in new scripts. I tried to get the balance correct between documenting behaviour, and discouraging the use of deprecated features. I'm happy to revert this if you think these should remain deliberately undocumented. Gavin
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.LNX.2.00.1106092040370.17356>