Update 2.16 release notes regarding git support
Clarify that git clients older than 2.2.0 are no longer supported.
Provide a workaround if needed to generate commit-msg hooks for older
clients.
Change-Id: Ia366031f135f11b9a9a81551c366c09cfb235515
diff --git a/pages/site/releases/2.16.md b/pages/site/releases/2.16.md
index dcf5400..329c198 100644
--- a/pages/site/releases/2.16.md
+++ b/pages/site/releases/2.16.md
@@ -37,6 +37,8 @@
Note that in the next version of Gerrit (v3.0), ReviewDb will not be available.
+Drop support for git clients older than 2.2.x.
+
### Schema Changes
This release contains schema changes. To upgrade:
@@ -215,6 +217,29 @@
This table was used to retrieve the `site_path` directory in unattended setup
mode. As a replacement, system property `gerrit.site_path` should be used.
+### Git clients older than 2.x are not supported anymore
+
+The Gerrit hook script for adding the Change-Id in every local commit has been
+simplified and is now using the git-interpret-trailers command.
+The interpret trailers command is available as of git v2.2.0, released
+Dec 2014.
+
+Existing cloned repositories that have been cloned before the migration to v2.16
+and thus having the old hook for generating the Change-Id will continue to work.
+However, new clones and hook scripts will need to upgrade your local git client
+to v2.2.0 or later.
+
+If you have existing older git clients and cannot migrate to v2.2.0 or later, you need
+to keep serving the old script, copying it to the Gerrit /static directory, and
+then amend the Gerrit helper instructions to download it.
+
+Example (assuming Gerrit installed on $GERRIT_SITE and available at https://gerrit.mycompany.com):
+
+```
+$ curl 'https://gerrit.googlesource.com/gerrit/+/stable-2.15/gerrit-server/src/main/resources/com/google/gerrit/server/tools/root/hooks/commit-msg?format=TEXT' > $GERRIT_SITE/static/commit-msg
+$ git config -f $GERRIT_SITE/etc/gerrit.config gerrit.installCommitMsgHookCommand 'gitdir=$(git rev-parse --git-dir); curl -o ${gitdir}/hooks/commit-msg https://gerrit.mycompany.com/static/commit-msg ; chmod +x ${gitdir}/hooks/commit-msg'
+```
+
## New Features
### Git protocol version 2
