Date: Sat, 27 Sep 1997 10:03:40 +0800 From: Peter Wemm <peter@netplex.com.au> To: uhclem@nemesis.lonestar.org (Frank Durda IV) Cc: peter@FreeBSD.ORG, freebsd-bugs@FreeBSD.ORG Subject: Re: docs/4627 Message-ID: <199709270203.KAA03016@spinner.netplex.com.au> In-Reply-To: Your message of "Fri, 26 Sep 1997 11:09:00 CDT." <m0xEcx1-000tx1C@nemesis.lonestar.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Frank Durda IV wrote: > > [0]State-Changed-From-To: open-closed > [0]State-Changed-By: peter > [0]State-Changed-When: Fri Sep 26 05:38:41 PDT 1997 > [0]State-Changed-Why: > [0]All media options are completely and utterly driver specific. > [0] > [0]If you take a driver from a third party you should not > [0]expect the driver that corresponds to the freebsd version to > [0]document the options that the 3rd party driver happens to implement > [0]on that particular card. The 'de' driver (from matt's site) > [0]has different media options for different cards. > > Uh, if you had read the problem report *completely*, you would have > found that I was reporting the problem with the stock, as-included > DE driver MAN PAGE that came in the 970921 release, AFTER discovering the > ifconfig interfaces had changed, rendering the 3rd party driver useless > to me on the 970921 release. ONCE AGAIN, I WAS USING A 100% STOCK 970921 > RELEASE. > > Besides, this particular report is a DOCUMENTATION problem. The 970921 > ifconfig man page says to refer to the 970921 if_de man page, and guess > what? The 970921 if_de man page has none of the expected ifmedia parameter > information. > > Please re-read and re-open the bug report. You submitted two seperate problem reports. I read each in full. The RELENG_2_2 de driver DOES NOT support ifmedia in any way shape or form. It's manual page is correct in not documenting the media options since there ARE NONE. The RELENG_2_2 manpage should document the link* flags that it accepts though. The configure interface for the stock if_de driver has NOT changed in the entire 2.2 branch. We were planning on updating the driver in 2.2 to the one that does use ifmedia but that seems to have autoselect problems among other bugs. It (for starters) doesn't seem to be able to detect the BNC port on cards that work under the old driver. In PR4627 you state: - You areusing Matt's driver, and in older RELENG_2_2 releases you were using the link* flags. - When you updated to the current 2.2 sources, the link* flags were no longer used as ifmedia support was present and matt's driver detected it. - You read 'man ifconfig' which documents 'media', 'mediaopt', '-mediaopt' and '-m' and says that they are device and driver specific. - You then read the RELENG_2_2 de.4 manpage and expected it to document what Matt's 3rd party driver accepts for the *media* options. I'm sorry, but we cannot telepathically detect and document what future versions of matt's driver will support. You say: "If we are going to break the ability to change settings on drivers, we should actually document what you are supposed to do now." We do. We say 'see the driver documentation'. If Matt didn't supply an updated man page, that's his documentation problem, not ours. Well, I guess we could change 'driver specific man page' to 'driver specific documentation or man page' if that would satisfy you. We *DO* document the 'ifconfig -m' switch which asks the driver for a list of supported media strings. You didn't seem to read this or you would have tried it and discovered that it tells you the exact strings that the new driver allows on your particular card. I'll reply to the other PR seperately. -- Peter Wemm <peter@netplex.com.au> Netplex Consulting
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199709270203.KAA03016>