| pulkit |
| hg-reviewers |
If we want people to use it, we need to document it.
| Automatic diff as part of commit; lint not applicable. |
| Automatic diff as part of commit; unit tests not applicable. |
| Path | Packages | |||
|---|---|---|---|---|
| M | mercurial/helptext/config.txt (3 lines) | |||
| M | mercurial/helptext/urls.txt (10 lines) | |||
| M | tests/test-help.t (3 lines) |
| Options containing colons (``:``) denote sub-options that can influence | Options containing colons (``:``) denote sub-options that can influence | ||||
| behavior for that specific path. Example:: | behavior for that specific path. Example:: | ||||
| [paths] | [paths] | ||||
| my_server = https://example.com/my_path | my_server = https://example.com/my_path | ||||
| my_server:pushurl = ssh://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: | The following sub-options can be defined: | ||||
| ``pushurl`` | ``pushurl`` | ||||
| The URL to use for push operations. If not defined, the location | The URL to use for push operations. If not defined, the location | ||||
| defined by the path's main entry is used. | defined by the path's main entry is used. | ||||
| ``pushrev`` | ``pushrev`` | ||||
| A revset defining which revisions to push by default. | A revset defining which revisions to push by default. | ||||
| Valid URLs are of the form:: | Valid URLs are of the form:: | ||||
| local/filesystem/path[#revision] | local/filesystem/path[#revision] | ||||
| file://local/filesystem/path[#revision] | file://local/filesystem/path[#revision] | ||||
| http://[user[:pass]@]host[:port]/[path][#revision] | http://[user[:pass]@]host[:port]/[path][#revision] | ||||
| https://[user[:pass]@]host[:port]/[path][#revision] | https://[user[:pass]@]host[:port]/[path][#revision] | ||||
| ssh://[user@]host[:port]/[path][#revision] | ssh://[user@]host[:port]/[path][#revision] | ||||
| path://pathname | |||||
| Paths in the local filesystem can either point to Mercurial | Paths in the local filesystem can either point to Mercurial | ||||
| repositories or to bundle files (as created by :hg:`bundle` or | repositories or to bundle files (as created by :hg:`bundle` or | ||||
| :hg:`incoming --bundle`). See also :hg:`help paths`. | :hg:`incoming --bundle`). See also :hg:`help paths`. | ||||
| An optional identifier after # indicates a particular branch, tag, or | An optional identifier after # indicates a particular branch, tag, or | ||||
| changeset to use from the remote repository. See also :hg:`help | changeset to use from the remote repository. See also :hg:`help | ||||
| revisions`. | revisions`. | ||||
| When you create a repository with hg clone, the clone command saves | When you create a repository with hg clone, the clone command saves | ||||
| the location of the source repository as the new repository's | the location of the source repository as the new repository's | ||||
| 'default' path. This is then used when you omit path from push- and | 'default' path. This is then used when you omit path from push- and | ||||
| pull-like commands (including incoming and outgoing). | pull-like commands (including incoming and outgoing). | ||||
| default-push: | default-push: | ||||
| The push command will look for a path named 'default-push', and | The push command will look for a path named 'default-push', and | ||||
| prefer it over 'default' if both are defined. | 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". | |||||
| Options containing colons (":") denote sub-options that can influence | Options containing colons (":") denote sub-options that can influence | ||||
| behavior for that specific path. Example: | behavior for that specific path. Example: | ||||
| [paths] | [paths] | ||||
| my_server = https://example.com/my_path | my_server = https://example.com/my_path | ||||
| my_server:pushurl = ssh://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: | The following sub-options can be defined: | ||||
| "pushurl" | "pushurl" | ||||
| The URL to use for push operations. If not defined, the location | The URL to use for push operations. If not defined, the location | ||||
| defined by the path's main entry is used. | defined by the path's main entry is used. | ||||
| "pushrev" | "pushrev" | ||||
| A revset defining which revisions to push by default. | A revset defining which revisions to push by default. | ||||