docs: mention --refetch fetch option

Document it for partial clones as a means to apply a new filter, and
reference it from the remote.<name>.partialclonefilter config parameter.

Signed-off-by: Robert Coup <robert@coup.net.nz>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Robert Coup
2022-03-28 14:02:11 +00:00
committed by Junio C Hamano
parent 7390f05a3c
commit 4963d3e41f
2 changed files with 7 additions and 2 deletions

View File

@ -82,5 +82,7 @@ remote.<name>.promisor::
objects. objects.
remote.<name>.partialclonefilter:: remote.<name>.partialclonefilter::
The filter that will be applied when fetching from this The filter that will be applied when fetching from this promisor remote.
promisor remote. Changing or clearing this value will only affect fetches for new commits.
To fetch associated objects for commits already present in the local object
database, use the `--refetch` option of linkgit:git-fetch[1].

View File

@ -181,6 +181,9 @@ Fetching Missing Objects
currently fetches all objects referred to by the requested objects, even currently fetches all objects referred to by the requested objects, even
though they are not necessary. though they are not necessary.
- Fetching with `--refetch` will request a complete new filtered packfile from
the remote, which can be used to change a filter without needing to
dynamically fetch missing objects.
Using many promisor remotes Using many promisor remotes
--------------------------- ---------------------------