diff options
author | Jonathan Tan <jonathantanmy@google.com> | 2021-01-20 22:36:57 +0300 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2021-01-21 06:06:50 +0300 |
commit | bfc2a36ff2a705223aed3952130f5b6cbffdbfe1 (patch) | |
tree | 30da3812ca3c1a1e2139c7400424cb72e41b220c | |
parent | 71ca53e8125e36efbda17293c50027d31681a41f (diff) |
Doc: clarify contents of packfile sent as URI
Clarify that, when the packfile-uri feature is used, the client should
not assume that the extra packfiles downloaded would only contain a
single blob, but support packfiles containing multiple objects of all
types.
Signed-off-by: Jonathan Tan <jonathantanmy@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r-- | Documentation/technical/packfile-uri.txt | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/technical/packfile-uri.txt b/Documentation/technical/packfile-uri.txt index 318713abc3..f7eabc6c76 100644 --- a/Documentation/technical/packfile-uri.txt +++ b/Documentation/technical/packfile-uri.txt @@ -37,8 +37,11 @@ at least so that we can test the client. This is the implementation: a feature, marked experimental, that allows the server to be configured by one or more `uploadpack.blobPackfileUri=<sha1> <uri>` entries. Whenever the list of objects to be sent is assembled, all such -blobs are excluded, replaced with URIs. The client will download those URIs, -expecting them to each point to packfiles containing single blobs. +blobs are excluded, replaced with URIs. As noted in "Future work" below, the +server can evolve in the future to support excluding other objects (or other +implementations of servers could be made that support excluding other objects) +without needing a protocol change, so clients should not expect that packfiles +downloaded in this way only contain single blobs. Client design ------------- |