annotate help/a-10.html @ 511:f1fe20ff3c07

Refactor: set closed branch statuses before creating items
author Chris Cannam
date Tue, 18 Oct 2011 11:33:58 +0100
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>