From owner-cvs-all Wed Aug 1 23:39: 7 2001 Delivered-To: cvs-all@freebsd.org Received: from mppsystems.com (mppsystems.com [208.210.148.205]) by hub.freebsd.org (Postfix) with ESMTP id 6DEA537B401; Wed, 1 Aug 2001 23:39:02 -0700 (PDT) (envelope-from mpp@mppsystems.com) Received: (from mpp@localhost) by mppsystems.com (8.11.3/8.11.3) id f726cov60268; Thu, 2 Aug 2001 01:38:50 -0500 (CDT) (envelope-from mpp) Date: Thu, 2 Aug 2001 01:38:50 -0500 From: Mike Pritchard To: Sheldon Hearn Cc: Yar Tikhiy , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/sbin/sysctl sysctl.8 src/share/man/man5 sysctl.conf.5 Message-ID: <20010802013849.B58410@mppsystems.com> References: <200107301418.f6UEIEc28798@freefall.freebsd.org> <15766.996503247@axl.seasidesoftware.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <15766.996503247@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Mon, Jul 30, 2001 at 04:27:27PM +0200 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Mon, Jul 30, 2001 at 04:27:27PM +0200, Sheldon Hearn wrote: > > > On Mon, 30 Jul 2001 07:18:14 MST, Yar Tikhiy wrote: > > > Modified files: > > sbin/sysctl sysctl.8 > > share/man/man5 sysctl.conf.5 > > Log: > > Since the ``-w'' sysctl(8) option has been deprecated, > > don't mention it in the manpages. > > Great. Now we're growing a base system full of utilities that will > accept (and apparently use, who knows?) undocumented command-line > options. > > The -w option should be documented until such time as sysctl(8) does not > accept it as a valid option. > > I suspect that if people understood how much work goes into deprecating > features, they'd think twice about gratuitous changes. :-( As long as the program accepts the argument, it should be documented in the man page, and state that the option is now deprecated. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message