aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/urls.txt
diff options
context:
space:
mode:
authorNguyễn Thái Ngọc Duy <pclouds@gmail.com>2013-05-04 09:19:33 +0700
committerJunio C Hamano <gitster@pobox.com>2013-05-07 08:32:14 -0700
commit60003340cda05f5ecd79ee8522b21eda038b994b (patch)
tree6d072e229727d6a3a73ac36c7685a006be95a443 /Documentation/urls.txt
parent239222f587ed06f96d90dd71c66d80a2b1e3dc9f (diff)
downloadgit-60003340cda05f5ecd79ee8522b21eda038b994b.tar.gz
clone: allow cloning local paths with colons in them
Usually "foo:bar" is interpreted as an ssh url. This patch allows to clone from such paths by putting at least one slash before the colon (i.e. /path/to/foo:bar or just ./foo:bar). file://foo:bar should also work, but local optimizations are off in that case, which may be unwanted. While at there, warn the users about --local being ignored in this case. Reported-by: William Giokas <1007380@gmail.com> Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/urls.txt')
-rw-r--r--Documentation/urls.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/urls.txt b/Documentation/urls.txt
index 3ca122faed..476e3381c5 100644
--- a/Documentation/urls.txt
+++ b/Documentation/urls.txt
@@ -23,6 +23,12 @@ An alternative scp-like syntax may also be used with the ssh protocol:
- {startsb}user@{endsb}host.xz:path/to/repo.git/
+This syntax is only recognized if there are no slashes before the
+first colon. This helps differentiate a local path that contains a
+colon. For example the local path `foo:bar` could be specified as an
+absolute path or `./foo:bar` to avoid being misinterpreted as an ssh
+url.
+
The ssh and git protocols additionally support ~username expansion:
- ssh://{startsb}user@{endsb}host.xz{startsb}:port{endsb}/~{startsb}user{endsb}/path/to/repo.git/