todo-mode: Table of Item Counts

 
 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:
 
    • ‘c’ to sort by category numerically or alphabetically;
    • ‘t’ to sort by todo item counts;
    • ‘y’ to sort by diary item counts;
    • ‘d’ to sort by done item counts;
    • ‘a’ to sort by archived item counts.
 
    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:
 
 ‘n’
 ‘<TAB>’
      Advance point to the next button.
 
 ‘p’
 ‘S-<TAB>’
      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’.