--- a/tests/test-help.t Sun Dec 06 12:31:46 2015 -0800
+++ b/tests/test-help.t Sat Dec 05 21:11:04 2015 -0800
@@ -1207,28 +1207,43 @@
"paths"
-------
- Assigns symbolic names to repositories. The left side is the symbolic
- name, and the right gives the directory or URL that is the location of the
- repository. Default paths can be declared by setting the following
- entries.
+ Assigns symbolic names and behavior to repositories.
+
+ Options are symbolic names defining the URL or directory that is the
+ location of the repository. Example:
+
+ [paths]
+ my_server = https://example.com/my_repo
+ local_path = /home/me/repo
+
+ These symbolic names can be used from the command line. To pull from
+ "my_server": "hg pull my_server". To push to "local_path": "hg push
+ local_path".
+
+ Options containing colons (":") denote sub-options that can influence
+ behavior for that specific path. Example:
+
+ [paths]
+ my_server = https://example.com/my_path
+ my_server:pushurl = ssh://example.com/my_path
+
+ The following sub-options can be defined:
+
+ "pushurl"
+ The URL to use for push operations. If not defined, the location
+ defined by the path's main entry is used.
+
+ The following special named paths exist:
"default"
- Directory or URL to use when pulling if no source is specified.
- (default: repository from which the current repository was cloned)
+ The URL or directory to use when no source or remote is specified.
+
+ "hg clone" will automatically define this path to the location the
+ repository was cloned from.
"default-push"
- Optional. Directory or URL to use when pushing if no destination is
- specified.
-
- Custom paths can be defined by assigning the path to a name that later can
- be used from the command line. Example:
-
- [paths]
- my_path = http://example.com/path
-
- To push to the path defined in "my_path" run the command:
-
- hg push my_path
+ (deprecated) The URL or directory for the default "hg push" location.
+ "default:pushurl" should be used instead.
$ hg help glossary.mcguffin
abort: help section not found