Mercurial > hg
comparison mercurial/help/hg-ssh.8.txt @ 29090:7b52cb384c38 stable
hg-ssh: copy doc string to man page
This corrects a warning from lintian that we're shipping an executable without
a man page. Since there is a doc string in the text, let's use that for the man
page.
author | Sean Farley <sean@farley.io> |
---|---|
date | Fri, 06 May 2016 23:03:41 -0700 |
parents | |
children | 4e934804cafe |
comparison
equal
deleted
inserted
replaced
29089:222b8170d69e | 29090:7b52cb384c38 |
---|---|
1 ======== | |
2 hg-ssh | |
3 ======== | |
4 | |
5 ---------------------------------------- | |
6 restricted ssh login shell for Mercurial | |
7 ---------------------------------------- | |
8 | |
9 :Author: Thomas Arendsen Hein <thomas@intevation.de> | |
10 :Organization: Mercurial | |
11 :Manual section: 8 | |
12 :Manual group: Mercurial Manual | |
13 | |
14 .. contents:: | |
15 :backlinks: top | |
16 :class: htmlonly | |
17 :depth: 1 | |
18 | |
19 Synopsis | |
20 """""""" | |
21 **hg-ssh** repositories... | |
22 | |
23 Description | |
24 """"""""""" | |
25 **hg-ssh** is a wrapper for ssh access to a limited set of mercurial repos. | |
26 | |
27 To be used in ~/.ssh/authorized_keys with the "command" option, see sshd(8): | |
28 command="hg-ssh path/to/repo1 /path/to/repo2 ~/repo3 ~user/repo4" ssh-dss ... | |
29 (probably together with these other useful options: | |
30 no-port-forwarding,no-X11-forwarding,no-agent-forwarding) | |
31 | |
32 This allows pull/push over ssh from/to the repositories given as arguments. | |
33 | |
34 If all your repositories are subdirectories of a common directory, you can | |
35 allow shorter paths with: | |
36 command="cd path/to/my/repositories && hg-ssh repo1 subdir/repo2" | |
37 | |
38 You can use pattern matching of your normal shell, e.g.: | |
39 command="cd repos && hg-ssh user/thomas/* projects/{mercurial,foo}" | |
40 | |
41 You can also add a --read-only flag to allow read-only access to a key, e.g.: | |
42 command="hg-ssh --read-only repos/\*" | |
43 | |
44 Bugs | |
45 """" | |
46 Probably lots, please post them to the mailing list (see Resources_ | |
47 below) when you find them. | |
48 | |
49 See Also | |
50 """""""" | |
51 |hg(1)|_ | |
52 | |
53 Author | |
54 """""" | |
55 Written by Matt Mackall <mpm@selenic.com> | |
56 | |
57 Resources | |
58 """"""""" | |
59 Main Web Site: https://mercurial-scm.org/ | |
60 | |
61 Source code repository: http://selenic.com/hg | |
62 | |
63 Mailing list: http://selenic.com/mailman/listinfo/mercurial | |
64 | |
65 Copying | |
66 """"""" | |
67 Copyright (C) 2005-2016 Matt Mackall. | |
68 Free use of this software is granted under the terms of the GNU General | |
69 Public License version 2 or any later version. | |
70 | |
71 .. include:: common.txt |