todo-mode: Todo Mode Entry Points

 
 2 Todo Mode Entry Points
 ************************
 
 To initialize your first todo file, invoke the command ‘todo-show’.
 This prompts you for a file name (defaulting to the value of
 ‘todo-initial-file’), prompts you for the name of the first category
 (defaulting to the value of ‘todo-initial-category’), creates and visits
 the file and displays the category in Todo mode, and then prompts you to
 enter the first item.  If you choose not to enter an item now, simply
 type ‘C-g’, which leaves the category empty but otherwise well-formed.
 If you prefer not to be prompted to enter an item on adding a new
 category, disable the option ‘todo-add-item-if-new-category’.
 
    Once at least one todo file exists, invoking ‘todo-show’ enters Todo
 mode.  Invoked with a prefix argument, the command prompts for which
 todo file to visit.  Otherwise, the first invocation of this command
 after loading the Todo mode package visits the default todo file (option
 ‘todo-default-todo-file’) and shows its first category.  (You can get a
 different display with the first invocation of ‘todo-show’ by
 customizing the option ‘todo-show-first’; SeeTodo Categories Mode
 and SeeFiles of Filtered Items.)
 
    If you leave Todo mode and later invoke ‘todo-show’ to re-enter it,
 by default this returns you to the current (i.e., last displayed)
 category of the current todo file, which is the one in the most recently
 selected and still live buffer visiting a todo file.  If you disable the
 option ‘todo-show-current-file’, then non-initial invocations of
 ‘todo-show’ always return to the first or current category of the
 default todo file.
 
    If you want to enter Todo mode and go directly to a specific category
 instead the first or current category in the current or default todo
 file, use the command ‘todo-jump-to-category’; SeeNavigation, for
 details.  You can also enter Todo mode by invoking the command
 ‘todo-insert-item’; SeeInserting New Items, for details.
 
    The most convenient way to use these commands to enter Todo mode is
 to define global key bindings for them in your init file.  Good choices
 are ‘C-c t’ for ‘todo-show’, ‘C-c j’ for ‘todo-jump-to-category’ and
 ‘C-c i’ for ‘todo-insert-item’, since these commands are bound to ‘t’,
 ‘j’ and ‘i’, respectively, in Todo mode.
 
    You can leave Todo mode by typing ‘q’ (‘todo-quit’), which buries the
 current todo file buffer.  Doing this also saves any changes you have
 made to the file, and leaves both the file and the category that was
 displayed on quitting current for subsequent Todo mode commands (unless
 the buffer made current by quitting is visiting another file and
 category in Todo mode, in which case the latter become current for Todo
 mode commands).