Date: Fri, 21 Feb 2003 19:30:06 -0800 (PST) From: Tom Rhodes <trhodes@FreeBSD.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/48482: using deprecated sysctl option in FAQ Message-ID: <200302220330.h1M3U6lF074041@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/48482; it has been noted by GNATS. From: Tom Rhodes <trhodes@FreeBSD.org> To: Giorgos Keramidas <keramida@FreeBSD.org> 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 <keramida@FreeBSD.org> 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 @@ > > <screen>&prompt.root; <userinput>sysctl -w > kern.timecounter.method=1</userinput></screen> > > + <note> > + <para>The <option>-w</option> 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 <command>sysctl</command> as shown above.</para> > + </note> > + > <para>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 <note> tag, I follow it with the <para> 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 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?200302220330.h1M3U6lF074041>