Date: Fri, 14 Dec 2001 13:57:58 -0800 (PST) From: Kelly Yancey <kbyanc@posi.net> To: Dima Dorfman <dima@trit.org> Cc: doc@freebsd.org Subject: Re: Updating queue(3) in RELENG_4 Message-ID: <Pine.BSF.4.21.0112141330300.7003-100000@gateway.posi.net> In-Reply-To: <20011214074515.D89D33E31@bazooka.trit.org>
index | next in thread | previous in thread | raw e-mail
On Fri, 14 Dec 2001, Dima Dorfman wrote:
[snip]
> > Also, is there any reason not
> > to axe CIRCLEQs from the documentation ala rev 1.21? We don't have to axe the
> > impementation (to avoid surprising anyone using them), but rather just don't
> > describe them so as to reduce new code depending on them.
>
> The documentation might still be useful to somebody trying to
> understand what a piece of code does. Perhaps just marking it
> "deprecated" (along with the reason(s) why) in a few obvious places
> would be sufficient?
>
Hmm. Good point. The goal was to sync RELENG_4's queue.3 with HEAD's, but
HEAD has removed all mention of CIRCLEQs. I updated the patch with MFC's
revisions 1.18-1.20, 1.22, 1.24-1.26. It specifically does not MFC 1.21
or 1.23 which remove references to CIRCLEQs, nor 1.27 which switches to the
.In macro for #includes. If wouldn't mind reviewing it, I'de appreciate
it. The intention being that after this commit which gets the two versions
closer together, to followup with a commit which marks CIRCLEQs as
depreciated. That should leave the two versions as close to one another as
possible[*] while still reflecting the reality that CIRCLEQs are going away,
but they aren't gone yet.
[*] Actually we could MFC 1.27, switching to the .In macro, but as you say
nothing else uses it in RELENG_4.
Thanks,
Kelly
New diff: http://www.posi.net/freebsd/patches/queue-cruft.diff
--
Kelly Yancey - kbyanc@{posi.net,FreeBSD.org}
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.21.0112141330300.7003-100000>