diff --git a/documentation/RELEASE_NOTES.md b/documentation/RELEASE_NOTES.md
index 078b07ece..1f549f3e0 100644
--- a/documentation/RELEASE_NOTES.md
+++ b/documentation/RELEASE_NOTES.md
@@ -18,29 +18,44 @@ should also be read to understand what has changed since earlier releases.
 <!-- Insert new items immediately below here ... -->
 
 
-### Support for RTEMS 5
-
+### Experimental Support for RTEMS 5                                                                                                                                                                                             
 The new major release of the RTEMS real-time OS contains many changes
-including the ability to support SMP systems. The earlier EPICS
-support for RTEMS made use of various RTEMS-specific kernel APIs which
-cannot be used on an SMP system, so the changes here required a
-completely new port to the Posix real-time APIs that RTEMS-5 now
-recommends.
+including the ability to support SMP systems and support for several
+new targets:
 
+- RTEMS-beagleboneblack
+- RTEMS-pc686
+- RTEMS-qoriq_e500
+- RTEMS-xilinx-zynq-a9_qemu
+- RTEMS-xilinx_zynq_zedboard  
+                                              
+The earlier EPICS support for RTEMS made use of various
+RTEMS-specific kernel APIs which cannot be used on an SMP system, so
+the changes here required a completely new port to the Posix
+real-time APIs that RTEMS-5 now recommends.
+                                                                                                                                                                      
 A new RTEMS configuration variable RTEMS_VERSION has been added which
-should be set to the OS version number, e.g. 4.9. When this is 4.12 or
-greater, true for 5.0 as well, the new libCom/osi/os/RTEMS-posix
-source files will be used; the older API source files can now be found
-in libCom/osi/os/RTEMS-kernel, and those which are common to both
-installations are in libCom/osi/os/RTEMS. The compiler options are
-read from the Makefile.inc of the corresponding BSP and set in the
-configuration files. It checks that the BSP was also built with the
---enable-posix option. It also checks if the BSP was built with the
-legacy stack or libbsd.
+should be set to the OS version number, e.g. 4.9. When this is 4.12
+or greater, true for 5.1 as well, the new libCom/osi/os/RTEMS-posix
+source files will be used; the older API source files can now be
+found in libCom/osi/os/RTEMS-kernel, and those which are common to
+both installations are in libCom/osi/os/RTEMS. The compiler options
+are read from the Makefile.inc of the corresponding BSP and set in
+the configuration files. It checks that the BSP was also built with
+the --enable-posix option. It also checks if the BSP was built with
+the legacy stack or libbsd.
+                                                                                                                                                                                                                    
+The dependency on bspExt has been removed.  RTEMS 5 provides the bus
+support natively now.
+
+Known Issues:
+- MVME2100, MVME167, and uC5282 have not yet been updated to compile for RTEMS 5.
+- VMEBus support is not available for all powerpc BSPs.
+- There are some known issues with floating point on MVME2500
+- Changed network driver for beatnik to work with libbsd.  Some
+  issues with DHCP, but network stack usable.  Can load env from
+  NVRAM.
 
-RTEMS5 brings support for new targets including:
-RTEMS-beagleboneblack, RTEMS-pc686, RTEMS-qoriq_e500,
-RTEMS-xilinx-zynq-a9_qemu, RTEMS-xilinx_zynq_zedboard
 
 ### Priority inversion safe posix mutexes