doc: explain fetchRemoteHEADWarn advice

When the user sets 'remote.<name>.followRemoteHEAD' to
'warn[-if-not-$branch]', git-fetch will report when a fetched HEAD
disagrees with the locally-configured remote's HEAD.  This additional
advice instructs the user how to deal with these warnings, but was
previously undocumented in git-config.

Signed-off-by: Matt Hunter <m@lfurio.us>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Matt Hunter
2026-06-19 05:44:21 -04:00
committed by Junio C Hamano
parent 3e09c9e820
commit 54c9d48101

View File

@@ -48,6 +48,10 @@ all advice messages.
to create a local branch after the fact.
diverging::
Shown when a fast-forward is not possible.
fetchRemoteHEADWarn::
Shown when linkgit:git-fetch[1] reveals that a remote `HEAD`
differs from what is set locally and the user has opted into
receiving a warning in this situation.
fetchShowForcedUpdates::
Shown when linkgit:git-fetch[1] takes a long time
to calculate forced updates after ref updates, or to warn