Date: Wed, 6 Nov 2002 01:28:54 -0800 From: Adam Weinberger <adamw@FreeBSD.org> To: "David O'Brien" <obrien@FreeBSD.org>, Mike Silbersack <silby@silby.com>, 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: <20021106092854.GZ197@vectors.cx> In-Reply-To: <20021106090932.GA530@dragon.nuxi.com> References: <20021106082857.GB14415@rot13.obsecurity.org> <20021106030005.O90236-100000@patrocles.silby.com> <20021106090932.GA530@dragon.nuxi.com>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 >> (11.06.2002 @ 0109 PST): David O'Brien said, in 0.9K: << > On Wed, Nov 06, 2002 at 03:10:33AM -0600, Mike Silbersack wrote: > > 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. >> end of "Re: cvs commit: src/share/man/man4 rl.4" from David O'Brien << FWIW, when I was shopping for wireless NICs, the first thing I did when I decided on the card was read the wi(4) manpage, because I knew Bill had written the drivers. Short of talking to Bill himself, I can think of no better place to turn to for info on how strong a NIC actually is than the manpage. The source contains a lot of, well, code. But the manpage contains just information. While Bill's comments in wi(4) are, as usual, colorful, they're also factual, not opinion. (Note: this does NOT apply to the if_rl.c source ::) I think it'd be a shame to see that information stricken. - -Adam - -- Adam Weinberger adam@vectors.cx adamw@FreeBSD.ORG -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE9yODWo8KM2ULHQ/0RAghgAKDG3eE30hrSo1qGr9TbZKhbi5/KSwCcCOVD Kl6k9ibA3c/bWbIOa3xAH0g= =oQCj -----END PGP SIGNATURE----- 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?20021106092854.GZ197>