Will re-basing support be added into Bazaar core ?

Ian Clatworthy ian.clatworthy at internode.on.net
Mon Apr 20 12:18:53 BST 2009


David Timothy Strauss wrote:
> ----- "Russel Winder" <russel.winder at concertant.com> wrote:
> 
>> Perhaps this is where things get interesting.  I want to be able to
>> push to the mainline from the feature branch.  If I have to prepare a
>> patch then hasn't failure of the DVCS to give me the tools I need occurred?
> 
> You do not have to prepare a patch to merge into the mainline. You simply perform a standard merge. I think there's still confusion here, so I'll clarify.
> 
> It seems that people are using rebase to achieve two goals:
> (a) Keep a feature branch ready to merge into the mainline without conflicts.
> (b) Allow easy human evaluation of changes the feature branch will make if merged into the mainline.
> 
> For (a), I'm arguing one should periodically merge from the mainline into the feature branch. For (b), I'm arguing one should use "bzr diff --old=[mainline]" or "bzr send" to render the changes in a unified, overall "here's what this feature branch does to the mainline" sort of way.
> 
> When it's time to merge the feature into the mainline, the mainline maintainer either merges from the feature branch directly or merges using a merge directive prepared from the feature branch. (These two workflows create identical results in Bazaar, but I'm mentioning them for completeness.) Both options pull the full feature branch history into the mainline for later inspection.
> 
> The most streamlined workflow for the above in Bazaar is to use merge directives (created using "bzr send"). A merge directive simultaneously provides a human-readable summary of what merging the feature branch will do to the mainline *and* all the actual revision data from the feature branch in binary form to actually perform the merge into the mainline.

David,

I'd like to see our documentation extended to explain this. Would you
consider putting a patch up based on the above text? Rebasing is
mentioned in section 7.2.4 so extending that is one option. Another
is to put your explanation in an appendix and reference it from there.

I'd also love to see a section added to the User Guide explaining
the looms plugin. Section 8.3 say. Again, a description of when
using them is the right tradeoff would be great.

I think this has been a valuable email thread. But extending the
documentation scales better than referring every new user to a
long email thread. :-) I'd encourage everyone to think about putting
up patches that distil the essence of worthwhile threads like this.

Ian C.



More information about the bazaar mailing list