summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLukas Fleischer <lfleischer@lfos.de>2015-11-03 08:58:14 +0100
committerJunio C Hamano <gitster@pobox.com>2015-11-05 11:25:00 -0800
commit92cab492ba988ffd3e3edf040f19ba820306c833 (patch)
tree39ef77cc310dc670406a2cfd2e2e7787f3fb3b26
parentaa826b651ae3012d1039453b36ed6f1eab939ef9 (diff)
downloadgit-92cab492ba988ffd3e3edf040f19ba820306c833.tar.gz
config.txt: document the semantics of hideRefs with namespaces
Right now, there is no clear definition of how transfer.hideRefs should behave when a namespace is set. Explain that hideRefs prefixes match stripped names in that case. This is how hideRefs patterns are currently handled in receive-pack. Signed-off-by: Lukas Fleischer <lfleischer@lfos.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--Documentation/config.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/config.txt b/Documentation/config.txt
index 391a0c3c85..993e3a948e 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -2673,6 +2673,14 @@ You may also include a `!` in front of the ref name to negate the entry,
explicitly exposing it, even if an earlier entry marked it as hidden.
If you have multiple hideRefs values, later entries override earlier ones
(and entries in more-specific config files override less-specific ones).
++
+If a namespace is in use, the namespace prefix is stripped from each
+reference before it is matched against `transfer.hiderefs` patterns.
+For example, if `refs/heads/master` is specified in `transfer.hideRefs` and
+the current namespace is `foo`, then `refs/namespaces/foo/refs/heads/master`
+is omitted from the advertisements but `refs/heads/master` and
+`refs/namespaces/bar/refs/heads/master` are still advertised as so-called
+"have" lines.
transfer.unpackLimit::
When `fetch.unpackLimit` or `receive.unpackLimit` are