diff --git a/documentation/README.html b/documentation/README.html
index e48e91fd3..862d488ec 100644
--- a/documentation/README.html
+++ b/documentation/README.html
@@ -88,15 +88,18 @@
  as processes on the host platform.</P>
 
 <P><B>vxWorks</B><BR>
- You must have vxWorks installed if any of your target systems are
- vxWorks systems. This provides the cross-compiler and header files
- needed to build for these target systems. The absolute path to and version
- number of the vxWorks  installation is normally specified in the
- base/configure/os/CONFIG_SITE.Common.vxWorksCommon file. Consult the EPICS web
- pages about <a href="http://www.aps.anl.gov/epics/base/tornado.php">vxWorks
- 5.x</a> and <a href="http://www.aps.anl.gov/epics/base/vxWorks6.php">vxWorks
- 6.x</a> and the vxWorks documentation for information about configuring your
- vxWorks operating system for use with EPICS.</P>
+ You must have vxWorks 5.5.x or 6.x installed if any of your target systems are
+ vxWorks systems; the C++ compiler for vxWorks 5.4 is now too old to support.
+ The vxWorks installation provides the cross-compiler and header files needed to
+ build for these targets. The absolute path to and the version number of the
+ vxWorks installation must be set in the
+ base/configure/os/CONFIG_SITE.Common.vxWorksCommon file or in one of its
+ target-specific overrides.</P>
+
+<P>Consult the <a href="http://www.aps.anl.gov/epics/base/tornado.php">vxWorks
+ 5.x</a> or <a href="http://www.aps.anl.gov/epics/base/vxWorks6.php">vxWorks
+ 6.x</a> EPICS web pages about and the vxWorks documentation for information
+ about configuring your vxWorks operating system for use with EPICS.</P>
 
 <P><B>RTEMS</B><BR>
  For RTEMS targets, you need RTEMS core and toolset version 4.9.2 or later.</P>