- 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.4 Priorities

If you use Org-mode extensively, you may end up with enough TODO items that it starts to make sense to prioritize them. Prioritizing can be done by placing a priority cookie into the headline of a TODO item, like this

*** TODO [#A] Write letter to Sam Fortune

By default, Org-mode supports three priorities: ‘A’, ‘B’, and ‘C’. ‘A’ is the highest priority. An entry without a cookie is treated just like priority ‘B’. Priorities make a difference only for sorting in the agenda (see section 10.3.1 The weekly/daily agenda); outside the agenda, they have no inherent meaning to Org-mode. The cookies can be highlighted with special faces by customizing the variable org-priority-faces.

Priorities can be attached to any outline node; they do not need to be TODO items.

C-c ,
Set the priority of the current headline. The command prompts for a priority character ‘A’, ‘B’ or ‘C’. When you press SPC instead, the priority cookie is removed from the headline. The priorities can also be changed “remotely” from the timeline and agenda buffer with the , command (see section 10.5 Commands in the agenda buffer).
Increase/decrease priority of current headline.(43) Note that these keys are also used to modify timestamps (see section 8.2 Creating timestamps). See also section 16.10.2 Packages that lead to conflicts with Org-mode, for a discussion of the interaction with shift-selection-mode.

You can change the range of allowed priorities by setting the variables org-highest-priority, org-lowest-priority, and org-default-priority. For an individual buffer, you may set these values (highest, lowest, default) like this (please make sure that the highest priority is earlier in the alphabet than the lowest priority):

ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition