From 62e5cb2e1e077c2c67abcd63cea4c2d3d877512e Mon Sep 17 00:00:00 2001 From: alex Date: Fri, 1 Oct 2021 00:36:15 -0400 Subject: [PATCH] doc: Add newrepo man page! Slightly less fun to write than wggen(8), but still useful! --- Makefile | 1 + usr/local/man/man1/newrepo.1 | 40 ++++++++++++++++++++++++++++++++++++++++ usr/local/man/man8/wggen.8 | 2 +- 3 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 usr/local/man/man1/newrepo.1 diff --git a/Makefile b/Makefile index a72bd24..44c1e89 100644 --- 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 new file mode 100644 index 0000000..7bb2643 --- /dev/null +++ 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/.git" +.It Pa $HOME/git/.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 index 3427f78..b3510e5 100644 --- 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 -- libgit2 1.1.1