garbash-config

commit 62e5cb2e1e077c2c67abcd63cea4c2d3d877512e (patch)
parent 23b7a6de6415488d3712c367eb9c198ed4e728fd
Author: alex <alex@garbash.com>
Date:   Fri,  1 Oct 2021 00:36:15 -0400

doc: Add newrepo man page!

Slightly less fun to write than wggen(8), but still useful!

Diffstat:
M
Makefile
 | 
1
+
A
usr/local/man/man1/newrepo.1
 | 
40
++++++++++++++++++++++++++++++++++++++++
M
usr/local/man/man8/wggen.8
 | 
2
+-

3 files changed, 42 insertions(+), 1 deletion(-)
diff --git a/Makefile b/Makefile
@@ -4,6 +4,7 @@ FILES = /etc/httpd.conf \
 	/etc/mail/smtpd.conf \
 	/var/git/stagit-post-receive \
 	/usr/local/bin/newrepo \
+	/usr/local/man/man1/newrepo.1 \
 	/usr/local/bin/wggen \
 	/usr/local/man/man8/wggen.8
 
diff --git a/usr/local/man/man1/newrepo.1 b/usr/local/man/man1/newrepo.1
@@ -0,0 +1,40 @@
+.Dd October 1, 2021
+.Dt NEWREPO 1
+.Os
+.Sh NAME
+.Nm newrepo
+.Nd create a new public git repository for web hosting
+.Sh SYNOPSIS
+.Nm
+.Ar name
+.Sh DESCRIPTION
+.Nm
+creates a new repository configured with the proper
+.Xr stagit 1
+git-hooks so that changes pushed to it are shown on
+.Lk https://git.garbash.com .
+In addition,
+the repository is configured for public access via the
+.Xr git-daemon 1
+(git:// protocol).
+.Pp
+This is an interactive tool;
+it will prompt for a one-line description of the repository for
+the homepage index.
+.Sh FILES
+.Bl -tag -width "$HOME/git/<name>.git"
+.It Pa $HOME/git/<name>.git
+location of new bare git repository
+.It Pa $HOME/git
+a symlink to the system git directory under
+.Pa /var/git/$USER
+.El
+.Sh SEE ALSO
+.Xr git 1 ,
+.Xr git-daemon 1 ,
+.Xr stagit 1
+.Sh HISTORY
+Created by ~alex upon setting up
+.Xr stagit 1 .
+The whole history is posted here:
+.Lk https://garbash.com/~alex/notes/007-git-coding.txt
diff --git a/usr/local/man/man8/wggen.8 b/usr/local/man/man8/wggen.8
@@ -1,4 +1,4 @@
-.Dd $Mdocdate$
+.Dd October 1, 2021
 .Dt WGGEN 8
 .Os
 .Sh NAME