Mercurial > hgsubversion
comparison README @ 565:ebecf034e52a
README: improved documentation of svn:externals support
| author | Mark Edgington <edgimar@gmail.com> |
|---|---|
| date | Sun, 21 Feb 2010 20:14:29 -0600 |
| parents | 9fadbf0686a1 |
| children | f12257bf8b91 |
comparison
equal
deleted
inserted
replaced
| 564:7bd457ec4e5e | 565:ebecf034e52a |
|---|---|
| 58 For more information, see ``hg help svn`` while in a converted repo. | 58 For more information, see ``hg help svn`` while in a converted repo. |
| 59 | 59 |
| 60 Support for ``svn:externals`` | 60 Support for ``svn:externals`` |
| 61 ----------------------------- | 61 ----------------------------- |
| 62 All ``svn:externals`` properties are serialized into a single | 62 All ``svn:externals`` properties are serialized into a single |
| 63 ``.hgsvnexternals`` file, with the following syntax:: | 63 ``.hgsvnexternals`` file having the following syntax:: |
| 64 | 64 |
| 65 [.] | 65 [.] |
| 66 external_reference_line1_1 | 66 common1 http://path/to/external/svn/repo1 |
| 67 external_reference_line1_2 | 67 ...additional svn:externals properties lines... |
| 68 [dir2] | 68 [dir2] |
| 69 external_reference_line2_1 | 69 common2 -r123 http://path/to/external/svn/repo2 |
| 70 external_reference_line2_2 | 70 ...additional svn:externals properties lines... |
| 71 | 71 |
| 72 A header line gives the directory the property applies on, '.' for the | 72 A header line in brackets specifies the directory the property applies |
| 73 project root directory. The property content follows, *every line | 73 to, where '.' indicates the project root directory. The property content |
| 74 being prefixed by a single space*. | 74 follows the header, **with every content line being prefixed by a single |
| 75 space**. Note that the property lines have a format identical to | |
| 76 svn:externals properties as used in Subversion, and do not support the | |
| 77 hgsubversion extended svn+http:// URL format. | |
| 75 | 78 |
| 76 The creation or modification of this file will trigger ``svn:externals`` | 79 Issuing the command ``hg svn updateexternals`` with the |
| 77 updates on the related subversion repository. | 80 ``.hgsvnexternals`` example above would fetch the latest revision of |
| 81 repo1 into the subdirectory ./common1, and revision 123 of repo2 into | |
| 82 dir2/common2. Note that ``.hgsvnexternals`` must be tracked by Mercurial | |
| 83 before this will work. If ``.hgsvnexternals`` is created or changed, it | |
| 84 will not be pushed to the related Subversion repository, *but its | |
| 85 contents will be used to update ``svn:externals`` properties on the | |
| 86 related Subversion repository*. |