Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 2 Aug 2001 01:38:50 -0500
From:      Mike Pritchard <mpp@mppsystems.com>
To:        Sheldon Hearn <sheldonh@starjuice.net>
Cc:        Yar Tikhiy <yar@FreeBSD.org>, 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>
In-Reply-To: <15766.996503247@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Mon, Jul 30, 2001 at 04:27:27PM %2B0200
References:  <200107301418.f6UEIEc28798@freefall.freebsd.org> <15766.996503247@axl.seasidesoftware.co.za>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010802013849.B58410>