Update 2.12.1 release notes

Improve the instructions for migrating the patch_sets table.

Add some more fixes that have been submitted since the last update.

Reorder the 'Plugins' section moving the important fixes to the top.

Change-Id: Ib78a1b0ef4066df19b7272e39ae3df37a0dfcc5f

1 files changed, 49 insertions, 18 deletions

diff --git a/ReleaseNotes/ReleaseNotes-2.12.1.txt b/ReleaseNotes/ReleaseNotes-2.12.1.txt
index 379572edec..943371b6e2 100644
--- a/ReleaseNotes/ReleaseNotes-2.12.1.txt
+++ b/ReleaseNotes/ReleaseNotes-2.12.1.txt
@@ -14,21 +14,25 @@ listed in these release notes.
 *WARNING:* This version includes a manual schema upgrade when upgrading
 from 2.12.
 +
-If you have already upgraded to 2.12, you need to issue this SQL statement
-manually (e.g. using the `gerrit gsql` SSH command or the `gqsl` site
-program):
+When upgrading a site that is already running version 2.12, the `patch_sets`
+table must be manually migrated using the `gerrit gsql` SSH command or the
+`gqsl` site program.
++
+For the default H2 database or MySQL, execute the command:
 +
   alter table patch_sets modify push_certficate clob;
 +
-Or with this command if the site is configured to use PostgreSQL:
+For PostgreSQL, execute the command:
 +
   alter table patch_sets alter column push_certficate type text;
 +
+For other database types, execute the appropriate equivalent command.
++
 Note that the misspelled `push_certficate` is the actual name of the
 column.
 +
-If you are upgrading from a version earlier than 2.12, this manual step is
-not necessary and should be omitted.
+When upgrading from a version earlier than 2.12, this manual step is not
+necessary and should be omitted.
 
 
 Bug Fixes
@@ -125,9 +129,27 @@ is reduced from 'no limit' to 1024.
 Explicitly set parent project to 'All-Projects' when a project is created
 without giving the parent.
 
+* link:https://code.google.com/p/gerrit/issues/detail?id=3948[Issue 3919]:
+Fix submit of project parent updates on `refs/meta/config`.
++
+When submitting a change on `refs/meta/config` to update a project's parent,
+the error 'The change must be submitted by a Gerrit administrator' was being
+displayed even when the submitter was an admin. The submit was successful
+when clicking 'Submit' a second time.
+
+* link:https://code.google.com/p/gerrit/issues/detail?id=3811[Issue 3811]:
+Fix submittability of merge commits that resolve merge conflicts.
++
+If a series of changes contained a change that conflicted with the destination
+branch, but the conflict was solved by a merge commit at the tip of the
+series, the series was not submittable.
+
 UI
 ^^
 
+* link:https://code.google.com/p/gerrit/issues/detail?id=3894[Issue 3894]:
+Fix display of 'Related changes' after change is rebased in web UI:
+
 * link:https://code.google.com/p/gerrit/issues/detail?id=3071[Issue 3071]:
 Fix display of submodule differences in side-by-side view.
 
@@ -153,16 +175,19 @@ etc..).
 +
 Note that the problem still exists on the unified diff screen.
 
+* Improve tooltip on 'Submit' button when 'Submit whole topic' is enabled
+and the topic can't be submitted due to some changes not being ready.
+
 Plugins
 ^^^^^^^
 
-* Allow plugins to get the caller in merge validation requests.
-+
-Plugins that implement the `MergeValidationListener` interface now get the
-caller (the user who initiated the merge) in the `onPreMerge` method.
+* link:https://code.google.com/p/gerrit/issues/detail?id=3821[Issue 3821]:
+Fix repeated reloading of plugins when running on OpenJDK 8.
 +
-Existing plugins that implement this interface must be adapted to the new
-method signature.
+OpenJDK 8 uses nanotime precision for file modification time on systems that
+are POSIX 2008 compatible. This leads to precision incompatibility when
+comparing the plugin's JAR file timestamp, resulting in the plugin being
+reloaded every minute.
 
 * link:https://code.google.com/p/gerrit/issues/detail?id=3741[Issue 3741]:
 Fix handling of merge validation exceptions emitted by plugins.
@@ -170,19 +195,25 @@ Fix handling of merge validation exceptions emitted by plugins.
 If a plugin raised an exception, it was reported to the user as 'Change is
 new', rather than 'Missing dependency'.
 
-* link:https://code.google.com/p/gerrit/issues/detail?id=3821[Issue 3821]:
-Fix repeated reloading of plugins when running on OpenJDK 8.
+* Allow plugins to get the caller in merge validation requests.
 +
-OpenJDK 8 uses nanotime precision for file modification time on systems that
-are POSIX 2008 compatible. This leads to precision incompatibility when
-comparing the plugin's JAR file timestamp, resulting in the plugin being
-reloaded every minute.
+Plugins that implement the `MergeValidationListener` interface now get the
+caller (the user who initiated the merge) in the `onPreMerge` method.
++
+Existing plugins that implement this interface must be adapted to the new
+method signature.
+
+* link:https://code.google.com/p/gerrit/issues/detail?id=3892[Issue 3892]:
+Allow plugins to suggest reviewers based on either change or project
+resources.
 
 Documentation
 ^^^^^^^^^^^^^
 
 * Update documentation of `commentlink` to reflect changed search URL.
 
+* Add missing documentation of valid `database.type` values.
+
 Upgrades
 --------