commit cda0eee6bf5beb6465d01eda8542f8c3a4bbce7c
from: Stefan Sperling <stsp@stsp.name>
via: Thomas Adam <thomas.adam22@gmail.com>
date: Thu Apr 25 14:57:36 2024 UTC

man page updates for HTTP clone/fetch support

commit - 09876a9d351bc3b655effc2a43f536444821d43a
commit + cda0eee6bf5beb6465d01eda8542f8c3a4bbce7c
blob - c97e00bb2566dad517be2b6512d52b15801a331d
blob + b815f5d3310934b06d9982a18ee1fd8e63fb1a55
--- got/got.1
+++ got/got.1
@@ -181,6 +181,25 @@ to use:
 .Mt user@hostname
 .It ssh
 Short alias for git+ssh.
+.It http
+The
+.Dq smart
+HTTP Git protocol.
+Supported by
+.Cm got clone
+and
+.Cm got fetch ,
+but not by
+.Cm got send .
+Not compatible with Git HTTP servers using the
+.Dq dumb
+protocol.
+Use of this protocol is discouraged since it supports neither authentication
+nor encryption.
+.It https
+The
+.Dq smart
+Git HTTP protocol wrapped in SSL/TLS.
 .El
 .Pp
 Objects in the cloned repository are stored in a pack file which is downloaded
@@ -3815,11 +3834,10 @@ access via SSH.
 Such sites will require an account to be created, and a public SSH key to be
 uploaded to this account, before repository access via ssh:// URLs will work.
 .Pp
-Use of HTTP URLs currently requires
-.Xr git 1 :
+Most sites offer anonymous repository access via HTTPS:
 .Pp
 .Dl $ cd /var/git/
-.Dl $ git clone --bare https://github.com/openbsd/src.git
+.Dl $ got clone https://github.com/openbsd/src.git
 .Pp
 Alternatively, for quick and dirty local testing of
 .Nm
@@ -3944,15 +3962,6 @@ branch:
 .Dl $ cd /usr/src
 .Dl $ got fetch
 .Pp
-In a repository created with a HTTP URL and
-.Cm git clone --bare
-the
-.Xr git-fetch 1
-command must be used instead:
-.Pp
-.Dl $ cd /var/git/src.git
-.Dl $ git fetch origin master:refs/remotes/origin/master
-.Pp
 Rebase the local
 .Dq master
 branch to merge the new changes that are now visible on the
@@ -4301,11 +4310,6 @@ to perform some tasks.
 In particular:
 .Bl -bullet
 .It
-Reading from remote repositories over HTTP or HTTPS protocols requires
-.Xr git-clone 1
-and
-.Xr git-fetch 1 .
-.It
 Writing to remote repositories over HTTP or HTTPS protocols requires
 .Xr git-push 1 .
 .It