Skip to content

Commit 4963d3e

Browse files
rcoupgitster
authored andcommitted
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 <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 7390f05 commit 4963d3e

File tree

2 files changed

+7
-2
lines changed

2 files changed

+7
-2
lines changed

Documentation/config/remote.txt

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,5 +82,7 @@ remote.<name>.promisor::
8282
objects.
8383

8484
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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,9 @@ Fetching Missing Objects
181181
currently fetches all objects referred to by the requested objects, even
182182
though they are not necessary.
183183

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.
184187

185188
Using many promisor remotes
186189
---------------------------

0 commit comments

Comments
 (0)