# The host:remote syntax mess 2 messages from 2005-11-11 to 2005-11-11. Participants: Petr Baudis, Junio C Hamano. Thread: https://gitlist.dev/t/2443 ## Petr Baudis, 2005-11-11 01:22 Subject: The host:remote syntax mess Message-ID: <20051111012216.GJ30496@pasky.or.cz> URL: https://gitlist.dev/e/20051111012216.GJ30496%40pasky.or.cz ``` 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, 2005-11-11 01:46 Subject: Re: The host:remote syntax mess Message-ID: <7vfyq4vtw3.fsf@assigned-by-dhcp.cox.net> URL: https://gitlist.dev/e/7vfyq4vtw3.fsf%40assigned-by-dhcp.cox.net In-Reply-To: <20051111012216.GJ30496@pasky.or.cz> ``` Petr Baudis 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 --- 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/ =============================================================== + ```