todo-mode: Todo Filtered Items Mode Commands
10.2 Todo Filtered Items Mode Commands
======================================
The output of the item filtering commands looks similar to a regular
Todo category, but it is not contained in any todo file and does not
have a name on being created, so it is not a “real” category but a
“virtual” category. Another difference is the lack of a done items
section; either there are no done items in the list (when the filtered
items are diary or top priority items), or these are displayed in the
same list as todo items (if you filtered by regular expression and
allowed done items). A further difference is that the items have an
additional header, between the item’s date/time header and its text,
specifying which category (and if you invoked a multifile command, also
which file) the item comes from, and if you filtered by regular
expression, also whether the item comes from a Todo archive.
The sequential item navigation commands ‘n’ and ‘p’ work the same in
Todo Filtered Items mode as in Todo mode, as do the file and category
jumping commands ‘t’ and ‘j’; however, the sequential category
navigation commands are unavailable, since virtual categories of
filtered items are not ordered with respect to “real” categories. In
addition, Todo Filtered Items mode provides a special navigation
command:
‘g’
‘<RET>’
If you type this command (‘todo-go-to-source-item’) with point on a
filtered item, the buffer switches to the item’s source file (in
Todo mode or Todo Archive mode, as the case may be) and displays
its category, with point on the item.
Filtered items cannot be textually edited, moved to another category,
marked done or archived like items in a real todo category, since these
would then be out of synch with each other. But there is one type of
editing command that does work in Todo Filtered Items mode: changing an
item’s priority:
‘r’
‘l’
‘#’
These commands raise, lower, or set, respectively, the current
item’s priority in the virtual category.
Using these commands, you can create a cross-category (and even
cross-file) prioritized list of filtered items. However, there is a
restriction on these commands in Todo Filtered Items mode: you cannot
change the relative priorities of items from the same real category,
since that would make the filtered list inconsistent with the source
todo list.