From: Robert Coup Date: Mon, 28 Mar 2022 14:02:11 +0000 (+0000) Subject: docs: mention --refetch fetch option X-Git-Tag: v2.36.0-rc0~6^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4963d3e41fa454500760fe6f8fb1bab890c1c3eb;p=thirdparty%2Fgit.git docs: mention --refetch fetch option Document it for partial clones as a means to apply a new filter, and reference it from the remote..partialclonefilter config parameter. Signed-off-by: Robert Coup Signed-off-by: Junio C Hamano --- diff --git a/Documentation/config/remote.txt b/Documentation/config/remote.txt index a8e6437a90..0678b4bcfe 100644 --- a/Documentation/config/remote.txt +++ b/Documentation/config/remote.txt @@ -82,5 +82,7 @@ remote..promisor:: objects. remote..partialclonefilter:: - The filter that will be applied when fetching from this - promisor remote. + The filter that will be applied when fetching from this 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]. diff --git a/Documentation/technical/partial-clone.txt b/Documentation/technical/partial-clone.txt index a0dd7c66f2..99f0eb3040 100644 --- a/Documentation/technical/partial-clone.txt +++ b/Documentation/technical/partial-clone.txt @@ -181,6 +181,9 @@ Fetching Missing Objects currently fetches all objects referred to by the requested objects, even 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 ---------------------------