From owner-freebsd-doc Fri Dec 14 13:58:10 2001 Delivered-To: freebsd-doc@freebsd.org Received: from rwcrmhc51.attbi.com (rwcrmhc51.attbi.com [204.127.198.38]) by hub.freebsd.org (Postfix) with ESMTP id 1762437B420 for ; Fri, 14 Dec 2001 13:58:01 -0800 (PST) Received: from gateway.posi.net ([12.236.90.177]) by rwcrmhc51.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20011214215800.JCF5010.rwcrmhc51.attbi.com@gateway.posi.net>; Fri, 14 Dec 2001 21:58:00 +0000 Received: from localhost (kbyanc@localhost) by gateway.posi.net (8.11.6/8.11.6) with ESMTP id fBELvxL07803; Fri, 14 Dec 2001 13:58:00 -0800 (PST) (envelope-from kbyanc@posi.net) X-Authentication-Warning: gateway.posi.net: kbyanc owned process doing -bs Date: Fri, 14 Dec 2001 13:57:58 -0800 (PST) From: Kelly Yancey To: Dima Dorfman Cc: doc@freebsd.org Subject: Re: Updating queue(3) in RELENG_4 In-Reply-To: <20011214074515.D89D33E31@bazooka.trit.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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