diff options
author | Derrick Stolee <derrickstolee@github.com> | 2022-03-09 16:01:39 (GMT) |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2022-03-09 18:25:27 (GMT) |
commit | 105c6f14ad34b417c1e78bc9a8704dcda7b059f2 (patch) | |
tree | 2030b64814e8aab14dd6cd6787ad95f3e18a0294 /Documentation/git-bundle.txt | |
parent | 4f33a6345f2bd6e47253d1dbefd01874d895ab2e (diff) | |
download | git-105c6f14ad34b417c1e78bc9a8704dcda7b059f2.zip git-105c6f14ad34b417c1e78bc9a8704dcda7b059f2.tar.gz git-105c6f14ad34b417c1e78bc9a8704dcda7b059f2.tar.bz2 |
bundle: parse filter capability
The v3 bundle format has capabilities, allowing newer versions of Git to
create bundles with newer features. Older versions that do not
understand these new capabilities will fail with a helpful warning.
Create a new capability allowing Git to understand that the contained
pack-file is filtered according to some object filter. Typically, this
filter will be "blob:none" for a blobless partial clone.
This change teaches Git to parse this capability, place its value in the
bundle header, and demonstrate this understanding by adding a message to
'git bundle verify'.
Since we will use gently_parse_list_objects_filter() outside of
list-objects-filter-options.c, make it an external method and move its
API documentation to before its declaration.
Signed-off-by: Derrick Stolee <derrickstolee@github.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-bundle.txt')
-rw-r--r-- | Documentation/git-bundle.txt | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 72ab813..ac4c435 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -75,8 +75,11 @@ verify <file>:: cleanly to the current repository. This includes checks on the bundle format itself as well as checking that the prerequisite commits exist and are fully linked in the current repository. - 'git bundle' prints a list of missing commits, if any, and exits - with a non-zero status. + Information about additional capabilities, such as "object filter", + is printed. See "Capabilities" in link:technical/bundle-format.html + for more information. Finally, 'git bundle' prints a list of + missing commits, if any. The exit code is zero for success, but + will be nonzero if the bundle file is invalid. list-heads <file>:: Lists the references defined in the bundle. If followed by a |