Mercurial > hg-stable
changeset 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 | e49e039acd5e |
| children | 0d494a38c586 |
| files | mercurial/help/config.txt |
| diffstat | 1 files changed, 10 insertions(+), 6 deletions(-) [+] |
line wrap: on
line diff
--- a/mercurial/help/config.txt Mon Apr 30 12:04:30 2012 +0200 +++ b/mercurial/help/config.txt Mon Apr 30 12:45:44 2012 +0200 @@ -1052,20 +1052,24 @@ ``subpaths`` """""""""""" -Defines subrepositories source locations rewriting rules of the form:: +Subrepository source URLs can go stale if a remote server changes name +or becomes temporarily unavailable. This section lets you define +rewrite rules of the form:: <pattern> = <replacement> -Where ``pattern`` is a regular expression matching the source and -``replacement`` is the replacement string used to rewrite it. Groups -can be matched in ``pattern`` and referenced in ``replacements``. For -instance:: +where ``pattern`` is a regular expression matching a subrepository +source URL and ``replacement`` is the replacement string used to +rewrite it. Groups can be matched in ``pattern`` and referenced in +``replacements``. For instance:: http://server/(.*)-hg/ = http://hg.server/\1/ rewrites ``http://server/foo-hg/`` into ``http://hg.server/foo/``. -All patterns are applied in definition order. +Relative subrepository paths are first made absolute, and the the +rewrite rules are then applied on the full (absolute) path. The rules +are applied in definition order. ``trusted`` """""""""""