- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

5.1 Basic TODO functionality

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:

C-c C-t
Rotate the TODO state of the current item among
,-> (unmarked) -> TODO -> DONE --.
The same rotation can also be done “remotely” from the timeline and agenda buffers with the t command key (see section 10.5 Commands in the agenda buffer).
C-u C-c C-t
Select a specific keyword using completion or (if it has been set up) the fast selection interface. For the latter, you need to assign keys to TODO states, see section 5.2.5 Setting up keywords for individual files, and section 6.2 Setting tags, for more information.
Select the following/preceding TODO state, similar to cycling. Useful mostly if more than two TODO states are possible (see section 5.2 Extended use of TODO keywords). See also section 16.10.2 Packages that lead to conflicts with Org-mode, for a discussion of the interaction with shift-selection-mode. See also the variable org-treat-S-cursor-todo-selection-as-state-change.
C-c / t
View TODO items in a sparse tree (see section 2.6 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 will be 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 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.
C-c a t
Show the global TODO list. Collects the TODO items (with not-DONE states) from all agenda files (see section 10 Agenda views) into a single buffer. The new buffer will be in agenda-mode, which provides commands to examine and manipulate the TODO entries from the new buffer (see section 10.5 Commands in the agenda buffer). See section 10.3.2 The global TODO list, for more information.
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.

ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition