[PATCH 5/9] doc: fetch: document `--filter=<filter-spec>` option
- From
Christian Couder <christian.couder@gmail.com>
- Date
- Dec 23, 2025, 11:11 UTC
- Message-ID
- <20251223111113.47473-6-christian.couder@gmail.com>
- In-Reply-To
- <20251223111113.47473-1-christian.couder@gmail.com>
The `--filter=<filter-spec>` option is documented in most commands that support it except `git fetch`.
Let's fix that and document that option properly in the same way as it is already documented for `git clone`.
Signed-off-by: Christian Couder <chriscool@tuxfamily.org> --- Documentation/fetch-options.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+)
diff --git a/Documentation/fetch-options.adoc b/Documentation/fetch-options.adoc index fcba46ee9e..70a9818331 100644 --- a/Documentation/fetch-options.adoc +++ b/Documentation/fetch-options.adoc @@ -88,6 +88,16 @@ linkgit:git-config[1]. This is incompatible with `--recurse-submodules=(yes|on-demand)` and takes precedence over the `fetch.output` config option. +--filter=<filter-spec>:: + Use the partial clone feature and request that the server sends + a subset of reachable objects according to a given object filter. + When using `--filter`, the supplied _<filter-spec>_ is used for + the partial fetch. For example, `--filter=blob:none` will filter + out all blobs (file contents) until needed by Git. Also, + `--filter=blob:limit=<size>` will filter out all blobs of size + at least _<size>_. For more details on filter specifications, see + the `--filter` option in linkgit:git-rev-list[1]. + ifndef::git-pull[] `--write-fetch-head`:: `--no-write-fetch-head`::
-- 2.52.0.319.gfcaffa7898