docs: clarify the interaction of transfer.hideRefs and namespaces
commit53a66ec37cfd8fc9f9357f201ae16ae3e8795606
authorKim Altintop <kim@eagain.st>
Fri, 13 Aug 2021 06:23:54 +0000 (13 06:23 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 1 Sep 2021 14:54:30 +0000 (1 07:54 -0700)
tree8838bcece1e2d7c1777f7b61aea222cabcbb54b8
parent39551406539e6ea87f89f619f7f0800e887e9b57
docs: clarify the interaction of transfer.hideRefs and namespaces

Expand the section about namespaces in the documentation of
`transfer.hideRefs` to point out the subtle differences between
`upload-pack` and `receive-pack`.

ffcfb68176 (upload-pack.c: treat want-ref relative to namespace,
2021-07-30) taught `upload-pack` to reject `want-ref`s for hidden refs,
which is now mentioned. It is clarified that at no point the name of a
hidden ref is revealed, but the object id it points to may.

Signed-off-by: Kim Altintop <kim@eagain.st>
Reviewed-by: Jonathan Tan <jonathantanmy@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config/transfer.txt