diff options
| author | Junio C Hamano <gitster@pobox.com> | 2025-12-30 12:58:19 +0900 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2025-12-30 12:58:19 +0900 |
| commit | b1792f51163670897814a2f3400e77fea8ac917c (patch) | |
| tree | 294d6d34fb9a3f3faa83592d37291c94d55a20cd | |
| parent | 02e9bc33921bbb070c49aa1aff48ae4317537d83 (diff) | |
| parent | 6d8dc99478adeefc1a74f3b4db9336decadddc48 (diff) | |
| download | git-b1792f51163670897814a2f3400e77fea8ac917c.tar.xz | |
Merge branch 'jt/doc-rev-list-filter-provided-objects'
Document "rev-list --filter-provided-objects" better.
* jt/doc-rev-list-filter-provided-objects:
docs: clarify git-rev-list(1) --filter behavior
| -rw-r--r-- | Documentation/rev-list-options.adoc | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/Documentation/rev-list-options.adoc b/Documentation/rev-list-options.adoc index d9665d82c8..453ec59057 100644 --- a/Documentation/rev-list-options.adoc +++ b/Documentation/rev-list-options.adoc @@ -983,7 +983,9 @@ to name units in KiB, MiB, or GiB. For example, `blob:limit=1k` is the same as 'blob:limit=1024'. + The form `--filter=object:type=(tag|commit|tree|blob)` omits all objects -which are not of the requested type. +which are not of the requested type. Note that explicitly provided objects +ignore filters and are always printed unless `--filter-provided-objects` is +also specified. + The form `--filter=sparse:oid=<blob-ish>` uses a sparse-checkout specification contained in the blob (or blob-expression) _<blob-ish>_ |