Rototill OS X pl2303 issues.

Narrow scope to the osx-pl2303 driver, as that's the only thing for
which trouble has been reliably reported.  Recommend against it, and
note that source no longer seems available.

1 files changed, 11 insertions, 30 deletions

diff --git a/www/upstream-bugs.html b/www/upstream-bugs.html
index 4420beba..0fd47883 100644
--- a/www/upstream-bugs.html
+++ b/www/upstream-bugs.html
@@ -64,8 +64,7 @@ maintainer, we've tried to kick these upstream.</p>
 <h1>Links to Open User-Visible Problems</h1>
 
 <ul>
-<li><a href="#appleserial">Unknown serial-layer issues under Mac OS X</a></li> 
-<li><a href="#select">Buggy pl2303 drivers on Mac OS X can make select(2) look broken</a></li>
+<li><a href="#osx-pl2303">Unknown osx-pl2303 driver issues on Mac OS X</a></li> 
 <li><a href="#tiocmwait">PPS fails: ioctl(TIOCMIWAIT) hangs after tcsetattr()</a></li>
 <li><a href="#bluetooth">Firmware problems in some Bluetooth and USB devices can hang them</a></li>
 <li><a href="#pl2303">Linux pl2303 driver on openwrt 2.4 kernel can hang when device is read at unexpected speed</a></li>
@@ -97,36 +96,18 @@ maintainer, we've tried to kick these upstream.</p>
 
 <h1>Open User-Visible Problems</h1>
 
-<h2 href="appleserial">Unknown serial-layer issues under Mac OS X</h2> 
+<h2 href="osx-pl2303">Unknown osx-pl2303 driver issues on Mac OS X</h2> 
 
-<p>There is some unknown issue in the Mac OS X serial layer (observed
-under 10.9 and 10.10) that prevents reliable use with GPSD.</p>
+<p>The osx-pl2303 driver appears not to work, at least under 10.9.
+  Specifically, the combination of gpsd, OS X, osx-pl2303, and a
+  GR601-W usually fails.  With the official Prolific drivers, this
+  receiver works reliably.   The source code of this driver no longer
+  appears to be available.   Therefore we recommend against using the
+  osx-pl2303 driver and consider it unsupported</p>
 
-<p>Devices often work on the first open of a tty after reboot, only to
-fail in subtle ways on subsequent opens.  The symptom is that
-<code>gpsd</code> sees garbage from the device and cannot achieve
-packet synchronization.</p>
-
-<p>This bug has been observed on both USB and Bluetooth, so it is not
-the same as the problem with buggy pl2303 drivers. It also survived
-gpsd's move from non-blocking to blocking serial I/O.</p>
-
-<p>This problem has forced us to drop OS X from the list of supported
-platforms pending either a fix to the buggy serial layer or the 
-discovery of some magic workaround.</p>
-
-<h2 id="select">Buggy pl2303 drivers on Mac OS X can make select(2) look broken</h2>
-
-<p>When the fd set being polled includes tty devices (as opposed to
-sockets), select(2) can return 0 and shows no fd with input waiting
-even when data is in fact ready to be read from some of the devices.</p>
-
-<p>The most recent incarnation of this problem was due to a buggy pl2303
-USB-to-serial driver. OS X users should ensure that all their drivers are
-up to date. As of January 2009, this is still a problem - the most recent
-report being a failure of the drivers from osx-pl2303.sourceforge.net on
-OS X 10.5.6. Please try the latest drivers from www.prolific.com.tw before
-reporting hangs on OS X.</p>
+<p>Previously, there were problems with the osx-pl2303 driver that
+  caused select not to return even when input was available.  It is
+  not clear if the above issue is the same or not.</p>
 
 <h2 id="tiocmwait">PPS fails: ioctl(TIOCMIWAIT) hangs after tcsetattr()</h2>