NAME

Taskwarrior::Kusarigama::Plugin::Renew - create a follow-up task upon completion

VERSION

version 0.3.0

DESCRIPTION

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.

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

$ 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.

$ 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

AUTHOR

Yanick Champoux <yanick@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 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.