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>
This commit is contained in:
Edwin Kempin 2015-07-03 08:50:46 +02:00
parent 11c5dea020
commit 322db679f5
2 changed files with 26 additions and 1 deletions

View File

@ -1525,6 +1525,31 @@ not default, as not all instances will deploy repo.
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

@ -1 +1 @@
Subproject commit 61395a2f263bd9722445908e9e07a42050a132f7
Subproject commit 334f7253855551bea40f0f27b68e3d7aa71fe4af