Next: TODO Extensions, Up: TODO Items [Contents][Index]
Any headline becomes a TODO item when it starts with the word ‘TODO’, for example:
*** TODO Write letter to Sam Fortune
The most important commands to work with TODO entries are:
org-todo
)Rotate the TODO state of the current item among
,-> (unmarked) -> TODO -> DONE --. '--------------------------------'
If TODO keywords have fast access keys (see Fast access to TODO states), prompt for a TODO keyword through the fast
selection interface; this is the default behavior when
org-use-fast-todo-selection
is non-nil
.
The same rotation can also be done “remotely” from the agenda buffer with the t command key (see Agenda Commands).
When TODO keywords have no selection keys, select a specific
keyword using completion; otherwise force cycling through TODO
states with no prompt. When org-use-fast-todo-selection
is set
to prefix
, use the fast selection interface.
Select the following/preceding TODO state, similar to cycling.
Useful mostly if more than two TODO states are possible (see
TODO Extensions). See also Conflicts, for a discussion of the interaction with
shift-selection-mode
. See also the variable
org-treat-S-cursor-todo-selection-as-state-change
.
org-show-todo-tree
)View TODO items in a sparse tree (see Sparse Trees). Folds
the entire buffer, but shows all TODO items—with not-DONE
state—and the headings hierarchy above them. With a prefix
argument, or by using C-c / T, search for a specific
TODO. You are prompted for the keyword, and you can also give
a list of keywords like ‘KWD1|KWD2|...’ to list entries that
match any one of these keywords. With a numeric prefix argument
N, show the tree for the Nth keyword in the variable
org-todo-keywords
. With two prefix arguments, find all TODO
states, both un-done and done.
org-todo-list
)Show the global TODO list. Collects the TODO items (with not-DONE states) from all agenda files (see Agenda Views) into a single buffer. The new buffer is in Org Agenda mode, which provides commands to examine and manipulate the TODO entries from the new buffer (see Agenda Commands). See Global TODO list, for more information.
org-insert-todo-heading
)Insert a new TODO entry below the current one.
Changing a TODO state can also trigger tag changes. See the docstring
of the option org-todo-state-tags-triggers
for details.
Next: TODO Extensions, Up: TODO Items [Contents][Index]