Date: Sun, 14 Oct 2001 16:30:05 -0700 (PDT) From: Dima Dorfman <dima@trit.org> To: freebsd-doc@freebsd.org Subject: Re: docs/31271: rl(4) discourages vender openness by disparaging remarks. Message-ID: <200110142330.f9ENU5592854@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/31271; it has been noted by GNATS. From: Dima Dorfman <dima@trit.org> 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" <swear@blarg.net> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200110142330.f9ENU5592854>