Date: Wed, 21 Aug 2002 15:12:34 +0300 From: Giorgos Keramidas <keramida@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net> Cc: Marc Fonvieille <blackend@FreeBSD.org>, doc@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/advanced-networking chapter.sgml doc/en_US.ISO8859-1/books/handbook/linuxemu chapter.sgml doc/en_US.ISO8859-1/books/handbook/ppp-and-slip chapter.sgml Message-ID: <20020821121234.GD81256@hades.hell.gr> In-Reply-To: <20020817163021.GA2666@idoru.tenten> References: <200208152105.g7FL5Lv6014947@freefall.freebsd.org> <20020816084433.GD20494@idoru.tenten> <20020816214856.D59091@abigail.blackend.org> <20020817163021.GA2666@idoru.tenten>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2002-08-17 17:30 +0000, Ceri Davies wrote: > On Fri, Aug 16, 2002 at 09:48:56PM +0200, Marc Fonvieille said: > > > I missed my chance to follow up to the PR, but since sysctl > > > still works with the -w option, might it be better to keep > > > this in? > > > > I removed it only from Handbook as it covers the 4.X branch, to be > > consistent with the examples given by sysctl(8), the commands used > > in rc.* files and also all manual pages mentioning sysctl (natd(8) > > for example). > > Yeah, I know that ;) > > What I'm asking is whether folks think it might be an idea to keep the -w > since then anyone with a pre-4.5 (ish?) machine will be able to follow the > examples as well, since at the moment sysctl just ignores -w. It's not something I'd be silly about, but I think it's probably okay to slowly switch the documentation to "modern" uses of the commands. > I don't care, I'm just asking what folks think. I'm all for keeping down the number of surprises one gets, by following examples. I'd object to -w staying in the docs after it becomes obsolete and starts printing warnings like: root@hades[15:10]/root# sysctl -w net.inet.tcp.newreno=1 sysctl: warning: The -w option is deprecated. Do not use it. net.inet.tcp.newreno: 1 -> 1 Right now, I don't really mind if the documentation is either way. - Giorgos To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020821121234.GD81256>