commit f357763f32830a6499489869d8501ddd01f9c3e3
from: Stefan Sperling <stsp@stsp.name>
via: Thomas Adam <thomas@xteddy.org>
date: Thu Jun 22 13:10:34 2023 UTC

explain why the first 'got clone' example in got.1 will often fail

commit - 0b83b8f6353b650215b9bca597657608dcbe8a9d
commit + f357763f32830a6499489869d8501ddd01f9c3e3
blob - f6ba97cb74fbc7e6a57f575c6468ef0fed2550d7
blob + 785cef7abb14809b005cec30c4c76f9901154c6f
--- got/got.1
+++ got/got.1
@@ -3288,11 +3288,16 @@ command names in
 .Dl $ set -A complete_got_1 -- $(got -h 2>&1 | sed -n s/commands://p)
 .Pp
 Clone an existing Git repository for use with
-.Nm .
+.Nm :
 .Pp
 .Dl $ cd /var/git/
 .Dl $ got clone ssh://git@github.com/openbsd/src.git
 .Pp
+Unfortunately, many of the popular Git hosting sites do not offer anonymous
+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 :
 .Pp