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>
Robert Coup committed
Mar 28, 2022 at 14:02 UTC
4963d3e41fa454500760fe6f8fb1bab890c1c3eb
2 files changed
+7
-2
Documentation/config/remote.txt
+4
-2
@@ -82,5 +82,7 @@ remote.<name>.promisor::
82
objects.
83
84
remote.<name>.partialclonefilter::
85
- The filter that will be applied when fetching from this
86
- promisor remote.
85
+ The filter that will be applied when fetching from this promisor remote.
86
+ Changing or clearing this value will only affect fetches for new commits.
87
+ To fetch associated objects for commits already present in the local object
88
+ database, use the `--refetch` option of linkgit:git-fetch[1].
Documentation/technical/partial-clone.txt
+3
@@ -181,6 +181,9 @@ Fetching Missing Objects
181
currently fetches all objects referred to by the requested objects, even
182
though they are not necessary.
183
184
+- Fetching with `--refetch` will request a complete new filtered packfile from
185
+ the remote, which can be used to change a filter without needing to
186
+ dynamically fetch missing objects.
187
188
Using many promisor remotes
189
---------------------------