Update revision of the download-commands plugin
* Use commit IDs for download commands when change refs are hidden
This commit in the download-commands plugin introduces a new
configuration option. Add documentation for it in Gerrit core since
for historic reasons all download configuration parameters are
described here and it doesn't make sense to document a single
parameter in another place.
Change-Id: I6ee13ba6a98907023578c8ecedd2900205c86baa
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
diff --git a/Documentation/config-gerrit.txt b/Documentation/config-gerrit.txt
index ac33778..723e24c 100644
--- a/Documentation/config-gerrit.txt
+++ b/Documentation/config-gerrit.txt
@@ -1525,6 +1525,31 @@
If `download.scheme` is not specified, SSH, HTTP and Anonymous HTTP
downloads are allowed.
+[[download.checkForHiddenChangeRefs]]download.checkForHiddenChangeRefs::
++
+Whether the download commands should be adapted when the change refs
+are hidden.
++
+Git has a configuration option to hide refs from the initial
+advertisement (`uploadpack.hideRefs`). This option can be used to hide
+the change refs from the client. As consequence fetching changes by
+change ref does not work anymore. However by setting
+`uploadpack.allowTipSha1InWant` to `true` fetching changes by commit ID
+is possible. If `download.checkForHiddenChangeRefs` is set to `true`
+the git download commands use the commit ID instead of the change ref
+when a project is configured like this.
++
+Example git configuration on a project:
++
+----
+[uploadpack]
+ hideRefs = refs/changes/
+ hideRefs = refs/cache-automerge/
+ allowTipSha1InWant = true
+----
++
+By default `false`.
+
[[download.archive]]download.archive::
+
Specifies which archive formats, if any, should be offered on the change
diff --git a/plugins/download-commands b/plugins/download-commands
index 61395a2..334f725 160000
--- a/plugins/download-commands
+++ b/plugins/download-commands
@@ -1 +1 @@
-Subproject commit 61395a2f263bd9722445908e9e07a42050a132f7
+Subproject commit 334f7253855551bea40f0f27b68e3d7aa71fe4af
