todo-mode: Files of Filtered Items
10.3 Files of Filtered Items
============================
Typing ‘s’ in Todo Filtered Items mode saves the buffer of filtered
items to a file in ‘todo-directory’. Files of items filtered by regular
expression have the extension ‘.todr’, those with filtered diary items
have the extension ‘.tody’ and those with filtered top priorities have
the extension ‘.todt’. The extensions are added automatically the first
time you save the buffer to a file.
With filtered top priority or diary items, the file is automatically
named on first saving it, using as the base name either the same base
name as the single todo file it was generated from, or combining the
base names of the todo files used in multifile filtering commands. With
items filtered by regular expression, it can be useful to save separate
lists generated from the same file(s) using different regular
expressions, so when saving such a list, you are prompted for a short
identifying string to add to the file name.
When you invoke one of the item filtering commands without a prefix
argument and a corresponding file already exists, the command visits
this file (if, for the current file or chosen files, there are multiple
files of items filtered by regular expression, you are prompted to
choose one). To force generation of a new filtered list, invoke the
command with a prefix argument (in the case of top priority items,
either numeric as described above, or the raw prefix argument ‘C-u’ to
use the values of ‘todo-top-priorities-overrides’ or
‘todo-top-priorities’).
Aside from explicitly invoking an item filtering command to display a
saved list of items filtered by a given method from given todo files,
there are two other ways to visit a saved file of filtered items. You
can invoke a command similar to ‘find-file’:
‘F f’
Visit a saved file of filtered items, which you choose via
minibuffer completion (‘todo-find-filtered-items-file’).
Alternatively, as with tables of categories, by customizing
‘todo-show-first’ you can have the first invocation of ‘todo-show’ for a
given todo file display the corresponding saved file of filtered items.
If there is no saved filtered items list for the file, ‘todo-show’
simply defaults to visiting the file and displaying its first category,
as usual.
The command ‘F k’ (File Editing) is also available in Todo
Filtered Items mode. It deletes the current filtered items file.