6.2.1.4 Cyclic Tasks

If there are tasks that you have to do regularly, you can have Planner schedule those tasks automatically.

Make sure that planner-cyclic.el is in your load path and add this to your .emacs (or _emacs):

     (require 'planner-cyclic)

Create a diary file named ~/.diary.cyclic-tasks (or the value of planner-cyclic-diary-file). Here is an example:

     Tuesday #B0 _ Study Japanese
     Friday #B0 _ Study Japanese (JapaneseStudies)

The first will be a plain task, the second will be linked. The first line will automatically create its task every Tuesday, while the second will create it every Friday.

You can schedule tasks in a variety of ways. This module uses the same syntax for specifying when tasks will be scheduled as the Emacs diary uses for appointments and events. See the GNU Emacs Manual, and the GNU Emacs Lisp Reference Manual, for a full description of the possibilities.

By default, planner-cyclic creates multiple tasks if you let tasks build up (that is, the next Tuesday rolls around and you still haven't marked the task as done.) To turn off this behavior:

     (setq planner-cyclic-diary-nag nil)

Functions

planner-cyclic-diary includes the following interactive functions: