|
Size: 1788
Comment: lowercase links
|
Size: 2475
Comment: add hg parents
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Tutorial - cloning a repository == | == Tutorial - Cloning a repository == ''(This page is part 2 of 9 of the [:Tutorial] series. Previous part is [:TutorialInstall], next part is [:TutorialHistory])'' |
| Line 17: | Line 19: |
| If all goes well, the {{{clone}}} command prints this: | If all goes well, the {{{clone}}} command prints this (Mercurial 1.0): |
| Line 25: | Line 27: |
| updating working directory 2 files updated, 0 files merged, 0 files removed, 0 files unresolved |
|
| Line 45: | Line 49: |
| By default, `hg clone` checks out (see [:Update]) the [:Tip:tip]most [:Revision:revision] of the repository into the repository's [:WorkingDirectory:working directory]. To see which revision is currently checkd out, we can use the [:Parent:parents] command: {{{ $ hg parents changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile }}} |
Tutorial - Cloning a repository
(This page is part 2 of 9 of the [:Tutorial] series. Previous part is [:TutorialInstall], next part is [:TutorialHistory])
You have followed TutorialInstall to install Mercurial already, right? Good!
In Mercurial, we do all of our work inside a [:Repository:repository]. A repository is a directory that contains all of the source files that we want to keep history of, along with complete histories of those source files.
The easiest way to get started with Mercurial is to use a repository that already contains some files and some history.
To do this, we use the clone command. This makes a [:Clone:clone] of a repository; it makes a complete copy of another repository so that we will have our own local, private one to work in.
Let's clone a small "hello, world" repository hosted at selenic.com:
$ hg clone http://www.selenic.com/repo/hello my-hello
If all goes well, the clone command prints this (Mercurial 1.0):
requesting all changes adding changesets adding manifests adding file changes added 2 changesets with 2 changes to 2 files updating working directory 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
We should now find a directory called my-hello in our current directory:
$ ls my-hello
Inside the my-hello directory, we should find some files:
$ ls my-hello Makefile hello.c
These files are exact copies of the files in the repository we just cloned.
Note: in Mercurial, each repository is self-contained. When you clone a repository, the new repository becomes an exact copy of the existing one at the time of the clone, but subsequent changes in either one will not show up in the other unless you explicitly transfer them, by either [:Pull:pulling] or [:Push:pushing].
By default, hg clone checks out (see [:Update]) the [:Tip:tip]most [:Revision:revision] of the repository into the repository's [:WorkingDirectory:working directory]. To see which revision is currently checkd out, we can use the [:Parent:parents] command:
$ hg parents changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
At this point, we can start examining some of the history of our new repository, by continuing to TutorialHistory.