Mercurial > hg
comparison mercurial/help/config.txt @ 16549:517b25608ad6 stable
help/config: expand [subpaths] help
Brifly explain why rewriting subrepository paths can be necessary.
Explain that relative subrepository paths are made absolute before
rewrite rules are applied.
author | Martin Geisler <mg@aragost.com> |
---|---|
date | Mon, 30 Apr 2012 12:45:44 +0200 |
parents | aa252059a98f |
children | 63f10a163017 |
comparison
equal
deleted
inserted
replaced
16548:e49e039acd5e | 16549:517b25608ad6 |
---|---|
1050 | 1050 |
1051 | 1051 |
1052 ``subpaths`` | 1052 ``subpaths`` |
1053 """""""""""" | 1053 """""""""""" |
1054 | 1054 |
1055 Defines subrepositories source locations rewriting rules of the form:: | 1055 Subrepository source URLs can go stale if a remote server changes name |
1056 or becomes temporarily unavailable. This section lets you define | |
1057 rewrite rules of the form:: | |
1056 | 1058 |
1057 <pattern> = <replacement> | 1059 <pattern> = <replacement> |
1058 | 1060 |
1059 Where ``pattern`` is a regular expression matching the source and | 1061 where ``pattern`` is a regular expression matching a subrepository |
1060 ``replacement`` is the replacement string used to rewrite it. Groups | 1062 source URL and ``replacement`` is the replacement string used to |
1061 can be matched in ``pattern`` and referenced in ``replacements``. For | 1063 rewrite it. Groups can be matched in ``pattern`` and referenced in |
1062 instance:: | 1064 ``replacements``. For instance:: |
1063 | 1065 |
1064 http://server/(.*)-hg/ = http://hg.server/\1/ | 1066 http://server/(.*)-hg/ = http://hg.server/\1/ |
1065 | 1067 |
1066 rewrites ``http://server/foo-hg/`` into ``http://hg.server/foo/``. | 1068 rewrites ``http://server/foo-hg/`` into ``http://hg.server/foo/``. |
1067 | 1069 |
1068 All patterns are applied in definition order. | 1070 Relative subrepository paths are first made absolute, and the the |
1071 rewrite rules are then applied on the full (absolute) path. The rules | |
1072 are applied in definition order. | |
1069 | 1073 |
1070 ``trusted`` | 1074 ``trusted`` |
1071 """"""""""" | 1075 """"""""""" |
1072 | 1076 |
1073 Mercurial will not use the settings in the | 1077 Mercurial will not use the settings in the |