From swear@blarg.net  Sat Mar  9 20:46:16 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 325C737B417
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  9 Mar 2002 20:46:16 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id D170EBDD6
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  9 Mar 2002 20:46:10 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id UAA29323
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 9 Mar 2002 20:46:10 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g2A4nY704211;
	Sat, 9 Mar 2002 20:49:34 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <ydd6yddo2p.6yd@localhost.localdomain>
Date: 09 Mar 2002 20:49:34 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: le(4) page doesn't warn about likely system crashes.
X-GNATS-Notify:

>Number:         35723
>Category:       docs
>Synopsis:       le(4) page doesn't warn about likely system crashes.
>Confidential:   no
>Severity:       critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 09 20:50:01 PST 2002
>Closed-Date:    Sat Nov 23 11:13:12 PST 2002
>Last-Modified:  Sat Nov 23 11:13:12 PST 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The le(4) man page should warn in a new "Bugs" section (placed before
the "Description", preferably) that the le driver has been causing
system panics during use of "ifconfig" since at least 4.0-RELEASE and is
no longer being supported.  (It got it with 4.5 and the only reply to my
crash dump report was a reference to the suspended PR misc/18641 on the
same symptom) and a comment that it seemed to be unsupported.)
================
>How-To-Repeat:
n/a
================
>Fix:
See Description.

A PR against the driver, GENERIC, LINT, etc, should probably be entered.
Is it customary to write one or two PRs in these situations?  Should
misc/18641 get a followup?  I think I just read that obsolete stuff
stays in until the next x.0-RELEASE.
>Release-Note:
>Audit-Trail:

From: Josh Paetzel <friar_josh@webwarrior.net>
To: freebsd-gnats-submit@freebsd.org
Cc: swear@blarg.net
Subject: Re: Docs/35723 le(4) page doesn't warn about likely system crashes.
Date: Fri, 15 Mar 2002 11:05:11 +0000

 --3V7upXqbjpZ4EhLz
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Here's a patch to the man page that puts in a BUGS section, I left it 
 in the traditional place, though.
 
 
 
 *** le.4.old    Fri Mar 15 10:57:26 2002
 --- le.4        Fri Mar 15 10:57:42 2002
 ***************
 *** 93,95 ****
 --- 93,99 ----
   .An Matt Thomas .
   This manual page was written by
   .An David E. O'Brien .
 + .Sh BUGS
 + This driver has been causing kernel panics since 4.0-RELEASE, and 
 appears to be no
 + longer actively maintained.  PR misc/18641 describes the known 
 issues that have been
 + submitted.
 
 Josh
 
 
 --3V7upXqbjpZ4EhLz
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="le.diff"
 
 *** le.4.old	Fri Mar 15 10:57:26 2002
 --- le.4	Fri Mar 15 10:57:42 2002
 ***************
 *** 93,95 ****
 --- 93,99 ----
   .An Matt Thomas .
   This manual page was written by
   .An David E. O'Brien .
 + .Sh BUGS
 + This driver has been causing kernel panics since 4.0-RELEASE, and appears to be no
 + longer actively maintained.  PR misc/18641 describes the known issues that have been
 + submitted.
 
 --3V7upXqbjpZ4EhLz--

From: Tom Rhodes <darklogik@pittgoth.com>
To: Ceri <setantae@submonkey.net>
Cc: Josh Paetzel <friar_josh@webwarrior.net>,
	FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/35723
Date: Mon, 25 Mar 2002 10:39:43 -0500

 Ceri wrote:
 
 > On Mon, Mar 25, 2002 at 10:21:56AM -0500, Tom Rhodes wrote:
 > 
 >>Ceri wrote:
 >>
 >>
 >>>On Sun, Mar 24, 2002 at 03:14:13PM +0000, Josh Paetzel wrote:
 >>>
 >>>
 >>>>Is there any reason not to commit this?  I ran into yet another lost 
 >>>>soul on irc tonight trying to get this driver to work.
 >>>>
 >>>>*** le.4.old    Fri Mar 15 10:57:26 2002
 >>>>--- le.4        Fri Mar 15 10:57:42 2002
 >>>>***************
 >>>>*** 93,95 ****
 >>>>--- 93,99 ----
 >>>> .An Matt Thomas .
 >>>> This manual page was written by
 >>>> .An David E. O'Brien .
 >>>>+ .Sh BUGS
 >>>>+ This driver has been causing kernel panics since 4.0-RELEASE, and 
 >>>>appears to be no
 >>>>+ longer actively maintained.  PR misc/18641 describes the known 
 >>>>issues that have been
 >>>>+ submitted.
 >>>>
 >>>>
 >>>Well I don't think we should refer to PRs in manpages for one.
 >>>
 >>>
 >>hmmm, Ceri, why don't we cut from the PR listing down?
 >>
 > 
 > Well I also don't think that we should say "this driver...appears to be
 > no longer actively maintained".
 > Which means that I don't like two thirds of the suggested patch, which
 > is really quite a lot for a 27 word patch.
 > 
 > Far better would something like "This driver causes kernel panics".
 > And I don't like that either :)
 > 
 > Ceri
 > 
 > 
 
 This driver causes inconsistancies (sp, use i/aspell) and can
 sometimes lead to kernel panics.
 
 This driver is currently obsolete and may cause system instability,
 if this occurs please try another driver or card.
 
 Can we email the maintainer and find out if their is another driver
 that can be used in its place, maybe list that?  How do you feel
 about the above sentances?  I know it will be ``raising barriers'' for
 users, but they should be warned about a driver known to cause
 panics.  On the other hand, I do not like mentioning the other card
 idea.  Catch 22?
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: "Gary W. Swearingen" <swear@blarg.net>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/35723: le(4) page doesn't warn about likely system crashes.
Date: Tue, 20 Aug 2002 01:59:38 +0300

 Adding to audit trail:
 
 > Date: Tue, 13 Aug 2002 09:00:56 -0600
 > Message-ID: <005a01c242da$3a7a6a00$2784412f@ca.nortel.com>
 > From: "Samuel Chow" <cyschow@shaw.ca>
 > Subject: docs/35723
 >
 > Hi guys,
 >
 >     I think docs/35723 can be closed.  The le(4) driver
 >     is working now.  I tested it yesterday night on -STABLE.
 >
 > ---
 > Samuel Chow
 > cyschow@shaw.ca
State-Changed-From-To: open->feedback 
State-Changed-By: keramida 
State-Changed-When: Mon Aug 19 16:04:18 PDT 2002 
State-Changed-Why:  
Gary, does the problem persist?  Samuel Chow seems to have this 
working.  Can you try with onne of the more recent 4.x RELEASE 
versions and see if this is still a problem? 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35723 
State-Changed-From-To: feedback->closed 
State-Changed-By: keramida 
State-Changed-When: Sat Nov 23 11:12:04 PST 2002 
State-Changed-Why:  
Feedback from Gary at Tue, 20 Aug 2002 01:59:38 +0300 
seems to indicate that there are this is an old, saved problem. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sat Nov 23 11:12:04 PST 2002 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=35723 
>Unformatted:
