aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRobert Coup <robert@coup.net.nz>2022-03-28 14:02:11 +0000
committerJunio C Hamano <gitster@pobox.com>2022-03-28 10:25:53 -0700
commit4963d3e41fa454500760fe6f8fb1bab890c1c3eb (patch)
treee214d8791369113cb8d054d2bf62153fbe3258e4
parentfetch: after refetch, encourage auto gc repacking (diff)
downloadgit-4963d3e41fa454500760fe6f8fb1bab890c1c3eb.tar.gz
git-4963d3e41fa454500760fe6f8fb1bab890c1c3eb.zip
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>
-rw-r--r--Documentation/config/remote.txt6
-rw-r--r--Documentation/technical/partial-clone.txt3
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.<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 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
---------------------------