.Dd July 19, 2021
.Dt GIT-INIT-SHARED 1
.Os
.Sh NAME
.Nm git-init-shared
.Nd create and share a git repository amongst multiple users
.Sh SYNOPSIS
.Nm git init-shared
.Ar directory
.Op Ar user...
.Sh DESCRIPTION
.Nm
creates (or reinitializes) a git repository at
.Ar directory
and grants the owner and all other specified users write access to it.
Access rights are stored in POSIX Access Control Lists as per
.Xr acl 5 .
.Pp
It is safe to run this command on an already existing git repository.
Previously unauthorized users that are included in the subsequent
invocation will be granted write access.
.Pp
.Nm
only ever grants access.
If you need to remove access for a user, use the following
invocation of
.Xr setfacl 1
instead:
.Bd -literal -offset indent
setfacl -Rnx 'u:<user>,d:u:<user>' <repository>
.Ed
.Sh SEE ALSO
.Xr getfacl 1 ,
.Xr git 1 ,
.Xr git-init 1 ,
.Xr setfacl 1 ,
.Xr acl 5
.Sh AUTHORS
.An -nosplit
.Nm
was written by
.An Wolfgang Müller Aq Mt wolf@oriole.systems .