Chris@494: <link rel="stylesheet" type="text/css" href="help.css"/>
Chris@494: 
Chris@494: 
Chris@494: <h2>Someone gave me a repository URL and asked me to clone it</h2>
Chris@494: 
Chris@494: <p>A Mercurial repository location is usually described by a URL, like
Chris@494: that of a website.</p>
Chris@494: 
Chris@494: <p>For example, the URL for the repository containing the source code for
Chris@494: EasyMercurial itself is <code>https://bitbucket.org/cannam/easyhg</code>.</p>
Chris@494: 
Chris@494: <p>To get a copy of the files in a repository, you need to <i>clone</i> the
Chris@494: repository from the remote URL into a folder on your own computer.  To
Chris@494: do this,</p>
Chris@494: 
Chris@495: <p><b>1. Click the Open toolbar button or use File -> Open</b></p>
Chris@494: 
Chris@494: <p><center><img src="images/openremote50.png"></center></p>
Chris@494: 
Chris@495: <p><b>2. Select &ldquo;Remote repository&rdquo; as the thing you want to open</b></p>
Chris@494: 
Chris@495: <p><b>3. Enter the repository URL into the URL field</b></p>
Chris@494: 
Chris@495: <p><b>4. Give the name of a folder on your local computer to clone into</b> &ndash;
Chris@494:  this folder will be created for you, so it shouldn't be one that already
Chris@494:  exists</p>
Chris@494: 
Chris@495: <p><b>5. Click OK</b></p>
Chris@494: 
Chris@494: <p>If the remote repository has restricted access, you may be asked to
Chris@494: provide a username and password to log in to the server it is hosted
Chris@494: on.  If the repository is large, you may have to wait a while for all the
Chris@494: data to be transferred.</p>
Chris@494: 
Chris@494: <p>Provided the clone has been successful, you should now have a local
Chris@495: repository to start working in.
Chris@495: <ul><li>Note: the equivalent Mercurial command for this is <b>hg clone</b></li></ul>