threads / discuss / 6576

How to enhance merge commit message ?

Subject: How to enhance merge commit message ?

## tl;dr

3 messages between Jan 30, 2007 and Jan 30, 2007.

replies: 2people: 2as markdown or json

Alexander Litvinov· Jan 30, 2007, 04:32 UTC · lore
Hello list,

git's git repo contains a lot of merges with nice commit message, like this (d96497b8d):

Merge branches 'jc/merge-base', 'sp/merge', 'jc/diff', 'jc/explain', 'jc/web' 
and 'jc/pickaxe' into pu
    
    * jc/merge-base:
      Teach "git-merge-base --check-ancestry" about refs.
      git-merge-base: --check-ancestry option
    
    * sp/merge:
      Avoid git-fetch in `git-pull .` when possible.
    
    * jc/diff:
      test-para: combined diff between HEAD, index and working tree.
      para-walk: walk n trees, index and working tree in parallel
    
    * jc/explain:
      git-explain
....
How can I made the same messages using git pull . <branch> ?
Junio C Hamano· Jan 30, 2007, 04:45 UTC · re: Alexander Litvinov · lore

Re: How to enhance merge commit message ?

Alexander Litvinov <litvinov2004@gmail.com> writes:
> git's git repo contains a lot of merges with nice commit message, 
> like this (d96497b8d):
> ....
> How can I made the same messages using git pull . <branch> ?
$ grep -A2 '^merge\.summary' Documentation/config.txt
merge.summary::
	Whether to include summaries of merged commits in newly created
	merge commit messages. False by default.

This is a good option if you are doing the top-level "bundling of others' work -- people will base their further work on this" merges. On the other hand, if you are merging from your uplevel because your work depends on something that was updated recently, having the merge summary is often pointless (because the merge would bring in many mostly unrelated commits, in addition to that something your work depends on). I think Linus has explicitly asked this option not enabled by people he pulls from for this reason.

We might want to have a per-branch option to control this behaviour at finer grained level. I would enable it for my four primary integration branches (maint, master, next, and pu) but not for topic branches. That way, if a topic needs a fix that happened on the master since it forked, the tip of the master will be merged back to the topic without the merge summary message (I would describe why that merge in an unusual direction was needed in the commit message anyway).

Alexander Litvinov· Jan 30, 2007, 05:23 UTC · re: Junio C Hamano · lore

Re: How to enhance merge commit message ?

В сообщении от Tuesday 30 January 2007 10:45 Junio C Hamano написал(a):
> $ grep -A2 '^merge\.summary' Documentation/config.txt
> merge.summary::
> 	Whether to include summaries of merged commits in newly created
> 	merge commit messages. False by default.
Thanks !
Show 9 quoted lines
> This is a good option if you are doing the top-level "bundling
> of others' work -- people will base their further work on this"
> merges.  On the other hand, if you are merging from your uplevel
> because your work depends on something that was updated recently,
> having the merge summary is often pointless (because the merge
> would bring in many mostly unrelated commits, in addition to that
> something your work depends on).  I think Linus has explicitly
> asked this option not enabled by people he pulls from for this
> reason.
I understand your point.

← back to recent threads