annotate help/a-33.html @ 499:b3309be1640f

More help. This I think will do for 1.0.
author Chris Cannam
date Mon, 22 Aug 2011 21:31:55 +0100
parents
children 2d59eda59895
rev   line source
Chris@499 1 <link rel="stylesheet" type="text/css" href="help.css"/>
Chris@499 2
Chris@499 3
Chris@499 4 <h2>I tried to push my changes, but it told me &ldquo;the remote repository may have been changed by someone else&rdquo; and refused</h2>
Chris@499 5
Chris@499 6 <p>This error indicates that the remote repository has some changes in it
Chris@499 7 that you do not have in your local repository (and that are in
Chris@499 8 branches that you have also changed). Perhaps someone else made these
Chris@499 9 changes and pushed them, or they may have come from you pushing from a
Chris@499 10 different computer.</p>
Chris@499 11
Chris@499 12 <p>A good principle is that you should review and test your changes
Chris@499 13 before you push them to another repository. Although (with a
Chris@499 14 distributed version control system) it's generally OK to commit
Chris@499 15 changes locally that don't really work or that aren't complete enough
Chris@499 16 to test, it's a bad idea to push anything that would cause the remote
Chris@499 17 repository to have an untested set of changes in it.</p>
Chris@499 18
Chris@499 19 <p>For that reason, if you change some files and someone else changes
Chris@499 20 others and you both push them without knowing about the other one,
Chris@499 21 Mercurial must refuse whichever push happens later &ndash; it won't simply
Chris@499 22 merge the changes because the result might not make any sense.</p>
Chris@499 23
Chris@499 24 <p>Instead you must pull the other person's changes and merge them
Chris@499 25 locally before you push. Fortunately, this is easy to do.</p>
Chris@499 26
Chris@499 27 <p><b>1. Click Pull on the main toolbar at the top of the EasyMercurial window.</b>
Chris@499 28 <ul><li>You should see that some changes are pulled and added to your local repository. This will usually lead to a forked graph in the History pane, as your changes and the other user's were both started from the same parent at the same time.</li></ul></p>
Chris@499 29
Chris@499 30 <p><b>2. Click Merge in the toolbar on the left.</b>
Chris@499 31 <ul><li>Any changes that affect different files, or that affect different parts of the same file, will be merged automatically. For changes that affect the same parts of the same file, you will be asked to choose which change to include in the merged copy.</li></ul></p>
Chris@499 32
Chris@499 33 <p><b>3. Review or test the resulting merged version in your local working folder.</b></p>
Chris@499 34
Chris@499 35 <p><b>4. Commit the merged version.</b></p>
Chris@499 36
Chris@499 37 <p><b>5. Push again to the remote repository.</b></p>
Chris@499 38