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 |