[Pkg-cron-devel] [pkg-cron] 06/12: Add documentation comments similarly as to how Fedora / Red Hat Enterprise Linux documents (crontab package). This comments more descriptive and provides inexperienced users with a better understanding of the syntax. (Closes:

[Javier Fernandez-Sanguino Peña]

This is an automated email from the git hooks/post-receive script.

jfs pushed a commit to branch master
in repository pkg-cron.

commit 35aaf69c0746d471474280986e532860659394da
Author: Javier Fernandez-Sanguino <jfs at debian.org>
Date:   Mon Mar 12 23:20:05 2018 +0100

    Add documentation comments similarly as to how Fedora / Red Hat Enterprise
    Linux documents (crontab package). This comments more descriptive and provides
    inexperienced users with a better understanding of the syntax.  (Closes:
---
 crontab.5           | 7 +++++++
 debian/crontab.main | 9 ++++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/crontab.5 b/crontab.5
index 141f6b5..a1edc5b 100644
--- a/crontab.5
+++ b/crontab.5
@@ -295,6 +295,13 @@ user's crontab, this file has the username field, as used by /etc/crontab.
 SHELL=/bin/sh
 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
 
+# Example of job definition:
+# .---------------- minute (0 - 59)
+# |  .------------- hour (0 - 23)
+# |  |  .---------- day of month (1 - 31)
+# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
+# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
+# |  |  |  |  |
 # m h dom mon dow user	command
 17 * * * *  root  cd / && run-parts \-\-report /etc/cron.hourly
 25 6 * * *  root  test \-x /usr/sbin/anacron || ( cd / && run-parts \-\-report /etc/cron.daily )
diff --git a/debian/crontab.main b/debian/crontab.main
index 95edd9b..c89cc0b 100644
--- a/debian/crontab.main
+++ b/debian/crontab.main
@@ -7,7 +7,14 @@
 SHELL=/bin/sh
 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
 
-# m h dom mon dow user	command
+# Example of job definition:
+# .---------------- minute (0 - 59)
+# |  .------------- hour (0 - 23)
+# |  |  .---------- day of month (1 - 31)
+# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
+# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
+# |  |  |  |  |
+# *  *  *  *  * user-name command to be executed
 17 *	* * *	root    cd / && run-parts --report /etc/cron.hourly
 25 6	* * *	root	test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )
 47 6	* * 7	root	test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-cron/pkg-cron.git