From owner-freebsd-doc Sun Oct 14 16:10: 6 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 608CB37B40B for ; Sun, 14 Oct 2001 16:10:01 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f9ENA1D90638; Sun, 14 Oct 2001 16:10:01 -0700 (PDT) (envelope-from gnats) Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id 4B20837B401 for ; Sun, 14 Oct 2001 16:07:45 -0700 (PDT) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id 5860DBD39 for ; Sun, 14 Oct 2001 16:07:44 -0700 (PDT) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id QAA05704 for ; Sun, 14 Oct 2001 16:07:44 -0700 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id f9EN6tF33529; Sun, 14 Oct 2001 16:06:55 -0700 (PDT) (envelope-from swear@blarg.net) Message-Id: Date: 14 Oct 2001 16:06:55 -0700 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/31271: rl(4) discourages vender openness by disparaging remarks. 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 >Number: 31271 >Category: docs >Synopsis: rl(4) discourages vender openness by disparaging remarks. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Oct 14 16:10:01 PDT 2001 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.4-RELEASE i386 >Organization: none >Environment: n/a ================ >Description: rl(4) discourages device manufacturer's openness by disparaging (in unnecessarily rude terms) the documentation they graciously provided on their web site. Such remarks might discourage this or other manufacturers from opening their documents. (The man page also says much that would be better placed in the driver source, but it's probably not worthwhile moving it.) ================ >How-To-Repeat: n/a ================ >Fix: Remove the most offending/unnecessary/unhelpful sentence. patch -d "unknown uncompressed man directory" < this-PR --- /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. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message