Skip to content

Commit 349c8a5

Browse files
chriscoolgitster
authored andcommitted
doc: fetch: document --filter=<filter-spec> option
The `--filter=<filter-spec>` option is documented in most commands that support it except `git fetch`. Let's fix that and document this option. To ensure consistency across commands, let's reuse the exact description currently found in `git clone`. Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
1 parent 618f6e5 commit 349c8a5

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

Documentation/fetch-options.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,16 @@ linkgit:git-config[1].
8888
This is incompatible with `--recurse-submodules=(yes|on-demand)` and takes
8989
precedence over the `fetch.output` config option.
9090

91+
`--filter=<filter-spec>`::
92+
Use the partial clone feature and request that the server sends
93+
a subset of reachable objects according to a given object filter.
94+
When using `--filter`, the supplied _<filter-spec>_ is used for
95+
the partial fetch. For example, `--filter=blob:none` will filter
96+
out all blobs (file contents) until needed by Git. Also,
97+
`--filter=blob:limit=<size>` will filter out all blobs of size
98+
at least _<size>_. For more details on filter specifications, see
99+
the `--filter` option in linkgit:git-rev-list[1].
100+
91101
ifndef::git-pull[]
92102
`--write-fetch-head`::
93103
`--no-write-fetch-head`::

0 commit comments

Comments
 (0)