Thread (1 message) 1 message, 1 author, 2016-06-15

Re: The host:remote syntax mess

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:42:11
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

Possibly related (same subject, not in this thread)

Petr Baudis [off-list ref] writes:
  I've just noticed that host:remote syntax seems to have been hijacked
again and is now attached to the GIT protocol in

	Documentation/pull-fetch-param.txt

(which BTW misses git+ssh). I said "seems", because connect.c still
appears to assume it is SSH. So what is the plan?
Sorry about that.  Thanks for noticing.

There is no plan to change that.  This documentation gotcha was
just that yours truly stupidly merged documentation changes
without reading every single line.

-- >8 -- cut here -- >8 --
[PATCH] Documentation: "host:path/to/repo" is git native over ssh.

You could also spell it ssh://host:/path/to/repo (or git+ssh,
ssh+git), but without method:// is shorter to type, so mention
only that one in the short and sweet list.

Signed-off-by: Junio C Hamano <redacted>
---
diff --git a/Documentation/pull-fetch-param.txt b/Documentation/pull-fetch-param.txt
index 5c2888e..ddd5823 100644
--- a/Documentation/pull-fetch-param.txt
+++ b/Documentation/pull-fetch-param.txt
@@ -8,7 +8,7 @@
 - Rsync URL:		rsync://remote.machine/path/to/repo.git/
 - HTTP(s) URL:		http://remote.machine/path/to/repo.git/
 - git URL:		git://remote.machine/path/to/repo.git/
-			or remote.machine:/path/to/repo.git/
+- ssh URL:		remote.machine:/path/to/repo.git/
 - Local directory:	/path/to/repo.git/
 ===============================================================
 +
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help