mercurial/help/config.txt
branchstable
changeset 16549 517b25608ad6
parent 16513 aa252059a98f
child 16570 63f10a163017
--- 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``
 """""""""""