annotate help/a-10.html @ 571:012ba1b83328

Show cancel button with progress bar only when running an operation that it makes sense to cancel (we don't really want people cancelling e.g. initial folder scan because it would leave things in an inconsistent state)
author Chris Cannam
date Thu, 01 Mar 2012 22:53:54 +0000
parents 21aa41b62c3a
children
rev   line source
Chris@494 1 <link rel="stylesheet" type="text/css" href="help.css"/>
Chris@494 2
Chris@494 3
Chris@494 4 <h2>Someone gave me a repository URL and asked me to clone it</h2>
Chris@494 5
Chris@494 6 <p>A Mercurial repository location is usually described by a URL, like
Chris@494 7 that of a website.</p>
Chris@494 8
Chris@494 9 <p>For example, the URL for the repository containing the source code for
Chris@494 10 EasyMercurial itself is <code>https://bitbucket.org/cannam/easyhg</code>.</p>
Chris@494 11
Chris@494 12 <p>To get a copy of the files in a repository, you need to <i>clone</i> the
Chris@494 13 repository from the remote URL into a folder on your own computer. To
Chris@494 14 do this,</p>
Chris@494 15
Chris@495 16 <p><b>1. Click the Open toolbar button or use File -> Open</b></p>
Chris@494 17
Chris@494 18 <p><center><img src="images/openremote50.png"></center></p>
Chris@494 19
Chris@495 20 <p><b>2. Select &ldquo;Remote repository&rdquo; as the thing you want to open</b></p>
Chris@494 21
Chris@495 22 <p><b>3. Enter the repository URL into the URL field</b></p>
Chris@494 23
Chris@495 24 <p><b>4. Give the name of a folder on your local computer to clone into</b> &ndash;
Chris@494 25 this folder will be created for you, so it shouldn't be one that already
Chris@494 26 exists</p>
Chris@494 27
Chris@495 28 <p><b>5. Click OK</b></p>
Chris@494 29
Chris@494 30 <p>If the remote repository has restricted access, you may be asked to
Chris@494 31 provide a username and password to log in to the server it is hosted
Chris@494 32 on. If the repository is large, you may have to wait a while for all the
Chris@494 33 data to be transferred.</p>
Chris@494 34
Chris@494 35 <p>Provided the clone has been successful, you should now have a local
Chris@495 36 repository to start working in.
Chris@495 37 <ul><li>Note: the equivalent Mercurial command for this is <b>hg clone</b></li></ul>