From 257b9b25ff895e342af9bb9d35f07a816421af02 Mon Sep 17 00:00:00 2001 From: Aki Date: Sat, 6 Jan 2024 00:23:27 +0100 Subject: Tweak and add manpages even if too simple --- Makefile | 3 +++ mirror.1 | 7 ++++--- mirror.service.8 | 17 +++++++++++++++++ mirror.timer.8 | 1 + 4 files changed, 25 insertions(+), 3 deletions(-) create mode 100644 mirror.service.8 create mode 100644 mirror.timer.8 diff --git a/Makefile b/Makefile index 15661a0..e947e18 100644 --- a/Makefile +++ b/Makefile @@ -4,6 +4,7 @@ DATADIR?=$(PREFIX)/share MANDIR?=$(DATADIR)/man MAN1DIR?=$(MANDIR)/man1 MAN5DIR?=$(MANDIR)/man5 +MAN8DIR?=$(MANDIR)/man8 LIBDIR?=$(PREFIX)/lib SYSDDIR?=$(LIBDIR)/systemd/system USERSDIR?=$(LIBDIR)/sysusers.d @@ -21,6 +22,7 @@ install: all install -m755 -Dt $(DESTDIR)$(BINDIR) mirror install -m644 -Dt $(DESTDIR)$(MAN1DIR) mirror.1 install -m644 -Dt $(DESTDIR)$(MAN5DIR) mirror.5 + install -m644 -Dt $(DESTDIR)$(MAN8DIR) mirror.{timer,service}.8 install -m644 -Dt $(DESTDIR)$(SYSDDIR) mirror.{timer,service} install -m644 -Dt $(DESTDIR)$(USERSDIR) mirror.conf @@ -28,6 +30,7 @@ uninstall: rm -f $(DESTDIR)$(BINDIR)/mirror rm -f $(DESTDIR)$(MAN1DIR)/mirror.1 rm -f $(DESTDIR)$(MAN5DIR)/mirror.5 + rm -f $(DESTDIR)$(MAN8DIR)/mirror.{timer.service}.8 rm -f $(DESTDIR)$(SYSDDIR)/mirror.{timer,service} rm -f $(DESTDIR)$(USERSDIR)/mirror.conf diff --git a/mirror.1 b/mirror.1 index a19da7c..30b0061 100644 --- a/mirror.1 +++ b/mirror.1 @@ -2,11 +2,11 @@ .SH NAME mirror \- copies remote git repositories in bulk .SH SYNOPSIS -.SY mirror +.B mirror .RB [ -n ] .RI [ repositories ] -.SY mirror\ -v -.YS +.br +.B mirror -v .SH DESCRIPTION This script will read .I repositories @@ -30,5 +30,6 @@ Exit status is zero if all repositories in the list have been mirrored successfu option was used. If one or more mirrors fail or an unknown command-line option is provided, a non-zero status is returned. .SH SEE ALSO +.BR mirror.service (8), .BR mirror (5), .BR git (1) diff --git a/mirror.service.8 b/mirror.service.8 new file mode 100644 index 0000000..9204b99 --- /dev/null +++ b/mirror.service.8 @@ -0,0 +1,17 @@ +.TH mirror.service 8 "2024-01-05" +.SH NAME +mirror.service, mirror.timer - systemd unit files for automated git mirroring +.SH SYNOPSIS +.B /usr/lib/systemd/system/mirror.service +.br +.B /usr/lib/systemd/system/mirror.timer +.SH DESCRIPTION +Periodically run +.BR mirror (1) +by default in +.I /srv/mirror +with repositories list sourced from +.IR /srv/mirror/repositories.mirror . +.SH SEE ALSO +.BR mirror (1), +.BR mirror (5) diff --git a/mirror.timer.8 b/mirror.timer.8 new file mode 100644 index 0000000..7344b7d --- /dev/null +++ b/mirror.timer.8 @@ -0,0 +1 @@ +.so mirror.service.8 -- cgit v1.1