From owner-freebsd-doc@FreeBSD.ORG Thu Jun 9 20:36:26 2011 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DDAF01065673; Thu, 9 Jun 2011 20:36:26 +0000 (UTC) (envelope-from gavin.atkinson@ury.york.ac.uk) Received: from gse-mta-27.emailfiltering.com (gse-mta-27-tx.emailfiltering.com [194.116.198.158]) by mx1.freebsd.org (Postfix) with ESMTP id C97E68FC0C; Thu, 9 Jun 2011 20:36:24 +0000 (UTC) Received: from mail-gw5.york.ac.uk ([144.32.129.29]) by gse-mta-27.emailfiltering.com with emfmta (version 4.8.1.33) by TLS id 1030083492 for dougb@FreeBSD.org; df563b41dfb19237; Thu, 09 Jun 2011 21:25:25 +0100 Received: from ury.york.ac.uk ([144.32.108.81]:39226) by mail-gw5.york.ac.uk with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1QUlnA-00070W-Px; Thu, 09 Jun 2011 21:25:24 +0100 Received: from gavin (helo=localhost) by ury.york.ac.uk with local-esmtp (Exim 4.76) (envelope-from ) id 1QUlnA-0004kh-Gn; Thu, 09 Jun 2011 21:25:24 +0100 Date: Thu, 9 Jun 2011 21:25:24 +0100 (BST) From: Gavin Atkinson X-X-Sender: gavin@"ury.york.ac.uk." To: Doug Barton In-Reply-To: <4DED3B7A.1010302@FreeBSD.org> Message-ID: References: <201106061314.p56DEhAd063030@freefall.freebsd.org> <4DED3B7A.1010302@FreeBSD.org> User-Agent: Alpine 2.00 (LNX 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: 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 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 09 Jun 2011 20:36:27 -0000 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