From info@volginfo.ru Thu Feb 20 02:12:54 2003 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ABF2337B401 for ; Thu, 20 Feb 2003 02:12:54 -0800 (PST) Received: from vsmi.ru (ns.vsmi.ru [217.23.84.98]) by mx1.FreeBSD.org (Postfix) with SMTP id 4050E43F93 for ; Thu, 20 Feb 2003 02:12:14 -0800 (PST) (envelope-from info@volginfo.ru) Received: (qmail 53954 invoked from network); 20 Feb 2003 13:18:17 -0000 Received: from unknown (HELO img.local) (192.168.0.1) by 192.168.0.50 with SMTP; 20 Feb 2003 13:18:16 -0000 Message-Id: <200302201319.35837.info@volginfo.ru> Date: Thu, 20 Feb 2003 13:19:35 +0300 From: "Denis N. Peplin" To: FreeBSD-gnats-submit@freebsd.org Subject: using deprecated sysctl option in FAQ >Number: 48482 >Category: docs >Synopsis: using deprecated sysctl option in FAQ >Confidential: no >Severity: non-critical >Priority: low >Responsible: keramida >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Feb 20 09:10:13 PST 2003 >Closed-Date: Thu Feb 27 10:59:51 PST 2003 >Last-Modified: Mon Jul 05 16:44:10 GMT 2004 >Originator: Denis N.Peplin >Release: FreeBSD 4.7-RELEASE-p1 i386 >Organization: >Environment: System: FreeBSD img.local 4.7-RELEASE-p1 FreeBSD 4.7-RELEASE-p1 #0: Wed Nov 6 16:45:51 MSK 2002 sg@img.local:/usr/obj/usr/src/sys/nKERN2 i386 >Description: from http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/disks.html#USER-FLOPPYMOUNT # sysctl -w vfs.usermount=1 and from man sysctl: The -w option has been deprecated and is silently ignored. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: From: Giorgos Keramidas To: "Denis N. Peplin" Cc: bug-followup@freebsd.org Subject: Re: docs/48482: using deprecated sysctl option in FAQ Date: Fri, 21 Feb 2003 21:49:20 +0200 On 2003-02-20 13:19, "Denis N. Peplin" wrote: > from > http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/disks.html#USER-FLOPPYMOUNT > # sysctl -w vfs.usermount=1 > > and from man sysctl: > The -w option has been deprecated and is silently ignored. Well, just to be on the safe side here, since the FAQ is supposed to document stuff for previous versions too, can we leave it there? Or perhaps, add a small note that "versions of FreeBSD newer than 4.4 don't need -w to work". NOTE: I haven't checked when -w was deprecated on the 4.X branch, but we can do that later, if this looks a nice idea, I guess. From: Giorgos Keramidas To: Tom Rhodes Cc: bug-followup@FreeBSD.org Subject: Re: docs/48482: using deprecated sysctl option in FAQ Date: Sat, 22 Feb 2003 05:12:30 +0200 On 2003-02-21 20:55, Tom Rhodes wrote: > On Fri, 21 Feb 2003 17:50:09 -0800 (PST) > Giorgos Keramidas wrote: > > Well, just to be on the safe side here, since the FAQ is supposed to > > document stuff for previous versions too, can we leave it there? Or > > perhaps, add a small note that "versions of FreeBSD newer than 4.4 > > don't need -w to work". > > My 3 day old RELENG_4 build has the same thing as the HEAD version of > sysctl(8). So basicly its gone, I don't have a cvs history for you, > but if we are following 4.8 then this should be probly be removed. Looking through the CVS logs, -w was marked as deprecated in 1.32 of sysctl.c which was later merged as 1.25.2.5. The oldest release that was branched *after* that point was 4.4-REL. Since this release is barely than 1.5 year old, I would like a note to see added instead of the -w option being simply removed from the docs. We should really support as many releases as possible in our documentation, otherwise the note at the beginning of the FAQ is a blatant lie. This is the FAQ for FreeBSD versions 2.X, 3.X, and 4.X. All entries are assumed to be relevant to FreeBSD 2.0.5 and later, unless otherwise noted. Does something like the following look ok? %%% Index: book.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v retrieving revision 1.511 diff -u -r1.511 book.sgml --- book.sgml 19 Feb 2003 07:25:18 -0000 1.511 +++ book.sgml 22 Feb 2003 03:11:17 -0000 @@ -3960,6 +3960,13 @@ &prompt.root; sysctl -w kern.timecounter.method=1 + + The option of &man.sysctl.8; is + deprecated and silently ignored in &os; 4.4-RELEASE and all + newer versions. You can safely ommit it when setting options + with sysctl as shown above. + + This means a performance impact, but considering the cause of this problem, you probably will not notice. If the problem persists, keep the sysctl set to one and set the %%% - Giorgos From: Tom Rhodes To: Giorgos Keramidas Cc: bug-followup@FreeBSD.org Subject: Re: docs/48482: using deprecated sysctl option in FAQ Date: Fri, 21 Feb 2003 22:26:04 -0500 On Sat, 22 Feb 2003 05:12:30 +0200 Giorgos Keramidas wrote: > Looking through the CVS logs, -w was marked as deprecated in 1.32 of > sysctl.c which was later merged as 1.25.2.5. The oldest release that > was branched *after* that point was 4.4-REL. Since this release is > barely than 1.5 year old, I would like a note to see added instead of > the -w option being simply removed from the docs. We should really > support as many releases as possible in our documentation, otherwise > the note at the beginning of the FAQ is a blatant lie. I think a recent post from Nik to Ceri spoke about removing support for the 2.X releases from the documentation effort. But words differ from actions :) > > This is the FAQ for FreeBSD versions 2.X, 3.X, and 4.X. All > entries are assumed to be relevant to FreeBSD 2.0.5 and later, > unless otherwise noted. > > Does something like the following look ok? > > %%% > Index: book.sgml > =================================================================== > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v > retrieving revision 1.511 > diff -u -r1.511 book.sgml > --- book.sgml 19 Feb 2003 07:25:18 -0000 1.511 > +++ book.sgml 22 Feb 2003 03:11:17 -0000 > @@ -3960,6 +3960,13 @@ > > &prompt.root; sysctl -w > kern.timecounter.method=1 > > + > + The option of &man.sysctl.8; is > + deprecated and silently ignored in &os; 4.4-RELEASE and > all+ newer versions. You can safely ommit it when setting > options+ with sysctl as shown above. > + > + > This means a performance impact, but considering the > cause > of this problem, you probably will not notice. If the > problem persists, keep the sysctl set to one and set the > %%% > This looks good here, but I want to ask a quick question on note. All the times I add a tag, I follow it with the tag, is this correct, incorrect, not matter? I would really like to follow a `style' and just have not noticed a pattern as of yet. -- Tom Rhodes State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Feb 27 10:57:36 PST 2003 State-Changed-Why: Patch from the audit trail committed. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Thu Feb 27 10:57:36 PST 2003 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=48482 >Unformatted: