Mercurial > hg

comparison mercurial/help/config.txt @ 16549:517b25608ad6 stable

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