enhanced release notes.

Author: jmellorcrummey

README.ReleaseNotes

@@ -31,11 +31,11 @@ Contents:
 0.2. Unsupported experimental features
 ----------------------------------------
 
-- We are not yet supporting measurement and analysis of Cilk
-  applications, though you are free to try it out.  (PPoPP '09)
-
-- We are don't yet support Cilk++. It violates our assumption that
-  profile interrupts can be processed on a thread's stack.
+- HPCToolkit can be used to analyze the performance of code parallelized
+  using CilkPlus features available in Intel and GNU compilers. Without 
+  runtime support, HPCToolkit shows an implementation-level view where
+  call stacks for worker threads contain whatever computation fragments
+  they stole rooted at the stolen frames.
 
 - We are not yet supporting measurement and analysis of Pthreads lock
   contention, though you are free to try it out.  (PPoPP '10)
@@ -185,32 +185,59 @@ Contents:
 HPCToolkit Version 2017.06, June 2017
 ----------------------------------------
 
-Updated the 'ompt' branch and merged master into ompt.  This branch,
-together with the llvm-openmp runtime library (github project
-OpenMPToolsInterface) provides support for attributing idleness in
-openmp programs (event OMP_IDLE).
+Updated the 'ompt' branch and merged master into ompt.  This improves
+scalability of the ompt support to large thread counts, as found on 
+KNL and Power8. The ompt branch, together with the LLVM OpenMP runtime 
+library provides 
+
+- support for attributing performance measurements to a global-view,
+  source-level program representation by unifying measurements of OpenMP 
+  activity in worker threads with the main thread.
+- support for attributing causes of idleness in OpenMP programs using
+  HPCToolkit event OMP_IDLE.
+
+The LLVM OpenMP runtime can be used with Clang, Intel, and GNU compilers. 
+The LLVM OpenMP runtime with OMPT support for performance analysis 
+can be can be obtained as follows 
+
+  svn co http://llvm.org/svn/llvm-project/openmp/trunk openmp
+
+To use the draft OMPT support present in LLVM's OpenMP runtime, one must 
+build the LLVM OpenMP runtime with LIBOMP_OMPT_SUPPORT=TRUE. This version
+of the runtime is designed to be used with HPCToolkit's ompt branch.
+
+  Note: support for the OMPT tools interface in HPCToolkit and LLVM
+  currently follows a design outlined in TR2 at openmp.org. An improved
+  version of the OMPT interface was designed for OpenMP 5.0, which
+  is described in TR4 at openmp.org. At some point soon, both LLVM and
+  HPCToolkit will transition to support the new API; presently, both lack
+  support for the new API.
 
 Merged the 'atomics' branch into master.  This branch replaces the
 atomic operations in hpcrun with C11 atomics through the stdatomic.h
 header file.
 
 Updated Dyninst to version 9.3.2 in externals, plus a patch for better
-jump table support.
+binary analysis of functions that use jump tables. 
+
+Updated hpcstruct to handle new ABI on Power/LE architectures, which
+has both internal and external interfaces for functions.
+
 
 Various bug fixes:
 
--- fixed bugs in hpcrun and unwinding on x86-64 due to lea
-instructions that resulted in partial unwinds.
+-- enhanced binary analysis for call stack unwinding on x86-64, including 
+an enhancement to analyze functions that perform stack alignment and
+a bug fix to track stack frame allocation/deallocation of space for local 
+variables using the load effective address (LEA) instruction.
 
--- fixed bug in hpcrun over failing to reinitialize data after fork()
-that affected programs with launch scripts.
+-- fixed bug in hpcrun to correct data reinitialization after fork(). This
+bug prevented using hpcrun to profile programs launched with shell scripts.
 
--- fixed bug in hpcrun over binary analysis related to ld.so.
+-- fixed bug in hpcrun in binary analysis related to ld.so.
 
 -- fixed bug in hpcstruct in getRealPath() that caused hpcstruct
-sometimes to report incorrect file names.
-
--- fixed bug in hpcstruct over outlined function names on powerpc.
+to sometimes report incorrect file names.
 
 ----------------------------------------
 HPCToolkit Version 2016.12, Dec 2016