Mercurial > hg > easyhg
comparison help/a-35.html @ 578:2c106ea908b5
Add Help topic for remembering password; update CHANGELOG
| author | Chris Cannam |
|---|---|
| date | Wed, 07 Mar 2012 14:23:56 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 576:cc62862d21a4 | 578:2c106ea908b5 |
|---|---|
| 1 <link rel="stylesheet" type="text/css" href="help.css"/> | |
| 2 | |
| 3 | |
| 4 <h2>How do I use the Merge window?</h2> | |
| 5 | |
| 6 <p>If you are working with other people on a project, it is likely that | |
| 7 at some point you'll find that more than one of you have edited the | |
| 8 same lines in the same file, in different ways.</p> | |
| 9 | |
| 10 <p>When that happens and you try to merge the two versions, EasyMercurial | |
| 11 will pop up a merge window that looks a bit like this.</p> | |
| 12 | |
| 13 <p><center><img src="images/merge50.png"></center></p> | |
| 14 | |
| 15 <p>(This is actually a separate program, not part of EasyMercurial: it's | |
| 16 a merge tool called kdiff3.)</p> | |
| 17 | |
| 18 <p>This looks a bit complicated, but it is there to help you pick which | |
| 19 of the changes from each of the two “rival” versions of the file you | |
| 20 want to use in your merged version.</p> | |
| 21 | |
| 22 <p> <b>The top middle one is <i>your current version</i>.</b> That's | |
| 23 the one you had before you decided to merge the other version into | |
| 24 it.</p> | |
| 25 | |
| 26 <p> <b>At top right is <i>the version you're merging</i>.</b> That's the other | |
| 27 rival version – the one that the other person can see in their copy | |
| 28 of the repository.</p> | |
| 29 | |
| 30 <p> <b>At top left is <i>the common ancestor</i>.</b> That's the version that both | |
| 31 of you had, before you started editing it in different ways.</p> | |
| 32 | |
| 33 <p> <b>At the bottom is the output.</b></p> | |
| 34 | |
| 35 <p>Each <i>conflict</i> (a line which you have both changed in different ways) | |
| 36 is shown with <b>Merge Conflict</b> in the output at the bottom. To sort | |
| 37 out the conflicts and get the right output, you need to go through | |
| 38 them one by one, for each one pressing the A, B, or C button to say | |
| 39 whether for this line you want the top-left, top-middle, or top-right | |
| 40 version to “win”. (You can choose more than one, if you want both | |
| 41 versions of a line to appear.)</p> | |
| 42 | |
| 43 <p>Then having resolved a conflict, press the three-arrows-down toolbar | |
| 44 button to go to the next one – and when you've done them all, save | |
| 45 and exit.</p> | |
| 46 | |
| 47 <p>The most important thing to remember is that <i>whatever appears in the | |
| 48 bottom pane is what you'll get as a result</i>.</p> | |
| 49 | |
| 50 <p>No matter how confusing the process, just remember that if it looks | |
| 51 correct in the bottom pane, it will be correct when you save and | |
| 52 exit. You can even edit the file directly in the bottom pane if you | |
| 53 aren't happy with the way the merge is going.</p> | |
| 54 | |
| 55 | |
| 56 | |
| 57 |
