From 4963d3e41fa454500760fe6f8fb1bab890c1c3eb Mon Sep 17 00:00:00 2001 From: Robert Coup Date: Mon, 28 Mar 2022 14:02:11 +0000 Subject: [PATCH] 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 --- Documentation/config/remote.txt | 6 ++++-- Documentation/technical/partial-clone.txt | 3 +++ 2 files changed, 7 insertions(+), 2 deletions(-) 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 ---------------------------