From 7679ab7cb178b4647a47e0c336d552d0bc2f0dd5 Mon Sep 17 00:00:00 2001
From: Wolfgang Müller
Date: Mon, 19 Jul 2021 15:59:52 +0200
Subject: Add manual for git-init-shared(1)

---
 Makefile          |  4 ++--
 git-init-shared.1 | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 2 deletions(-)
 create mode 100644 git-init-shared.1

diff --git a/Makefile b/Makefile
index f515359..6244684 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,7 @@
 PREFIX ?= /usr/local
 
-install: git-init-shared git-package git-package.1 git-sign-for-cgit git-sign-for-cgit.1
+install: git-init-shared git-init-shared.1 git-package git-package.1 git-sign-for-cgit git-sign-for-cgit.1
 	install -D -m 755 -t '${DESTDIR}${PREFIX}/bin' git-init-shared git-package git-sign-for-cgit
-	install -D -m 644 -t '${DESTDIR}${PREFIX}/share/man/man1' git-package.1 git-sign-for-cgit.1
+	install -D -m 644 -t '${DESTDIR}${PREFIX}/share/man/man1' git-init-shared.1 git-package.1 git-sign-for-cgit.1
 
 .PHONY: install
diff --git a/git-init-shared.1 b/git-init-shared.1
new file mode 100644
index 0000000..dfd9ffa
--- /dev/null
+++ b/git-init-shared.1
@@ -0,0 +1,42 @@
+.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 .
-- 
cgit v1.2.3-2-gb3c3