Next: , Previous: Viewing Tasks, Up: Organizing Your Tasks


6.2.2.3 Modifying Tasks

To select a task, move your cursor to the line containing the task.

Change a task's priority (‘A’, ‘B’ or ‘C’) by editing the line. ‘#A’ tasks are important. ‘#B’ are medium priority. ‘#C’ are low priority. Whenever you save the file or call M-x planner-fix-tasks, tasks are sorted and numbered according to priority and status.

Change a task's status by calling one of the following functions:

After changing the status using a function, look at the ‘TaskPool’ plan page. The task is also updated on the linked page. If you changed the task status manually by replacing the status with another character, you will need to call planner-update-task to update the linked page.

To reschedule a task, call planner-copy-or-move-task (C-c C-c) and choose a new date. You can mark a region and type M-x planner-copy-or-move-region to reschedule all the contained tasks to a different date. Enter ‘nil’ for the date if you don't want the task or group of tasks to appear on any date page at all anymore. This is a good way to “de-schedule” a task for the time being, but still keep it linked to a plan page for possible future scheduling.

To change the plan page associated with a task, call planner-replan-task. Enter ‘nil’ for the plan page if you don't want the task to appear on any plan page anymore. If you precede the command with a prefix argument, the text of the original plan page will appear in the prompt for easy editing.

Since the same task may exist on two or more pages, such as a date page and a plan page, it is dangerous to edit the description of the task by hand. You should not do it unless you want to make the exact same changes on all its linked pages.

Instead of doing this by hand, you should use planner-edit-task-description. This will prompt you for the changes to the task description and then update all the other pages to which the task is linked. Or, you can just use planner-delete-task to remove the task from both pages, and then create it again with the new desired description.

To remind yourself to do tasks in a certain order, simply edit the lines so that they're in the order you want. planner-raise-task and planner-lower-task update the priorities on linked pages automatically. You can organize tasks into groups by putting a blank line between groups of tasks. Planner will maintain the groupings and only sort the tasks within that group.

Functions

— Function: planner-replan-task page-name

Change or assign the plan page for the current task. page-name is the new plan page for the task. Use planner-copy-or-move-task if you want to change the date. With a prefix, provide the current link text for editing.

— Function: planner-raise-task-priority

Change a low-priority task to a medium-priority task and a medium-priority task to a high-priority task (C to B to A).

— Function: planner-lower-task-priority

Change a high-priority task to a medium-priority task and a medium-priority task to a low-priority task (A to B to C).

— Function: planner-raise-task arg

Move a task up arg steps. By default, arg is 1.

— Function: planner-lower-task arg

Move a task down arg steps. By default, arg is 1.

— Function: planner-edit-task-description description

Change the description of the current task, updating the linked page if any.

— Function: planner-delete-task

Delete this task from the current page and the linked page.

— Function: planner-update-task

Update the current task's priority and status on the linked page. Tasks are considered the same if they have the same description. This function allows you to force a task to be recreated if it disappeared from the associated page.

Note that the text of the task must not change. If you want to be able to update the task description, see planner-edit-task-description or planner-id.el.

See planner-install-extra-task-keybindings for additional task-related shortcuts.