From: Taylor Blau Date: Mon, 04 May 2026 00:11:17 GMT Subject: [RFC PATCH 1/7] pack-objects: update `--path-walk`'s existing incompatibilities Message-ID: In-Reply-To: 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=`, and `sparse:oid=` 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 --- 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=` forms `blob:none`, `blob:limit=`, and +`sparse:oid=`. 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