From owner-freebsd-chat@FreeBSD.ORG Fri Apr 25 17:30:57 2003 Return-Path: Delivered-To: freebsd-chat@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E22AF37B401 for ; Fri, 25 Apr 2003 17:30:57 -0700 (PDT) Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12C5D43FB1 for ; Fri, 25 Apr 2003 17:30:57 -0700 (PDT) (envelope-from swear@attbi.com) Received: from localhost.localdomain (unknown[12.242.158.67]) by sccrmhc01.attbi.com (sccrmhc01) with ESMTP id <2003042600305600100e3868e>; Sat, 26 Apr 2003 00:30:56 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) by localhost.localdomain (8.12.6/8.12.5) with ESMTP id h3Q0V3sg054646; Fri, 25 Apr 2003 17:31:09 -0700 (PDT) (envelope-from swear@attbi.com) Received: (from jojo@localhost) by localhost.localdomain (8.12.6/8.12.5/Submit) id h3Q0UvCq054643; Fri, 25 Apr 2003 17:30:57 -0700 (PDT) (envelope-from swear@attbi.com) X-Authentication-Warning: localhost.localdomain: jojo set sender to swear@attbi.com using -f To: Terry Lambert References: <20030422132906.GB64101@dogma.freebsd-uk.eu.org> <444r4qmp6n.fsf@be-well.ilk.org> <20030422172549.GA65023@dogma.freebsd-uk.eu.org> <20030425044935.GG81840@dogma.freebsd-uk.eu.org> <3EA9AFDA.65B1D90E@mindspring.com> From: swear@attbi.com (Gary W. Swearingen) Date: 25 Apr 2003 17:30:56 -0700 In-Reply-To: <3EA9AFDA.65B1D90E@mindspring.com> Message-ID: <3qel3q9k1r.l3q@localhost.localdomain> Lines: 21 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii cc: freebsd-chat@freebsd.org Subject: Re: Code layout and debugging time X-BeenThere: freebsd-chat@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Non technical items related to the community List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 26 Apr 2003 00:30:58 -0000 Terry Lambert writes: > Personally, I think Linux and FreeBSD driver code *should* document > the hardware, [...] And it should be kept in the source code (or an Article), not in the USER MANUAL, as seems to be SOP (eg, for the RealTek "rl" driver). Unfortunately, it's clear from intro(4) that FreeBSD prefers to have users slogging through the same manpages as driver developers. But I suppose it's practically unavoidable without paid documenters. And, though you apparently disagree with me, the documentation shouldn't publicly humiliate the hardware manufacturer, as the "rl" manpage does. A private message to the manufacturer would be more seemly. If I were RealTek, I'd withhold ALL documentation and communication with FreeBSD people until they stopped their anti-advertising campain against my company. I filed PR 31271 on this matter and it got multiple agreement from doc-ers and got "fixed", but it seems that somebody's vicious streak ran too deep and the nastiness was mostly restored -- and it's much worse in the driver source. And if RealTek has improved, as you say, those comments certainly ought to be improved too.