todo-show-categories-table

todo-show-categories-table is an interactive compiled Lisp function in `todo-mode.el'.


(todo-show-categories-table)

Display a table of the current file's categories and item counts.

In the initial display the lines of the table are numbered,
indicating the current order of the categories when sequentially
navigating through the todo file with `M-x todo-forward-category'
and `M-x todo-backward-category'. You can reorder the lines, and
hence the category sequence, by typing `M-x todo-raise-category'
or `M-x todo-lower-category' to raise or lower the category at
point, or by typing `M-x todo-set-category-number' and entering a
number at the prompt or by typing `M-x todo-set-category-number'
with a numeric prefix. If you save the todo file after
reordering the categories, the new order persists in subsequent
Emacs sessions.

The labels above the category names and item counts are buttons,
and clicking these changes the display: sorted by category name
or by the respective item counts (alternately descending or
ascending). In these displays the categories are not numbered
and `M-x todo-set-category-number', `M-x todo-raise-category' and
`M-x todo-lower-category' are disabled. (Programmatically, the
sorting is triggered by passing a non-nil SORTKEY argument.)

In addition, the lines with the category names and item counts
are buttonized, and pressing one of these button jumps to the
category in Todo mode (or Todo Archive mode, for categories
containing only archived items, provided user option
`todo-skip-archived-categories' is non-nil. These categories
are shown in `todo-archived-only' face.