git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: add missing --message long option to merge docs

From
Junio C Hamano <gitster@pobox.com>
Date
May 29, 2026, 05:02 UTC
Message-ID
<xmqqo6hyiz9g.fsf@gitster.g>
In-Reply-To
<pull.2315.git.git.1780019726297.gitgitgadget@gmail.com>
"Brandon Dong via GitGitGadget" <gitgitgadget@gmail.com> writes:
> From: Brandon <brandondong96@gmail.com>

As you identify yourself as "Brandon Dong" on the Signed-off-by line below, please match this in-body From: line with it.

Show 27 quoted lines
> Include mention of --message flag in merge docs to match what is
> accepted (builtin/merge.c) and to make it consistent with the git
> commit docs.
>
> Signed-off-by: Brandon Dong <brandondong96@gmail.com>
> ---
>     doc: add missing --message long option to merge docs
>
> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-2315%2Fbrandondong%2Fmerge_message_docs-v1
> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-2315/brandondong/merge_message_docs-v1
> Pull-Request: https://github.com/git/git/pull/2315
>
>  Documentation/git-merge.adoc | 1 +
>  1 file changed, 1 insertion(+)
>
> diff --git a/Documentation/git-merge.adoc b/Documentation/git-merge.adoc
> index a055384ad6..6581f4c69c 100644
> --- a/Documentation/git-merge.adoc
> +++ b/Documentation/git-merge.adoc
> @@ -68,6 +68,7 @@ OPTIONS
>  include::merge-options.adoc[]
>  
>  `-m <msg>`::
> +`--message=<msg>`::
>  	Set the commit message to be used for the merge commit (in
>  	case one is created).
>  +

Hmph. This is still not consistent with "git merge -h" output has, which seems to accept --[no-]message as well.

It is not exactly your fault, but there are a few options other than this one that support optional [no-] and they are not documented as such, even though they appear in "git merge -h". "git merge -m foo --no-message other" behaves as if "GIT_EDITOR=: git merge other" was run, it seems.

Previous: Brandon Dong via GitGitGadgetNext: Brandon
Message 2 of 3 in “doc: add missing --message long option to merge docs”
  1. doc: add missing --message long option to merge docsBrandon Dong via GitGitGadget, May 29, 2026
  2. Junio C HamanoMay 29, 2026
  3. BrandonMay 31, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.