From 717bce7effec8232ed6c760058281b83ea8081b5 Mon Sep 17 00:00:00 2001
From: Sue Chaplain <sue_chaplain@uk.ibm.com>
Date: Wed, 9 Jan 2019 11:52:56 +0000
Subject: [PATCH] Release notes for 0.12.0 milestone 2

Updates to include new external changes between
0.12.0 milestone 1 and milestone 2.

Removed enable shared classes by default, which
is now targeted at the next release.

[ci-skip]

Signed-off-by: Sue Chaplain <sue_chaplain@uk.ibm.com>
---
 doc/release-notes/0.12/0.12.md | 41 +++++++++++++++++++++++++---------
 1 file changed, 31 insertions(+), 10 deletions(-)

diff --git a/doc/release-notes/0.12/0.12.md b/doc/release-notes/0.12/0.12.md
index 8b682683f30..594432db5db 100644
--- a/doc/release-notes/0.12/0.12.md
+++ b/doc/release-notes/0.12/0.12.md
@@ -1,5 +1,5 @@
 <!--
-* Copyright (c) 2017, 2018 IBM Corp. and others
+* Copyright (c) 2017, 2019 IBM Corp. and others
 *
 * This program and the accompanying materials are made
 * available under the terms of the Eclipse Public License 2.0
@@ -25,7 +25,7 @@
 # Eclipse OpenJ9 version 0.12.0 release notes
 
 :construction:
-These release notes are under construction and are not yet complete. The content reflects the December milestone build of Eclipse OpenJ9.
+These release notes are under construction and are not yet complete. The content reflects the January milestone build of Eclipse OpenJ9.
 
 These release notes support the [Eclipse OpenJ9 0.12.0 release plan](https://projects.eclipse.org/projects/technology.openj9/releases/0.12.0/plan).
 
@@ -37,7 +37,7 @@ OpenJ9 release 0.12.0 supports OpenJDK 8 and OpenJDK 11. Binaries are available
 - [OpenJDK with OpenJ9 version 8](https://adoptopenjdk.net/archive.html?variant=openjdk8&jvmVariant=openj9)
 - [OpenJDK with OpenJ9 version 11](https://adoptopenjdk.net/archive.html?variant=openjdk11&jvmVariant=openj9)
 
-OpenJ9 release 0.12.0 provides limited support for the MacOS platform on OpenJDK 8. Early builds of OpenJDK 8 with OpenJ9 on MacOS are available at the AdoptOpenJDK project at the following link:  
+OpenJ9 release 0.12.0 provides support for the MacOS platform on OpenJDK 8. Early builds of OpenJDK 8 with OpenJ9 on MacOS are available at the AdoptOpenJDK project at the following link:  
 
 - [OpenJDK v8 with OpenJ9](https://adoptopenjdk.net/nightly.html?variant=openjdk8&jvmVariant=openj9)
 
@@ -63,13 +63,7 @@ The following table covers notable changes in v0.12.0. Further information about
 <tr><td valign="top"><a href="https://github.com/eclipse/openj9/pull/3446">#3446</a></td>
 <td valign="top">Improved flexibility for managing the size of the JIT code cache</td>
 <td valign="top">OpenJDK8 and later (All platforms)</td>
-<td valign="top">The size of the JIT code cache (`-Xcodecachetotal`) can now be decreased as well as increased, with a minimum size of 2 MB</td>
-</tr>
-
-<tr><td valign="top"><a href="https://github.com/eclipse/openj9/issues/3854">#3854</a></td>
-<td valign="top">Class data sharing is enabled by default</td>
-<td valign="top">OpenJDK 8 and later (All platforms except macOS)</td>
-<td valign="top">Class data sharing is enabled by default for bootstrap classes, unless your application is running in a container. Use the `-Xshareclasses` option to change the default behavior.</td>
+<td valign="top">The size of the JIT code cache (-Xcodecachetotal) can now be decreased as well as increased, with a minimum size of 2 MB</td>
 </tr>
 
 <tr><td valign="top"><a href="https://github.com/eclipse/openj9/pull/3992">#3992</a></td>
@@ -90,6 +84,26 @@ The following table covers notable changes in v0.12.0. Further information about
 <td valign="top">When this mode is enabled, (`-Xgc:concurrentScavenge`) the VM attempts to reduce GC pause-times for response-time sensitive, large heap applications. This mode is now available on large heap (non-compressed references) builds. </td>
 </tr>
 
+<tr><td valign="top"><a href="https://github.com/eclipse/openj9/issues/4108">#4108</a></td>
+<td valign="top">Concurrent scavenge mode is now available on Windows x86</td>
+<td valign="top">OpenJDK8 and later (x86-64: Windows only)</td>
+<td valign="top">When this mode is enabled, (`-Xgc:concurrentScavenge`) the VM attempts to reduce GC pause-times for response-time sensitive applications. </td>
+</tr>
+
+<tr><td valign="top"><a href="https://github.com/eclipse/openj9/issues/3226">#3226</a></td>
+<td valign="top">Idle-tuning is enabled by default</td>
+<td valign="top">OpenJDK8 and later (Linux only)</td>
+<td valign="top">When OpenJ9 is running in a container, a garbage collection cycle and compaction of the object heap is attempted when
+the state of the VM is set to idle. </td>
+</tr>
+
+<tr><td valign="top"><a href="https://github.com/eclipse/openj9/pull/4025">#4025</a></td>
+<td valign="top">Changes to the default permissions of shared classes cache directories</td>
+<td valign="top">OpenJDK8 and later (All platforms except Windows)</td>
+<td valign="top">Tighter restrictions are imposed on existing and new shared classes cache directories. For further
+information about this change, see the <a href="https://www.eclipse.org/openj9/docs/version0.12/">user documentation</a>.</td>
+</tr>
+
 </table>
 
 
@@ -116,6 +130,13 @@ The v0.12.0 release contains the following known issues and limitations:
 <td valign="top">None</td>
 </tr>
 
+<tr><td valign="top"><a href="https://github.com/eclipse/openj9/issues/4222">#4222</a></td>
+<td valign="top">Shared classes no longer enabled by default</td>
+<td valign="top">All platforms</td>
+<td valign="top">In milestone 1, shared classes were enabled by default. This change has been reverted due to a performance regression.</td>
+<td valign="top">None</td>
+</tr>
+
 <tr><td valign="top"><a href="https://github.com/ibmruntimes/openj9-openjdk-jdk8/issues/129">#129</a></td>
 <td valign="top">OpenSSL support</td>
 <td valign="top">AIX</td>