From owner-cvs-all Wed Nov 6 3: 4: 9 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B75E637B401; Wed, 6 Nov 2002 03:04:07 -0800 (PST) Received: from harmony.village.org (rover.bsdimp.com [204.144.255.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 90C9243E4A; Wed, 6 Nov 2002 03:04:03 -0800 (PST) (envelope-from imp@bsdimp.com) Received: from localhost (warner@rover2.village.org [10.0.0.1]) by harmony.village.org (8.12.3/8.12.3) with ESMTP id gA6B3rpk088541; Wed, 6 Nov 2002 04:03:53 -0700 (MST) (envelope-from imp@bsdimp.com) Date: Wed, 06 Nov 2002 04:03:40 -0700 (MST) Message-Id: <20021106.040340.95821734.imp@bsdimp.com> To: silby@silby.com Cc: kris@obsecurity.org, trhodes@FreeBSD.org, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man4 rl.4 From: "M. Warner Losh" In-Reply-To: <20021106030005.O90236-100000@patrocles.silby.com> References: <20021106082857.GB14415@rot13.obsecurity.org> <20021106030005.O90236-100000@patrocles.silby.com> X-Mailer: Mew version 2.1 on Emacs 21.2 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG In message: <20021106030005.O90236-100000@patrocles.silby.com> Mike Silbersack writes: : : On Wed, 6 Nov 2002, Kris Kennaway wrote: : : > On Tue, Nov 05, 2002 at 07:53:08PM -0800, Tom Rhodes wrote: : > > trhodes 2002/11/05 19:53:08 PST : > > : > > Modified files: : > > share/man/man4 rl.4 : > > Log: : > > Remove Realtek discriminating comments from the rl(4) manual page. : > > This leaves us with 'just the facts' : > : > The realtek comments are one of the hidden treasures of the FreeBSD : > source code..I'd like to see them stay. : > : > Kris : : In this case, the file in question is a manpage rather than a piece of : source code. The source code remains unchanged (as it should be.) : : I think this brings up a question of how we want our manpages focused... : looking over the common ethernet driver manpages, it's clear that Bill's : the only person who lists chipset bugs in the BUGS section of manpages. : Although there are bugs with fxp, vr, and (most recently) bge, there are : no man page comments relating to these issues. : : I think it might be in our best interests to move the sections to comments : in source code in cases where the bug in question has been worked around : and is not an issue for the user. I think more man pages should list bugs. There's no real reason to delete these comments. The *ARE* the facts, so that's really a lame excuse to remove them. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message