From owner-freebsd-doc Sun Oct 14 16:30:10 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 7D6C337B40A for ; Sun, 14 Oct 2001 16:30:05 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f9ENU5592854; Sun, 14 Oct 2001 16:30:05 -0700 (PDT) (envelope-from gnats) Date: Sun, 14 Oct 2001 16:30:05 -0700 (PDT) Message-Id: <200110142330.f9ENU5592854@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Dima Dorfman Subject: Re: docs/31271: rl(4) discourages vender openness by disparaging remarks. Reply-To: Dima Dorfman Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/31271; it has been noted by GNATS. From: Dima Dorfman To: swear@blarg.net Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/31271: rl(4) discourages vender openness by disparaging remarks. Date: Sun, 14 Oct 2001 23:24:59 +0000 "Gary W. Swearingen" wrote: > >Description: > > rl(4) discourages device manufacturer's openness ... or encourages them to write better documentation :-). > --- /tmp/rl.4.old Sun Oct 14 15:51:07 2001 > +++ /tmp/rl.4 Sun Oct 14 15:51:47 2001 > @@ -189,9 +189,6 @@ > The driver probably should not be > depending on this characteristic. > .Pp > -The RealTek data sheets are of especially poor quality: the grammar > -and spelling are awful and there is a lot of information missing, > -particularly concerning the receiver operation. > One particularly > important fact that the data sheets fail to mention relates to the > way in which the chip fills in the receive buffer. If you think this is rude, I invite you to read the first paragraph of the third comment block of the source code (sys/pci/if_rl.c). It says, in part: "This is probably the worst PCI ethernet controller ever [made]". What your change removes is much more polite, albeit more visible. Further, your change takes away the context from the sentence following it. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message