Add config option for smooth deprecation of plugins
During migration from one deprecated plugin to a new one, it can be
useful to handle some options of the deprecated plugin in a new plugin
to preserve existing tooling until migration is completed.
Issue: Google b/255573054
Change-Id: Idaefd481a3df9425bbe00379bec9b66193c487c4
Release-Notes: skip
diff --git a/Documentation/config-gerrit.txt b/Documentation/config-gerrit.txt
index 234389e..5c5c4c0 100644
--- a/Documentation/config-gerrit.txt
+++ b/Documentation/config-gerrit.txt
@@ -4255,6 +4255,14 @@
+
Default is 5 seconds. Negative values will be converted to 0.
+[[plugins.transitionalPushOptions]]plugins.transitionalPushOptions::
++
+Additional push options which should be accepted by gerrit as valid
+options even if they are not registered by any plugin(e.g. "myplugin~foo").
++
+This config can be used when gerrit migrates from a deprecated plugin to the new one. The new plugin
+can (temporary) accept push options of the old plugin without registering such options.
+
[[receive]]
=== Section receive
