annotate help/a-10.html @ 495:e6141a238811

A bit more Help
author Chris Cannam
date Thu, 18 Aug 2011 17:13:04 +0100
parents 41a156d439d0
children 21aa41b62c3a
rev   line source
Chris@494 1 <link rel="stylesheet" type="text/css" href="help.css"/>
Chris@494 2 <p><a href="topics.html">Back to Topics</a></p><hr>
Chris@494 3
Chris@494 4
Chris@494 5 <h2>Someone gave me a repository URL and asked me to clone it</h2>
Chris@494 6
Chris@494 7 <p>A Mercurial repository location is usually described by a URL, like
Chris@494 8 that of a website.</p>
Chris@494 9
Chris@494 10 <p>For example, the URL for the repository containing the source code for
Chris@494 11 EasyMercurial itself is <code>https://bitbucket.org/cannam/easyhg</code>.</p>
Chris@494 12
Chris@494 13 <p>To get a copy of the files in a repository, you need to <i>clone</i> the
Chris@494 14 repository from the remote URL into a folder on your own computer. To
Chris@494 15 do this,</p>
Chris@494 16
Chris@495 17 <p><b>1. Click the Open toolbar button or use File -> Open</b></p>
Chris@494 18
Chris@494 19 <p><center><img src="images/openremote50.png"></center></p>
Chris@494 20
Chris@495 21 <p><b>2. Select &ldquo;Remote repository&rdquo; as the thing you want to open</b></p>
Chris@494 22
Chris@495 23 <p><b>3. Enter the repository URL into the URL field</b></p>
Chris@494 24
Chris@495 25 <p><b>4. Give the name of a folder on your local computer to clone into</b> &ndash;
Chris@494 26 this folder will be created for you, so it shouldn't be one that already
Chris@494 27 exists</p>
Chris@494 28
Chris@495 29 <p><b>5. Click OK</b></p>
Chris@494 30
Chris@494 31 <p>If the remote repository has restricted access, you may be asked to
Chris@494 32 provide a username and password to log in to the server it is hosted
Chris@494 33 on. If the repository is large, you may have to wait a while for all the
Chris@494 34 data to be transferred.</p>
Chris@494 35
Chris@494 36 <p>Provided the clone has been successful, you should now have a local
Chris@495 37 repository to start working in.
Chris@495 38 <ul><li>Note: the equivalent Mercurial command for this is <b>hg clone</b></li></ul>
Chris@494 39 <hr><p><a href="topics.html">Back to Topics</a></p>