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
diff --git a/ReleaseNotes/ReleaseNotes-2.12.1.txt b/ReleaseNotes/ReleaseNotes-2.12.1.txt
index 379572e..943371b 100644
--- a/ReleaseNotes/ReleaseNotes-2.12.1.txt
+++ b/ReleaseNotes/ReleaseNotes-2.12.1.txt
@@ -14,21 +14,25 @@
*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 @@
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,23 +175,12 @@
+
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.
-+
-Existing plugins that implement this interface must be adapted to the new
-method signature.
-
-* link:https://code.google.com/p/gerrit/issues/detail?id=3741[Issue 3741]:
-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.
+
@@ -178,11 +189,31 @@
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.
++
+If a plugin raised an exception, it was reported to the user as 'Change is
+new', rather than 'Missing dependency'.
+
+* 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.
++
+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
--------