annotate help/a-34.html @ 557:57a7f95ef400 find

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