[RFC PATCH 1/7] pack-objects: update `--path-walk`'s existing incompatibilities
- From
Taylor Blau <me@ttaylorr.com>
- Date
- May 4, 2026, 00:11 UTC
- Message-ID
- <babe1596161365209c226d374db70a1bdc284a1c.1777853408.git.me@ttaylorr.com>
- In-Reply-To
- <cover.1777853408.git.me@ttaylorr.com>
The documentation in git-pack-objects(1) claims that `--path-walk` is incompatible with `-shallow`. However, commit c178b02e29f (pack-objects: allow --shallow and --path-walk, 2025-05-16) resolves this incompatibility, leaving the documentation stale.
Likewise, this documentation claims that `--filter` is incompatible, but `blob:none`, `blob:limit=<n>`, and `sparse:oid=<blob>` already work via path-walk.
List the supported `--filter` forms explicitly and note that other forms fall back to the regular object traversal. Also remove the incompatibility notice with `--shallow`.
Signed-off-by: Taylor Blau <me@ttaylorr.com> --- Documentation/git-pack-objects.adoc | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-pack-objects.adoc b/Documentation/git-pack-objects.adoc index b78175fbe1b..8dea8259787 100644 --- a/Documentation/git-pack-objects.adoc +++ b/Documentation/git-pack-objects.adoc @@ -402,9 +402,11 @@ will be automatically changed to version `1`. of filenames that cause collisions in Git's default name-hash algorithm. + -Incompatible with `--delta-islands`, `--shallow`, or `--filter`. The -`--use-bitmap-index` option will be ignored in the presence of -`--path-walk.` +Incompatible with `--delta-islands`. Path-walk supports the +`--filter=<spec>` forms `blob:none`, `blob:limit=<n>`, and +`sparse:oid=<blob>`. Other filter forms fall back to the regular object +traversal. The `--use-bitmap-index` option will be ignored in the +presence of `--path-walk`. DELTA ISLANDS
-- 2.54.0.4.g6aa0d38a4ec