help: document the `path://` url scheme
If we want people to use it, we need to document it.
Differential Revision: https://phab.mercurial-scm.org/D10372
--- a/mercurial/helptext/config.txt Sat Apr 10 15:28:10 2021 +0200
+++ b/mercurial/helptext/config.txt Sat Apr 10 15:30:32 2021 +0200
@@ -1712,6 +1712,9 @@
my_server = https://example.com/my_path
my_server:pushurl = ssh://example.com/my_path
+Paths using the `path://otherpath` scheme will inherit the sub-options value from
+the path they point to.
+
The following sub-options can be defined:
``pushurl``
--- a/mercurial/helptext/urls.txt Sat Apr 10 15:28:10 2021 +0200
+++ b/mercurial/helptext/urls.txt Sat Apr 10 15:30:32 2021 +0200
@@ -5,6 +5,7 @@
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[user@]host[:port]/[path][#revision]
+ path://pathname
Paths in the local filesystem can either point to Mercurial
repositories or to bundle files (as created by :hg:`bundle` or
@@ -64,3 +65,12 @@
default-push:
The push command will look for a path named 'default-push', and
prefer it over 'default' if both are defined.
+
+These alias can also be use in the `path://` scheme::
+
+ [paths]
+ alias1 = URL1
+ alias2 = path://alias1
+ ...
+
+check :hg:`help config.paths` for details about the behavior of such "sub-path".
--- a/tests/test-help.t Sat Apr 10 15:28:10 2021 +0200
+++ b/tests/test-help.t Sat Apr 10 15:30:32 2021 +0200
@@ -1842,6 +1842,9 @@
my_server = https://example.com/my_path
my_server:pushurl = ssh://example.com/my_path
+ Paths using the 'path://otherpath' scheme will inherit the sub-options
+ value from the path they point to.
+
The following sub-options can be defined:
"pushurl"