From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 13 Feb 2026 17:21:30 GMT
Subject: Re: [PATCH v2 5/5] Documentation/git-history: document default for "--update-refs="
Message-ID: <xmqqo6lsmued.fsf@gitster.g>
In-Reply-To: <20260213-b4-pks-history-dry-run-v2-5-756ac376e9e5@pks.im>

Patrick Steinhardt <ps@pks.im> writes:

> While we document the values that can be passed to the "--update-refs="
> option, we don't give the user any hint what the default behaviour is.
> Document it.
>
> Signed-off-by: Patrick Steinhardt <ps@pks.im>
> ---
>  Documentation/git-history.adoc | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/git-history.adoc b/Documentation/git-history.adoc
> index 4dbe665ec4..cc019de697 100644
> --- a/Documentation/git-history.adoc
> +++ b/Documentation/git-history.adoc
> @@ -70,7 +70,7 @@ OPTIONS
>  	Control which references will be updated by the command, if any. With
>  	`branches`, all local branches that point to commits which are
>  	descendants of the original commit will be rewritten. With `head`, only
> -	the current `HEAD` reference will be rewritten.
> +	the current `HEAD` reference will be rewritten. Defaults to `branches`.

Good to see the default clearly described.  Thanks.