Skip to contentSkip to conversation

Understanding git.git's branch policy

DISCUSSION Steven E. Harris 2 participants 2 messages Jun 15, 2016

lore
Share & tools
lore
#0 lore raw

Radding the maintain-git.txt document¹, there are a few points that I'm having trouble decoding. Under "The Policy", it notes

,----

| The tips of 'master', 'maint' and 'next' branches will always
| fast-forward, to allow people to build their own customization on top
| of them.

`----

I understand that a "fast-forward merge" means that one's current HEAD commit is an ancestor of the evolved branch's head, so that the HEAD pointer can move forward to "catch up" without needing to combine disparate content.

How does this relate to the prescribed use of the "master", "maint", and "next" branches? What operations or patterns does it constrain against?

Footnotes:
¹ http://kernel.org/pub/software/scm/git/docs/howto/maintain-git.txt

Signature · 1 line
Steven E. Harris
#1 lore raw
Quoted 9 lines · Steven E. Harris

Radding the maintain-git.txt document¹, there are a few points that I'm having trouble decoding. Under "The Policy", it notes

,----

| The tips of 'master', 'maint' and 'next' branches will always
| fast-forward, to allow people to build their own customization on top
| of them.

`----

Quoted 7 lines

I understand that a "fast-forward merge" means that one's current HEAD commit is an ancestor of the evolved branch's head, so that the HEAD pointer can move forward to "catch up" without needing to combine disparate content.

How does this relate to the prescribed use of the "master", "maint", and "next" branches? What operations or patterns does it constrain against?

Rebases or other jumps. New tip of 'master' will always be descendant of old tip of 'master', never a commit from a parallel commit line. This is preserved over commits and merges, but not over operations that rewrite history - rebase, filter-branch and such.

The term "fast-forward" is used commonly in this sense. E.g. git push will typically deny you to push out a branch that is not fastforwarding the currently pushed out branch, unless you force it to.

Signature · 3 lines
				Petr "Pasky" Baudis
A lot of people have my books on their bookshelves.
That's the problem, they need to read them. -- Don Knuth