From bf83ed969533d0c62b8f3985a3aa52306fd1ec24 Mon Sep 17 00:00:00 2001 From: Aurélien DESBRIÈRES Date: Wed, 4 Jun 2014 14:17:14 +0200 Subject: mycron-git --- pcr/mycron-git/PKGBUILD | 56 +++++++++++++++++++++------------------------- pcr/mycron-git/mycron.1 | 59 +++++++++++++++++++++++++++++++++++++++++++++++++ pcr/mycron-git/mycron.5 | 58 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 142 insertions(+), 31 deletions(-) create mode 100644 pcr/mycron-git/mycron.1 create mode 100644 pcr/mycron-git/mycron.5 (limited to 'pcr') diff --git a/pcr/mycron-git/PKGBUILD b/pcr/mycron-git/PKGBUILD index c80b79b1d..d9eb795b6 100644 --- a/pcr/mycron-git/PKGBUILD +++ b/pcr/mycron-git/PKGBUILD @@ -1,12 +1,14 @@ -# Contributor (Arch): Dirk Sohler -# Maintainer : Parabola GNU / Linux-libre Aurelien Desbrieres +# Contributor (Arch) : Dirk Sohler +# Contributor (Arch) : Dirk Sohler +# Maintainer (Parabola): Aurélien DESBRIÈRES pkgname=mycron-git -pkgver=20121116 -pkgrel=1 +_gitname=mycron +pkgver=2.0.2 +pkgrel=2 pkgdesc='A standards compliant and convenient crontab management system.' -url='https://dev.0x7be.de/mycron' +url='http://dev.0x7be.de/mycron.html' arch=('any') license=('GPL') @@ -15,35 +17,27 @@ makedepends=('git') install=mycron.install -source=('mycron.install') -sha256sums=('a5406ae03412d3a1aaf6aadb902b4dd40bb6eadb21aa2ffb7c21ae95d656f598') +branch='master' +source=("git://github.com/dsohler/mycron.git#branch=$branch" + 'mycron.install' + 'mycron.1' + 'mycron.5') -_gitroot='https://github.com/dsohler/mycron' -_gitname='master' - -build() { - cd $srcdir - msg "Connecting to GIT server...." - - if [[ -d "$_gitname" ]]; then - cd "$_gitname" && git pull origin - msg "The local files are updated." - else - git clone "$_gitroot" "$_gitname" - fi - - msg "GIT checkout done or server timeout" - msg "Starting build..." - - rm -rf "$srcdir/$_gitname-build" - git clone "$srcdir/$_gitname" "$srcdir/$_gitname-build" +pkgver() { + cd "$srcdir/$_gitname" + echo $(sed -n "s/^progversion='\(.*\)'/\1/p" mycron.py) } package() { - cd "$srcdir/$_gitname-build" + cd "$srcdir/$_gitname" + _DOCPATH="usr/share/doc/mycron" + _MANPATH="usr/share/man" install -Dm 755 mycron.py $pkgdir/usr/bin/mycron - install -Dm 644 example-config.cfg \ - $pkgdir/usr/share/doc/mycron/example-config.cfg - install -Dm 644 example.crontab \ - $pkgdir/usr/share/doc/mycron/example.crontab + install -Dm 644 example-config.cfg $pkgdir/$_DOCPATH/example-config.cfg + install -Dm 644 example.crontab $pkgdir/$_DOCPATH/example.crontab + install -Dm 644 crontab.vim $pkgdir/$_DOCPATH/crontab.vim + install -Dm 644 ../mycron.1 $pkgdir/$_MANPATH/man1/mycron.1 + install -Dm 644 ../mycron.5 $pkgdir/$_MANPATH/man5/mycron.5 + gzip $pkgdir/$_MANPATH/man1/mycron.1 + gzip $pkgdir/$_MANPATH/man5/mycron.5 } diff --git a/pcr/mycron-git/mycron.1 b/pcr/mycron-git/mycron.1 new file mode 100644 index 000000000..daef28f6f --- /dev/null +++ b/pcr/mycron-git/mycron.1 @@ -0,0 +1,59 @@ +.TH mycron 1 "2013-01-13" 2.0.1 +.SH NAME +mycron - A standards compliant and convenient crontab management system. + +.SH SYNOPSIS +.B mycron +.RB [\| -h \|] +.RB [\| \-u +.IR C \|] +.RB [\| -e \|] +.RB [\| -l \|] +.RB [\| -s \|] +.RB [\| -c \|] +.RB [\| -n \|] +.RB [\| -p \|] +.RB [\| -x \|] + +.SH DESCRIPTION +mycron is not a cron service/daemon. You need an already set up cron service for using mycron in a reasonable way. You need to set up your cronie\-, dcron\-, vixie\-, whatever\-crontab to execute mycron every minute for taking full advantage of mycron’s crontabs. +.PP +mycron then replaces your regular crontab setup. It allows you to set up cronjobs in a completely new, but very convenient and standards compliant way and becomes your command center for managing, creating, editing and checking (multiple) crontabs. + +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show inline parameters help +.TP +\fB\-u\fR \fIC\fR, \fB\-\-use\fR=\fIC\fR +use crontab \fIC\fR instead of default crontab. You can combine this with all other parameters. +.TP +\fB\-e\fR, \fB\-\-edit\fR +edit crontab (either the default crontab or the one specified by \fB\-u\fR) +.TP +\fB\-s\fR, \fB\-\-show\fR +output a list showing all available crontabs, except x\- crontabs (see \fB\-x\fR for more details) +.TP +\fB\-c\fR, \fB\-\-check\fR +check the crontab for validity and show all lines that are invalid +.TP +\fB\-n\fR, \fB\-\-no\-colors\fR +don't use colored output +.TP +\fB\-e\fR, \fB\-\-print\-examples\fR +show a list of examples for mycron crontab entries +.TP +\fB\-x\fR, \fB\-\-x\-crontabs\fR +show development crontabs, too. Development crontabs start with \fBx-\fR and are hidden by default when using \fB-s\fR. + +.SH BUGS +Please desist from using non-ASCII characters like German umlauts, other special symbols, etc. It will not break mycron or it's validity check, but fails on mycron actually executed by your cron daemon. + +.SH FULL DOCUMENTATION +The full documentation of \fBmycron\fR is available online at . In case of differences the documentation available online is to be looked upon as the more current version. + +.SH AUTHOR +Dirk Sohler, + +.SH SEE ALSO +mycron(5), crontab(1) diff --git a/pcr/mycron-git/mycron.5 b/pcr/mycron-git/mycron.5 new file mode 100644 index 000000000..6dbff6a0e --- /dev/null +++ b/pcr/mycron-git/mycron.5 @@ -0,0 +1,58 @@ +.TH mycron 5 "" "" "MYCRON FILE FORMAT" +.SH NAME +mycron \- special crontab syntax explaination + +.SH DESCRIPTION +\fBmycron\fRs crontab syntax differs from the usual crontab syntax a lot. Of course you have the date/time part and the command, but the definitions are ISO 8601 valid using a dot (\fB.\fR) as wildcard character. + +.SH LOCATION +Crontabs have to be stored at \fB${HOME}/.config/mycron/crontabs\fR with file suffix \fB.crontab\fR for \fBmycron\fR to recognize them. Crontab file names should not contain slashes and should not be longer than 20 characters. The default crontab is \fBdefault.crontab\fR. + +.SH SYNTAX +.TP +\fBDate/Time format\fR +ISO 8601 specifies day/time notation with time zone. Because \fBmycron\fR is only exact to the minute (as long as there is no cron deamon that uses seconds as smallest unit), seconds and time zone are omitted. Set the date with \fBYYYY-MM-DD\fRT\fBHH:MM\fR where \fBYYYY\fR is the year, \fBMM\fR is the month, \fBDD\fR is the day, \fBHH\fR is the hour in 24h format and \fBMM\fR is the minute. For every single digit you can input a \fB.\fR (a single colon) as wildcard. +.TP +\fBDay of the week\fR +ISO 8601 specifies Monday as first day of the week and Sunday as last day of the week, therefore \fBMonday is 1\fR, \fBThursday is 2\fR, ..., \fBSunday is 7\fR. If you use \fB.\fR (a single colon), \fBmycron\fR interprets it as "every day". +.TP +\fBCommand\fR +The last of the three blocks is the command block. Here you can use whatever you want. Please desist from using non-ASCII characters like German umlauts, other special symbols, etc. It will not break mycron or it's validity check, but fails on mycron actually executed by your cron daemon. +.TP +\fBComments\fR +Comments are indicated by using \fB#\fR in the beginning of a line. It might work in most cases but you should not rely on comments after some actual crontab entries. (End-of-line comments) + +.SH EXAMPLES +.TP +\fB....-..-..T..:.. . command\fR +This line executes the command every minute at every day. +.TP +\fB....-..-..T18:57 7 command\fR +Here the command gets executed every Sunday at 18:57 o'clock. +.TP +\fB....-..-..T07:38 1267 command\fR +When given multiple digits for the day, the command gets executed on all of the days. Here on Mondays, Tuesdays, Saturdays and Sundays at 07:38 o'clock. +.TP +\fB2013-05-..T..:00 4 command\fR +This very specific line results in execution of the given command on every full hour at every Friday in May 2013. +.TP +\fB....-12-..T14:.. . command\fR +The command will be executed every minute from 14:00 to 14:59 o'clock on everyday in every December. +.TP +\fB2018-01-14T10:45 2 command\fR +Because 2018-01-14 is a Sunday (7) this command will \fBnever\fR be executed :) + +.SH FILES +.TP +\fBExample files\fR +/usr/share/doc/mycron/example-config.cfg +/usr/share/doc/mycron/example.crontab +.TP +\fBVim syntax file\fR +/usr/share/doc/mycron/crontab.vim + +.SH AUTHOR +Dirk Sohler, + +.SH SEE ALSO +mycron(1) -- cgit v1.2.3-54-g00ecf