Date: Fri, 14 Dec 2001 07:45:10 +0000 From: Dima Dorfman <dima@trit.org> To: Kelly Yancey <kbyanc@posi.net> Cc: doc@freebsd.org Subject: Re: Updating queue(3) in RELENG_4 Message-ID: <20011214074515.D89D33E31@bazooka.trit.org> In-Reply-To: <Pine.BSF.4.21.0112092348300.24864-100000@gateway.posi.net>; from kbyanc@posi.net on "Sun, 9 Dec 2001 23:48:53 -0800 (PST)"
next in thread | previous in thread | raw e-mail | index | archive | help
Kelly Yancey <kbyanc@posi.net> wrote: > > Would someone mind taking a look at the following diff. It is to MFC > revisions 1.18-1.20 of queue.3 to RELENG_4. I'm no mdoc guru, but it looks > right to me: > http://www.posi.net/freebsd/patches/queue-cruft.diff Looks okay to me. > > More importantly, is there anything prohibiting just sync'ing queue.3 up > with HEAD? I noticed the most recent commit was to use a new mdoc macro; do we > use the same mdoc package in HEAD and RELENG_4? The .In macro exists on -stable, but I don't think most of the man pages have been converted to use it yet (as was done in -current). There should not, however, be any problems with using it in -stable. > 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? 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?20011214074515.D89D33E31>