Date: Wed, 06 Nov 2002 04:03:40 -0700 (MST) From: "M. Warner Losh" <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 Message-ID: <20021106.040340.95821734.imp@bsdimp.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
In message: <20021106030005.O90236-100000@patrocles.silby.com>
Mike Silbersack <silby@silby.com> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021106.040340.95821734.imp>