Merge branch 'jt/doc-rev-list-filter-provided-objects'

gitster · gitster · commit b1792f511636 · 2025-12-30T12:58:19.000+09:00
Document "rev-list --filter-provided-objects" better.

* jt/doc-rev-list-filter-provided-objects:
  docs: clarify git-rev-list(1) --filter behavior
diff --git 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>_

Original file line number	Diff line number	Diff line change
@@ -983,7 +983,9 @@ to name units in KiB, MiB, or GiB. For example, `blob:limit=1k`
`983`	`983`	`is the same as 'blob:limit=1024'.`
`984`	`984`	`+`
`985`	`985`	The form `--filter=object:type=(tag\|commit\|tree\|blob)` omits all objects
`986`		`-which are not of the requested type.`
	`986`	`+which are not of the requested type. Note that explicitly provided objects`
	`987`	+ignore filters and are always printed unless `--filter-provided-objects` is
	`988`	`+also specified.`
`987`	`989`	`+`
`988`	`990`	The form `--filter=sparse:oid=<blob-ish>` uses a sparse-checkout
`989`	`991`	`specification contained in the blob (or blob-expression) _<blob-ish>_`