commit d59a1c3b458751abda83fa864629003ee9b6ddad
from: Stefan Sperling <stsp@stsp.name>
date: Mon May 06 15:53:44 2024 UTC

in gotd.8 add an example which illustrates how to create repositories for gotd

commit - 27b8b8653569e89544f7d13837918fbe34dcb5f9
commit + d59a1c3b458751abda83fa864629003ee9b6ddad
blob - 62186e99619de41fcad57235fa92be7bb469b236
blob + 3d9c3c7f66b53e7a9ff05d0f35b1a13690ed6e09
--- gotd/gotd.8
+++ gotd/gotd.8
@@ -78,6 +78,32 @@ is listening on.
 This path can be configured in
 .Xr gotd.conf 5 .
 .El
+.Sh EXAMPLES
+Create an empty repository to be served by
+.Nm ,
+ensuring that it can only be accessed by the _gotd user:
+.Pp
+.Dl # mkdir -p /git/myrepo.git
+.Dl # chmod 700 /git/myrepo.git
+.Dl # chown _gotd /git/myrepo.git
+.Dl # su -m _gotd -c 'gotadmin init /git/myrepo.git'
+.Pp
+Add the new repository to
+.Xr gotd.conf 5
+granting read-write access to the flan_hacker user account, and
+restart
+.Nm :
+.Pp
+.Dl # cat >> /etc/gotd.conf <<EOF
+.Dl repository 'myrepo' {
+.Dl path '/git/myrepo.git'
+.Dl permit rw flan_hacker
+.Dl }
+.Dl EOF
+.Dl # rcctl restart gotd
+.Pp
+The flan_hacker user can now populate the empty repository with
+.Cm got send .
 .Sh SEE ALSO
 .Xr got 1 ,
 .Xr gotsh 1 ,