From 92ba675e4bffaca19af1d354783c33b0d9dca069 Mon Sep 17 00:00:00 2001
From: Wolfgang Müller
Date: Thu, 3 Mar 2022 15:15:19 +0100
Subject: Rename git-init-shared(1) to git-init-acl(1)

We have always felt that the name of this program was too close to the
invocation of 'git init --shared' which does something similar. Make it
clear in the name that we're working with POSIX ACLs instead of normal
permission sets as 'git init --shared' does.
---
 git-init-acl.1 | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 git-init-acl.1

(limited to 'git-init-acl.1')

diff --git a/git-init-acl.1 b/git-init-acl.1
new file mode 100644
index 0000000..2bf8b12
--- /dev/null
+++ b/git-init-acl.1
@@ -0,0 +1,42 @@
+.Dd July 19, 2021
+.Dt GIT-INIT-ACL 1
+.Os
+.Sh NAME
+.Nm git-init-acl
+.Nd create and share a git repository amongst multiple users
+.Sh SYNOPSIS
+.Nm git init-acl
+.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 .
-- 
cgit v1.2.3-2-gb3c3