Taskwarrior::Kusarigama::Plugin::Renew - create a follow-up task upon completion
version 0.5.0
The native recurring tasks in Taskwarrior create new tasks after a given lapse of time, no matter if the already-existing task was completed or not.
This type of recurrence will create a new instance of the task upon the completion of the previous one. This is useful for tasks where having hard-set periods don't make sense (think 'watering the plants').
Note that no susbequent task is created if a task is deleted instead of completed.
The plugin creates 3 new UDAs. renew, a boolean indicating that the task should be renewing, rdue, the formula for the new due date and rwait, the formula for the date at which the new task should be unhidden.
renew
rdue
rwait
rdue is required, and renew and rwait are both optional.
Since the waiting period is often dependent on the due value, as a convenience if the string due is found in rwait, it will be substitued by the rdue value. So
due
$ task add rdue:now+1week rwait:-3days+due Do Laundry # equivalent to $ task add rdue:now+1week rwait:now+1week-3days Do Laundry
Why -3days+due and not due-3days? Because it seems that task does some weeeeeird parsing with due.
-3days+due
due-3days
task
$ task add project:due-b Do Laundry Cannot subtract strings
(see https://bug.tasktools.org/browse/TW-1900)
$ task add water the plants rdue:now+5d rwait:now+4d
Yanick Champoux <yanick@cpan.org>
This software is copyright (c) 2017 by Yanick Champoux.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
1 POD Error
The following errors were encountered while parsing the POD:
Unknown directive: =head
To install Taskwarrior::Kusarigama, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Taskwarrior::Kusarigama
CPAN shell
perl -MCPAN -e shell install Taskwarrior::Kusarigama
For more information on module installation, please visit the detailed CPAN module installation guide.