8.1 Table of Item Counts

Above each column of the table is a labeled button you can press by clicking with the mouse or by typing RET on it. Pressing an item count button sorts the table alternately in ascending or descending order according to the type of count. Pressing the category button alternates between the initial numerical order of the categories and alphabetical order. In numerical order the column of category names is preceded by a column containing the corresponding category numbers; this column is not displayed in the alphabetical listing. Instead of pressing the buttons, you can also sort the table by typing the following keys:

Each row of the table is also buttonized; pressing one of these exits the buffer (killing it), returns to the buffer of the file from which you had invoked F c, and displays the category that was named in the row button you pressed (i.e., pressing this button jumps to that category). However, if the category named in the row is in a todo file and all of its items have been archived, and you have enabled the option todo-skip-archived-categories, then pressing the button jumps to the archive category instead of the empty todo category. You can recognize such categories by their items counts in the table—all columns but the archived one have counts of zero—and in addition, their lines in the table are also distinguished from the others by a different face (see Faces).

You can navigate around the table:


Advance point to the next button.


Put point on the previous button.

These commands are cyclic, e.g., when point is on the last button, pressing n moves it to the first button.

Typing q exits Todo Categories mode, killing the buffer and returning to the current category in the Todo mode or Todo Archive mode buffer from which you had invoked F c.