shithub: git9

Download patch

ref: 1f96d01edb9d306664cd803e7a0ff396b06b3705
parent: 2bf0d9c76e5f8bbae7f376b4efda83a81aafae15
author: Ori Bernstein <[email protected]>
date: Mon Sep 7 20:12:24 EDT 2020

git(1): document supported protocols.

--- a/git.1.man
+++ b/git.1.man
@@ -475,6 +475,41 @@
 and descendants of
 .B a.
 
+.SH PROTOCOLS
+.PP
+Git9 supports URL schemes of the format
+.BR transport://dial/repo/path .
+The transport portion specifies the protocol to use.
+The
+.I dial
+portion is either a plan 9 dial string, or a conventional
+.I host:port
+pair.
+For the ssh protocol, it may also include a
+.I user@
+prefix.
+.I repo/path
+portion is the path of the repository on the server.
+
+The supported transports are
+.B ssh://, git://, hjgit://, gits://, http://,
+and
+.BR https .
+Two of these are specific to git9:
+.I gits://
+and
+.IR hjgit:// .
+Both are the
+.I git://
+protocol, tunnelled over tls.
+.I Hjgit://
+authenticates with the server using Plan 9 authentication,
+using
+.IR tlsclient\ -a .
+Any of these protocol names may be prefixed with
+.IR git+ ,
+for copy-paste compatibility with Unix git.
+
 .SH EXAMPLES
 
 .PP