From: Tomas Babej Date: Mon, 19 Jan 2015 17:45:53 +0000 (+0100) Subject: Added README X-Git-Url: https://git.madduck.net/etc/taskwarrior.git/commitdiff_plain/73846d7c0822f4547966a9b433a845f1eea422b7?ds=inline;hp=-c;pf=etc Added README --- 73846d7c0822f4547966a9b433a845f1eea422b7 diff --git a/README.md b/README.md new file mode 100644 index 0000000..2103e72 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +Taskwarrior Shift All Recurrence Attributes Hook +------------------------------------------------ + +This is a hook for TaskWarrior (http://www.taskwarrior.org), +which allow your recurrent tasks to inherit ``wait``, ``scheduled`` +and ``until`` attributes from the parent. + +Install +------- + +``` +git clone https://github.com/tbabej/taskwarrior-shift-all-recurrence-hook.git +cp taskwarrior-shift-all-recurrence-hook/on-* ~/.task/hooks/ +``` + +This hook leverages tasklib, so you need to install that too: + +``` +pip install tasklib +``` + +Use case +-------- + +Consider you have a periodic task, which is valid only for the certain day, +e.g. on every Sunday you go running. + +``` +$ task add due:sunday recur:weekly +``` + +However, TaskWarrior will display the task right away, and you want to +showing up only during the weekend, so that it does not distract your task +list during the work week. + +If you try to add the recurrence again, this time with ``wait`` attribute, +to hide the task until it is not relevant for you: + +``` +$ task add due:sunday recur:weekly wait:saturday +``` + +You will find out that TaskWarrior does not let tasks generated by this +recurrence inherit the ``wait`` attribute, in the same manner as it does +with the ``due`` attribute. + +This hook solves that.