From 80eca1fafa3fa0e187ddeaec06e6a3dcdaa5eed3 Mon Sep 17 00:00:00 2001
From: Andrew Johnson <anj@aps.anl.gov>
Date: Mon, 29 Sep 2008 21:55:20 +0000
Subject: [PATCH] R3.14.10-RC1 update.

---
 documentation/KnownProblems.html | 38 +++++++++++++++++---------------
 1 file changed, 20 insertions(+), 18 deletions(-)
diff --git a/documentation/KnownProblems.html b/documentation/KnownProblems.html
index 05ab41d30..175879913 100644
--- a/documentation/KnownProblems.html
+++ b/documentation/KnownProblems.html
@@ -4,33 +4,35 @@
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <title>Known Problems R3.14.x</title>
-  <meta name="GENERATOR" content="amaya 5.1" />
+  <title>Known Problems R3.14.10-RC1</title>
 </head>
 
 <body>
-<h1 style="text-align: center">EPICS Base R3.14.9: Known Problems</h1>
+<h1 style="text-align: center">EPICS Base R3.14.10: Known Problems</h1>
 
 <ul>
-  <li>It is not possible to build this version of base on HP-UX due to C++
-    issues which appear to be bugs in the HP-UX compiler.</li>
+  <li>Parallel make (<tt>make -j</tt>) does not work on cygwin-x86 targets,
+    probably due to a missing dependency in the EPICS build rules.</li>
 
-  <li>When shutting down an IOC on a recent version of GNU/Linux (one that
-    includes the NPTL threading library) various messages may appear, such as:
+  <li>Some older Perl versions do not properly install the xsubpp program. This
+    will prevent the build in src/cap5 from completing &mdash; the build will
+    finish with an error like this:
 
-    <blockquote>
-      <pre>FATAL: exception not rethrown</pre></blockquote>
+    <blockquote><pre>/bin/sh: /bin/xsubpp: not found
+make[3]: *** [Cap5.c] Error 1
+make[3]: Leaving directory `/home/phoebus3/ANJ/epics/base/3-14-dev/src/cap5/O.solaris-x86'
+make[2]: *** [install.solaris-x86] Error 2
+make[2]: Leaving directory `/home/phoebus3/ANJ/epics/base/3-14-dev/src/cap5'
+make[1]: *** [cap5.install] Error 2
+make[1]: Leaving directory `/home/phoebus3/ANJ/epics/base/3-14-dev/src'
+make: *** [src.install] Error 2</pre></blockquote>
 
-    <blockquote>
-      <pre>epicsThread: Unknown C++ exception in thread "CAC-UDP" at ...</pre>
-      <pre>terminate called after throwing an instance of ''</pre>
-      </blockquote>
+    As long as you don't intend to use the Perl5 CA interface this error is
+    harmless, as cap5 is the last directory to be compiled in Base. If you need
+    the Perl5 CA inteface, fix your Perl installation so that the perl binary
+    and the xsubpp program (or soft links to them) are both found in the same
+    directory.</li>
 
-    These errors are caused by the implementation of the pthread_cancel()
-    mechanism in NPTL, which uses the C++ exception mechanism without providing
-    any means to distinguish the cancel exception to regular C++ exception
-    handlers. It is possible that they might also occur when a CA client
-    application exits (or closes its connection to the CA library).</li>
 </ul>
 
 </body>
