From 4995fcc27538bade65fa54e1c42addd1932e8da2 Mon Sep 17 00:00:00 2001
From: Sami Kerola <kerolasa@iki.fi>
Date: Sun, 11 Jun 2017 15:37:24 +0100
Subject: [PATCH] cronnext: improve manual page

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
---
 man/cronnext.1 | 77 ++++++++++++++++++++++++++++----------------------
 1 file changed, 43 insertions(+), 34 deletions(-)

diff --git a/man/cronnext.1 b/man/cronnext.1
index 7d324b4..4a120f8 100644
--- a/man/cronnext.1
+++ b/man/cronnext.1
@@ -1,51 +1,60 @@
-.TH CRONNEXT 1 "Nov 30, 2015"
+.TH CRONNEXT 1 "2017-06-11" "cronie" "User Commands"
 .SH NAME
 cronnext \- time of next job cron will execute
 .SH SYNOPSIS
 .TP 9
 .B cronnext
-[-i users] [-e users] [-s] [-t time] [-v] [-h] [-V]
+[\fB-i \fIusers\fR] [\fB-e \fIusers\fR] [\fB-s\fR] [\fB-t \fItime\fR]
+[\fB-v\fR] [\fB-h\fR] [\fB-V\fR]
 .SH DESCRIPTION
-Determine the time cron will execute the next job.
-Without arguments, it prints that time considering all crontabs,
-in number of seconds since the Epoch.
-This number can be converted into other formats using date(1),
-like 'date --date @43243254'
+Determine the time cron will execute the next job.  Without arguments, it
+prints that time considering all crontabs, in number of seconds since the
+Epoch.  This number can be converted into other formats using
+.BR date (1),
+like
+.B date --date @43243254
 .SH OPTIONS
 .TP
--i user,user,user,...
-consider only the crontabs of these users;
-.br
-use "*system*" for the system crontab
+.BI "\-i " user,user,user,...
+Consider only the crontabs of the specified users.  Use
+.B *system*
+for the system crontab.
 .TP
--e user,user,user,...
-do not consider the crontabs of these users
+.BI "\-e " user,user,user,...
+Do not consider the crontabs of the specified users.
 .TP
--s
-do not consider the system crontab, usually /etc/crontab;
-.br
-the system crontab usually contains the hourly, daily, weekly and montly
-crontabs, which might be better dealt with anacron(8)
+.B \-s
+Do not consider the system crontab, usually
+.I /etc/crontab
+file.  The system crontab usually contains the hourly, daily, weekly and
+montly crontabs, which might be better dealt with
+.BR anacron (8).
 .TP
--t time
-determine the next job from this time, instead of now;
-.br
-the time is expressed in number of seconds since the Epoch, as obtained for
-example by 'date +%s --date "now + 2 hours"'
+.BI "\-t " time
+Determine the next job from this time, instead of now.  The time is
+expressed in number of seconds since the Epoch, as obtained for example by
+.BR "date +%s --date \(dqnow + 2 hours\(dq" .
 .TP
--v
-verbose mode: scanning the crontab is done in verbose mode, and for each user
-and job the next execution time is printed both as number of seconds since the
-Epoch and in the standard format
+.B \-v
+Scanning of the crontab is done in verbose mode.  Each user and job the next
+execution time is printed both as number of seconds since the Epoch and in
+the standard format.
 .TP
--h
-summary of options
+.B \-h
+Print usage output and exit.
 .TP
--V
+.B \-V
 Print version and exit.
 .SH AUTHOR
-Marco Migliori <sgerwk@aol.com>
+.MT sgerwk@aol.com
+Marco Migliori
+.ME
 .SH SEE ALSO
-cron(8), cron(1), crontab(5), crontab(1), anacron(8), anacrontab(5), atq(1),
-date(1)
-
+.BR cron (8),
+.BR cron (1),
+.BR crontab (5),
+.BR crontab (1),
+.BR anacron (8),
+.BR anacrontab (5),
+.BR atq (1),
+.BR date (1)
-- 
2.40.0