diff help/topics/10.txt @ 525:721a8e30822b

Merge
author Chris Cannam
date Thu, 17 Nov 2011 17:12:39 +0000
parents e6141a238811
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/help/topics/10.txt	Thu Nov 17 17:12:39 2011 +0000
@@ -0,0 +1,37 @@
+{Opening and initialising things}
+
+Someone gave me a repository URL and asked me to clone it
+
+A Mercurial repository location is usually described by a URL, like
+that of a website.
+
+For example, the URL for the repository containing the source code for
+EasyMercurial itself is @https://bitbucket.org/cannam/easyhg@.
+
+To get a copy of the files in a repository, you need to _clone_ the
+repository from the remote URL into a folder on your own computer.  To
+do this,
+
+*1. Click the Open toolbar button or use File -> Open*
+
+#openremote50
+
+*2. Select "Remote repository" as the thing you want to open*
+
+*3. Enter the repository URL into the URL field*
+
+*4. Give the name of a folder on your local computer to clone into* --
+ this folder will be created for you, so it shouldn't be one that already
+ exists
+
+*5. Click OK*
+
+If the remote repository has restricted access, you may be asked to
+provide a username and password to log in to the server it is hosted
+on.  If the repository is large, you may have to wait a while for all the
+data to be transferred.
+
+Provided the clone has been successful, you should now have a local
+repository to start working in.
+
+ * Note: the equivalent Mercurial command for this is *hg clone*