Mercurial > hg

comparison mercurial/help/subrepos.txt @ 15213:15f15f3b405d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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