Date: Wed, 6 Nov 2002 01:09:32 -0800 From: "David O'Brien" <obrien@FreeBSD.ORG> To: Mike Silbersack <silby@silby.com> Cc: Tom Rhodes <trhodes@FreeBSD.ORG>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/share/man/man4 rl.4 Message-ID: <20021106090932.GA530@dragon.nuxi.com> In-Reply-To: <20021106030005.O90236-100000@patrocles.silby.com> References: <20021106082857.GB14415@rot13.obsecurity.org> <20021106030005.O90236-100000@patrocles.silby.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Nov 06, 2002 at 03:10:33AM -0600, Mike Silbersack wrote: > 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 totally disagree. I often read the manpages when deciding if a NIC is a good choice to use or not. The insight Bill's comments give in the easy to find and read documentation is invaluable. More driver writers should convey this good information in their manpages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021106090932.GA530>