The host:remote syntax mess

The host:remote syntax mess

[Petr Baudis]

  Hello,

  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? One possible
explanation is just that the git+ssh line should have been between the
git line and the : line in the documentation.

  But if you really intend to change it, please don't. It's enough mess
as it is now, and I'm actually not convinced at all that we should
support it at all (god forbid promote it). When you have a location
specifier, you don't want it to randomly switch protocols, especially
such significantly different ones as ssh and git.

-- 
				Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
VI has two modes: the one in which it beeps and the one in which
it doesn't.

Re: The host:remote syntax mess

[Junio C Hamano]

Petr Baudis <pasky@ucw.cz> 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 <junkio@cox.net>
---
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/
 ===============================================================
 +