Mercurial > hg
comparison mercurial/help/subrepos.txt @ 15213:15f15f3b405d
subrepo: add git to the help topic
author | Matt Mackall <mpm@selenic.com> |
---|---|
date | Sun, 09 Oct 2011 11:03:57 -0500 |
parents | d4de90a612f7 |
children | 9e99d2bbb1b1 2a3ab9e81a3e |
comparison
equal
deleted
inserted
replaced
15212:fad02a84c4ac | 15213:15f15f3b405d |
---|---|
1 Subrepositories let you nest external repositories or projects into a | 1 Subrepositories let you nest external repositories or projects into a |
2 parent Mercurial repository, and make commands operate on them as a | 2 parent Mercurial repository, and make commands operate on them as a |
3 group. External Mercurial and Subversion projects are currently | 3 group. |
4 supported. | 4 |
5 Mercurial currently supports Mercurial, Git, and Subversion | |
6 subrepositories. | |
5 | 7 |
6 Subrepositories are made of three components: | 8 Subrepositories are made of three components: |
7 | 9 |
8 1. Nested repository checkouts. They can appear anywhere in the | 10 1. Nested repository checkouts. They can appear anywhere in the |
9 parent working directory, and are Mercurial clones or Subversion | 11 parent working directory. |
10 checkouts. | |
11 | 12 |
12 2. Nested repository references. They are defined in ``.hgsub`` and | 13 2. Nested repository references. They are defined in ``.hgsub`` and |
13 tell where the subrepository checkouts come from. Mercurial | 14 tell where the subrepository checkouts come from. Mercurial |
14 subrepositories are referenced like: | 15 subrepositories are referenced like: |
15 | 16 |
16 path/to/nested = https://example.com/nested/repo/path | 17 path/to/nested = https://example.com/nested/repo/path |
17 | 18 |
19 Git and Subversion subrepos are also supported: | |
20 | |
21 path/to/nested = [git]git://example.com/nested/repo/path | |
22 path/to/nested = [svn]https://example.com/nested/trunk/path | |
23 | |
18 where ``path/to/nested`` is the checkout location relatively to the | 24 where ``path/to/nested`` is the checkout location relatively to the |
19 parent Mercurial root, and ``https://example.com/nested/repo/path`` | 25 parent Mercurial root, and ``https://example.com/nested/repo/path`` |
20 is the source repository path. The source can also reference a | 26 is the source repository path. The source can also reference a |
21 filesystem path. Subversion repositories are defined with: | 27 filesystem path. |
22 | |
23 path/to/nested = [svn]https://example.com/nested/trunk/path | |
24 | 28 |
25 Note that ``.hgsub`` does not exist by default in Mercurial | 29 Note that ``.hgsub`` does not exist by default in Mercurial |
26 repositories, you have to create and add it to the parent | 30 repositories, you have to create and add it to the parent |
27 repository before using subrepositories. | 31 repository before using subrepositories. |
28 | 32 |