git-filter-branch: document --original option
[git/trast.git] / Documentation / urls.txt
blobb38145faff384344fde354152db186275ebeb5ca
1 GIT URLS[[URLS]]
2 ----------------
4 One of the following notations can be used
5 to name the remote repository:
7 ===============================================================
8 - rsync://host.xz/path/to/repo.git/
9 - http://host.xz/path/to/repo.git/
10 - https://host.xz/path/to/repo.git/
11 - git://host.xz/path/to/repo.git/
12 - git://host.xz/~user/path/to/repo.git/
13 - ssh://{startsb}user@{endsb}host.xz/path/to/repo.git/
14 - ssh://{startsb}user@{endsb}host.xz/~user/path/to/repo.git/
15 - ssh://{startsb}user@{endsb}host.xz/~/path/to/repo.git
16 ===============================================================
18 SSH is the default transport protocol over the network.  You can
19 optionally specify which user to log-in as, and an alternate,
20 scp-like syntax is also supported.  Both syntaxes support
21 username expansion, as does the native git protocol. The following
22 three are identical to the last three above, respectively:
24 ===============================================================
25 - {startsb}user@{endsb}host.xz:/path/to/repo.git/
26 - {startsb}user@{endsb}host.xz:~user/path/to/repo.git/
27 - {startsb}user@{endsb}host.xz:path/to/repo.git
28 ===============================================================
30 To sync with a local directory, you can use:
32 ===============================================================
33 - /path/to/repo.git/
34 - file:///path/to/repo.git/
35 ===============================================================
37 They are mostly equivalent, except when cloning.  See
38 gitlink:git-clone[1] for details.