From owner-cvs-all Wed Nov 6 1:26:58 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 3749237B401; Wed, 6 Nov 2002 01:26:57 -0800 (PST) Received: from vectors.cx (manifold.vectors.cx [64.163.147.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id C667B43E88; Wed, 6 Nov 2002 01:26:56 -0800 (PST) (envelope-from monkey@vectors.cx) Received: from vectors.cx (7768b7ddaaecb794d1b60720b7e5da4b@localhost [127.0.0.1]) by vectors.cx (8.12.6/8.12.4) with ESMTP id gA69Ssit099864; Wed, 6 Nov 2002 01:28:54 -0800 (PST) (envelope-from monkey@vectors.cx) Received: (from monkey@localhost) by vectors.cx (8.12.6/8.12.6/Submit) id gA69SsAw099863; Wed, 6 Nov 2002 01:28:54 -0800 (PST) (envelope-from monkey) Date: Wed, 6 Nov 2002 01:28:54 -0800 From: Adam Weinberger To: "David O'Brien" , Mike Silbersack , Tom Rhodes , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man4 rl.4 Message-ID: <20021106092854.GZ197@vectors.cx> References: <20021106082857.GB14415@rot13.obsecurity.org> <20021106030005.O90236-100000@patrocles.silby.com> <20021106090932.GA530@dragon.nuxi.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; x-action=pgp-signed Content-Disposition: inline In-Reply-To: <20021106090932.GA530@dragon.nuxi.com> X-Editor: Vim 6.1 http://www.vim.org X-Mailer: Mutt 1.5 http://www.mutt.org X-PGP-Key: http://www.vectors.cx/pgp.key.txt X-URL: http://www.vectors.cx http://www.crackula.com User-Agent: Mutt/1.5.1i 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 -----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