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>

diff --git a/Documentation/config/remote.txt b/Documentation/config/remote.txt
index a8e6437a903592934198fb212ede8241d6acebca..0678b4bcfef7e6150a4661edb1b5cc229dfa9adf 100644 (file)
--- a/Documentation/config/remote.txt
+++ b/Documentation/config/remote.txt
@@ -82,5 +82,7 @@ remote.<name>.promisor::
        objects.
 
 remote.<name>.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 a0dd7c66f247d636c464dac09ba8cfb6dd668de8..99f0eb304061adeb6b9d2b487eb1c2c11d07463b 100644 (file)
--- 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
 ---------------------------