Change timefile calculations to respect slack

[user/henk/code/snooze.git] / snooze.1

diff --git a/snooze.1 b/snooze.1
index 265d0fc4cdd8d8f327568d90190c08807af36bbb..67e008e6c631f3b9711c3b69df2b912b73961b3b 100644 (file)
--- a/snooze.1
+++ b/snooze.1
@@ -10,6 +10,7 @@
 .Op Fl t Ar timefile
 .Op Fl T Ar timewait
 .Op Fl R Ar randdelay
+.Op Fl J Ar jitter
 .Op Fl s Ar slack
 .Op Fl d Ar day
 .Op Fl m Ar mon
@@ -38,9 +39,13 @@ Verbose: print scheduled (and rescheduled) times.
 See below,
 .Sx TIMEFILES .
 .It Fl R
-Wait randomly up to
+Delay determination of scheduled time randomly up to
 .Ar randdelay
-seconds later than the scheduled time.
+seconds later.
+.It Fl J
+Delay execution randomly up to
+.Ar jitter
+seconds later than scheduled time.
 .It Fl s
 Commands are executed even if they are
 .Ar slack
@@ -67,14 +72,14 @@ The remaining arguments are patterns for the time fields:
 .Bl -tag -compact -width xxxxxxxxxx
 .It Fl d
 day of month
-.It Fl n
+.It Fl m
 month
 .It Fl w
 weekday (0-7, sunday is 0 and 7)
 .It Fl D
-day of year
+day of year (1..366)
 .It Fl W
-ISO week of year (0..53)
+ISO week of year (1..53)
 .It Fl H
 hour
 .It Fl M
@@ -116,11 +121,15 @@ where either day of month
 day of week matches), so
 .Cm -w5 -d13
 only runs on Friday the 13th.
+.Pp
+If
+.Nm
+receives a
+.Dv SIGALRM
+signal, the command is immediately executed.
 .Sh TIMEFILES
 Optionally, you can keep track of runs in time files, using
-.Fl t
-and optionally
-.Fl T :
+.Fl t :
 .Pp
 When
 .Fl T
@@ -171,12 +180,12 @@ If no command was given,
 .Nm
 just returns with status 0.
 .Sh SEE ALSO
+.Xr runwhen 1 ,
 .Xr sleep 1 ,
-.Xr cron 8 ,
-runwhen,
-uschedule
+.Xr uschedule 1 ,
+.Xr cron 8
 .Sh AUTHORS
-.An Christian Neukirchen Aq Mt chneukirchen@gmail.com
+.An Leah Neukirchen Aq Mt leah@vuxu.org
 .Sh LICENSE
 .Nm
 is in the public domain.