From 69c1b1b2acc018fe7342106543de2ca19688b225 Mon Sep 17 00:00:00 2001
From: "C. McEnroe" <june@causal.agency>
Date: Thu, 25 Feb 2021 19:45:56 -0500
Subject: Add catsit-timer utility

---
 catsit-timer.1 | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 catsit-timer.1

(limited to 'catsit-timer.1')

diff --git a/catsit-timer.1 b/catsit-timer.1
new file mode 100644
index 0000000..9ad8956
--- /dev/null
+++ b/catsit-timer.1
@@ -0,0 +1,62 @@
+.Dd February 25, 2021
+.Dt CATSIT-TIMER 1
+.Os
+.
+.Sh NAME
+.Nm catsit-timer
+.Nd run command at interval
+.
+.Sh SYNOPSIS
+.Nm
+.Ar interval
+.Ar command ...
+.
+.Sh DESCRIPTION
+The
+.Nm
+utility runs a command
+at an interval.
+The command is run once immediately,
+then again every
+.Ar interval
+after waiting for the command to exit
+each time.
+The
+.Nm
+utility is not appropriate
+for scheduling commands
+to run at specific times.
+.
+.Pp
+The format of the
+.Ar interval
+specifier is a series of integers
+followed by units:
+.Cm s
+for seconds,
+.Cm m
+for minutes
+and
+.Cm h
+for hours.
+An integer with no unit
+is assumed to be in seconds.
+The
+.Ar interval
+is the sum of each
+integer-unit pair.
+For example,
+.Cm 1m30s
+is equivalent to
+.Cm 90s .
+.
+.Sh EXIT STATUS
+If the command exits non-zero,
+.Nm
+exits with the same status.
+.
+.Sh SEE ALSO
+.Xr catsitd 8
+.
+.Sh AUTHORS
+.An June Bug Aq Mt june@causal.agency
-- 
cgit 1.4.1