2009-10-04 14:18:43 +04:00
|
|
|
Valid URLs are of the form::
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
local/filesystem/path[#revision]
|
2011-11-18 04:32:28 +04:00
|
|
|
file://local/filesystem/path[#revision]
|
2009-10-04 14:18:43 +04:00
|
|
|
http://[user[:pass]@]host[:port]/[path][#revision]
|
|
|
|
https://[user[:pass]@]host[:port]/[path][#revision]
|
2011-01-27 22:29:21 +03:00
|
|
|
ssh://[user@]host[:port]/[path][#revision]
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
Paths in the local filesystem can either point to Mercurial
|
2013-05-16 01:19:12 +04:00
|
|
|
repositories or to bundle files (as created by :hg:`bundle` or
|
|
|
|
:hg:`incoming --bundle`). See also :hg:`help paths`.
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
An optional identifier after # indicates a particular branch, tag, or
|
2010-04-22 12:24:49 +04:00
|
|
|
changeset to use from the remote repository. See also :hg:`help
|
|
|
|
revisions`.
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
Some features, such as pushing to http:// and https:// URLs are only
|
|
|
|
possible if the feature is explicitly enabled on the remote Mercurial
|
|
|
|
server.
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2010-10-01 02:48:50 +04:00
|
|
|
Note that the security of HTTPS URLs depends on proper configuration of
|
|
|
|
web.cacerts.
|
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
Some notes about using SSH with Mercurial:
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
- SSH requires an accessible shell account on the destination machine
|
|
|
|
and a copy of hg in the remote path or specified with as remotecmd.
|
|
|
|
- path is relative to the remote user's home directory by default. Use
|
|
|
|
an extra slash at the start of a path to specify an absolute path::
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
ssh://example.com//tmp/repository
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
- Mercurial doesn't use its own compression via SSH; the right thing
|
|
|
|
to do is to configure it in your ~/.ssh/config, e.g.::
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
Host *.mylocalnetwork.example.com
|
|
|
|
Compression no
|
|
|
|
Host *
|
|
|
|
Compression yes
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2010-08-28 06:36:35 +04:00
|
|
|
Alternatively specify "ssh -C" as your ssh command in your
|
|
|
|
configuration file or with the --ssh command line option.
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2010-08-28 06:36:35 +04:00
|
|
|
These URLs can all be stored in your configuration file with path
|
|
|
|
aliases under the [paths] section like so::
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
[paths]
|
|
|
|
alias1 = URL1
|
|
|
|
alias2 = URL2
|
|
|
|
...
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
You can then use the alias for any command that uses a URL (for
|
2010-04-22 12:24:49 +04:00
|
|
|
example :hg:`pull alias1` will be treated as :hg:`pull URL1`).
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
Two path aliases are special because they are used as defaults when
|
|
|
|
you do not provide the URL to a command:
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
default:
|
|
|
|
When you create a repository with hg clone, the clone command saves
|
|
|
|
the location of the source repository as the new repository's
|
|
|
|
'default' path. This is then used when you omit path from push- and
|
|
|
|
pull-like commands (including incoming and outgoing).
|
2009-10-04 11:59:13 +04:00
|
|
|
|
2009-10-04 14:18:43 +04:00
|
|
|
default-push:
|
|
|
|
The push command will look for a path named 'default-push', and
|
|
|
|
prefer it over 'default' if both are defined.
|