##// END OF EJS Templates
help: fix wording describing SSH requirements
Josef 'Jeff' Sipek -
r36372:5da7b8cb stable
parent child Browse files
Show More
@@ -1,66 +1,66 b''
1 Valid URLs are of the form::
1 Valid URLs are of the form::
2
2
3 local/filesystem/path[#revision]
3 local/filesystem/path[#revision]
4 file://local/filesystem/path[#revision]
4 file://local/filesystem/path[#revision]
5 http://[user[:pass]@]host[:port]/[path][#revision]
5 http://[user[:pass]@]host[:port]/[path][#revision]
6 https://[user[:pass]@]host[:port]/[path][#revision]
6 https://[user[:pass]@]host[:port]/[path][#revision]
7 ssh://[user@]host[:port]/[path][#revision]
7 ssh://[user@]host[:port]/[path][#revision]
8
8
9 Paths in the local filesystem can either point to Mercurial
9 Paths in the local filesystem can either point to Mercurial
10 repositories or to bundle files (as created by :hg:`bundle` or
10 repositories or to bundle files (as created by :hg:`bundle` or
11 :hg:`incoming --bundle`). See also :hg:`help paths`.
11 :hg:`incoming --bundle`). See also :hg:`help paths`.
12
12
13 An optional identifier after # indicates a particular branch, tag, or
13 An optional identifier after # indicates a particular branch, tag, or
14 changeset to use from the remote repository. See also :hg:`help
14 changeset to use from the remote repository. See also :hg:`help
15 revisions`.
15 revisions`.
16
16
17 Some features, such as pushing to http:// and https:// URLs are only
17 Some features, such as pushing to http:// and https:// URLs are only
18 possible if the feature is explicitly enabled on the remote Mercurial
18 possible if the feature is explicitly enabled on the remote Mercurial
19 server.
19 server.
20
20
21 Note that the security of HTTPS URLs depends on proper configuration of
21 Note that the security of HTTPS URLs depends on proper configuration of
22 web.cacerts.
22 web.cacerts.
23
23
24 Some notes about using SSH with Mercurial:
24 Some notes about using SSH with Mercurial:
25
25
26 - SSH requires an accessible shell account on the destination machine
26 - SSH requires an accessible shell account on the destination machine
27 and a copy of hg in the remote path or specified with as remotecmd.
27 and a copy of hg in the remote path or specified with remotecmd.
28 - path is relative to the remote user's home directory by default. Use
28 - path is relative to the remote user's home directory by default. Use
29 an extra slash at the start of a path to specify an absolute path::
29 an extra slash at the start of a path to specify an absolute path::
30
30
31 ssh://example.com//tmp/repository
31 ssh://example.com//tmp/repository
32
32
33 - Mercurial doesn't use its own compression via SSH; the right thing
33 - Mercurial doesn't use its own compression via SSH; the right thing
34 to do is to configure it in your ~/.ssh/config, e.g.::
34 to do is to configure it in your ~/.ssh/config, e.g.::
35
35
36 Host *.mylocalnetwork.example.com
36 Host *.mylocalnetwork.example.com
37 Compression no
37 Compression no
38 Host *
38 Host *
39 Compression yes
39 Compression yes
40
40
41 Alternatively specify "ssh -C" as your ssh command in your
41 Alternatively specify "ssh -C" as your ssh command in your
42 configuration file or with the --ssh command line option.
42 configuration file or with the --ssh command line option.
43
43
44 These URLs can all be stored in your configuration file with path
44 These URLs can all be stored in your configuration file with path
45 aliases under the [paths] section like so::
45 aliases under the [paths] section like so::
46
46
47 [paths]
47 [paths]
48 alias1 = URL1
48 alias1 = URL1
49 alias2 = URL2
49 alias2 = URL2
50 ...
50 ...
51
51
52 You can then use the alias for any command that uses a URL (for
52 You can then use the alias for any command that uses a URL (for
53 example :hg:`pull alias1` will be treated as :hg:`pull URL1`).
53 example :hg:`pull alias1` will be treated as :hg:`pull URL1`).
54
54
55 Two path aliases are special because they are used as defaults when
55 Two path aliases are special because they are used as defaults when
56 you do not provide the URL to a command:
56 you do not provide the URL to a command:
57
57
58 default:
58 default:
59 When you create a repository with hg clone, the clone command saves
59 When you create a repository with hg clone, the clone command saves
60 the location of the source repository as the new repository's
60 the location of the source repository as the new repository's
61 'default' path. This is then used when you omit path from push- and
61 'default' path. This is then used when you omit path from push- and
62 pull-like commands (including incoming and outgoing).
62 pull-like commands (including incoming and outgoing).
63
63
64 default-push:
64 default-push:
65 The push command will look for a path named 'default-push', and
65 The push command will look for a path named 'default-push', and
66 prefer it over 'default' if both are defined.
66 prefer it over 'default' if both are defined.
General Comments 0
You need to be logged in to leave comments. Login now