From owner-freebsd-doc Thu Dec 13 23:45:19 2001 Delivered-To: freebsd-doc@freebsd.org Received: from bazooka.trit.org (bazooka.trit.org [63.198.170.138]) by hub.freebsd.org (Postfix) with ESMTP id 341C037B41B for ; Thu, 13 Dec 2001 23:45:16 -0800 (PST) Received: by bazooka.trit.org (Postfix, from userid 1000) id D89D33E31; Fri, 14 Dec 2001 07:45:15 +0000 (UTC) Received: from bazooka (localhost [127.0.0.1]) by bazooka.trit.org (Postfix) with ESMTP id D75D53C12E; Fri, 14 Dec 2001 07:45:15 +0000 (UTC) To: Kelly Yancey Cc: doc@freebsd.org Subject: Re: Updating queue(3) in RELENG_4 In-Reply-To: ; from kbyanc@posi.net on "Sun, 9 Dec 2001 23:48:53 -0800 (PST)" Date: Fri, 14 Dec 2001 07:45:10 +0000 From: Dima Dorfman Message-Id: <20011214074515.D89D33E31@bazooka.trit.org> 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 Kelly Yancey 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