commit cda0eee6bf5beb6465d01eda8542f8c3a4bbce7c from: Stefan Sperling via: Thomas Adam 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