help merge should explain the difference between a normal merge and a cherrypick

Bug #783992 reported by Matt Giuca
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Bazaar
Fix Released
Low
Matt Giuca

Bug Description

The help page on "merge" currently says that if the base revision is not in the current branch, it will create a "cherrypick", and doesn't explain it. I think the fact that the semantics of the merge result is so different deserves a bit more explanation. I have summarised the section in the Bazaar User's Guide under "Pseudo merging" which explains cherrypicking, and added it to the help text for "merge":

I added the following text:

"Unlike a normal merge, Bazaar does not currently track cherrypicks. The changes look like a normal commit, and the history of the changes from the other branch is not stored in the commit."

The change is available in lp:~mgiuca/bzr/merge-cherrypick-help.

Tags: doc

Related branches

Revision history for this message
Martin Pool (mbp) wrote : Re: [Bug 783992] [NEW] help merge should explain the difference between a normal merge and a cherrypick

Thanks for contributing. When you're ready, please propose your
branch be merged into trunk.

Martin

Revision history for this message
Matt Giuca (mgiuca) wrote :

Done. Sorry, I wasn't sure if I should file a bug or a merge request. For such a minor change, is a bug necessary, or should I just make a branch and merge request?

Revision history for this message
Martin Pool (mbp) wrote : Re: [Bug 783992] Re: help merge should explain the difference between a normal merge and a cherrypick

Just a spontaneous mp is fine, unless

- you identify the problem separately from fixing it
- you want a discussion at the level of agreeing on the problem, not the code
- you expect it to be really long-running work and want it to show up
on your assigned bugs

None of those seem to be the case here.

Martin

Martin Packman (gz)
Changed in bzr:
assignee: nobody → Matt Giuca (mgiuca)
importance: Undecided → Low
milestone: none → 2.4b3
status: New → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.