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 &ldquo;rival&rdquo; 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 &ndash; 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 &ldquo;win&rdquo;. (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 &ndash; 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