From fd25c666d57fb9a7c0da58620a7cc768c7aa743e Mon Sep 17 00:00:00 2001
From: "C. McEnroe" <june@causal.agency>
Date: Thu, 25 Feb 2021 15:42:24 -0500
Subject: Add catsit-watch utility

---
 catsit-watch.1 | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 catsit-watch.1

(limited to 'catsit-watch.1')

diff --git a/catsit-watch.1 b/catsit-watch.1
new file mode 100644
index 0000000..b45f704
--- /dev/null
+++ b/catsit-watch.1
@@ -0,0 +1,52 @@
+.Dd February 25, 2021
+.Dt CATSIT-WATCH 1
+.Os
+.
+.Sh NAME
+.Nm catsit-watch
+.Nd run command when files are modified
+.
+.Sh SYNOPSIS
+.Nm
+.Op Fl i
+.Op Fl f Ar file
+.Ar command ...
+.
+.Sh DESCRIPTION
+The
+.Nm
+utility runs a command
+each time any of a set of files
+are modified.
+If any watched files are removed
+or if the command exits non-zero,
+.Nm
+exits.
+.
+.Pp
+The arguments are as follows:
+.Bl -tag -width Ds
+.It Fl f Ar file
+Add
+.Ar file
+to the set of watched files.
+.It Fl i
+Run the command once initially,
+before watching files.
+.El
+.
+.Sh EXIT STATUS
+If any watched files are removed,
+.Nm
+exits with
+.Dv EX_TEMPFAIL
+(75).
+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