threads / discuss / 2443

The host:remote syntax mess

Subject: The host:remote syntax mess

## tl;dr

2 messages between Nov 11, 2005 and Nov 11, 2005.

replies: 1people: 2as markdown or json

Petr Baudis· Nov 11, 2005, 01:22 UTC · lore
  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.
Junio C Hamano· Nov 11, 2005, 01:46 UTC · re: Petr Baudis · lore

Re: The host:remote syntax mess

Petr Baudis <pasky@ucw.cz> writes:
Show 7 quoted lines
>   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/
 ===============================================================
 +

← back to recent threads