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
:
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 (see File Editing and Todo Edit Mode) is also available in Todo Filtered Items mode. It deletes the current filtered items file.