[PATCH 3/3] doc: gitprotocol-v2: send the promisor-remote reply with fetch
- From
Christian Couder <christian.couder@gmail.com>
- Date
- Nov 12, 2026, 19:59 UTC
- Message-ID
- <20261112195858.53788-8-christian.couder@gmail.com>
- In-Reply-To
- <20261112195858.53788-5-christian.couder@gmail.com>
Until a previous commit, a client sent its `promisor-remote=...` reply only with the `ls-refs` and `bundle-uri` protocol commands.
Let's clearly document that the client should send that reply with the `fetch` command request too.
Reported-by: Matt Cote <mcote@nvidia.com> Signed-off-by: Christian Couder <christian.couder@gmail.com> --- Documentation/gitprotocol-v2.adoc | 6 ++++++ 1 file changed, 6 insertions(+)
diff --git a/Documentation/gitprotocol-v2.adoc b/Documentation/gitprotocol-v2.adoc index dd52fd8110..b8732173cd 100644 --- a/Documentation/gitprotocol-v2.adoc +++ b/Documentation/gitprotocol-v2.adoc @@ -879,6 +879,12 @@ In this case, or if the client doesn't want to use any promisor remote the server advertised, the client shouldn't advertise the "promisor-remote" capability at all in its reply. +As protocol v2 is stateless (see the "Capabilities" section above), +the client should send this reply with the `fetch` command request, +even if it has already sent it with an earlier command request, like +`ls-refs`. Note that when only some object IDs are fetched, the client +might not send any `ls-refs` command request at all. + On the server side, the "promisor.advertise" and "promisor.sendFields" configuration options can be used to control what it advertises. On the client side, the "promisor.acceptFromServer" and
-- 2.56.0