Next: , Previous: , Up: Todo Mode User Manual   [Contents]

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; see Todo Categories Mode and Files 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; Navigation, for details. You can also enter Todo mode by invoking the command todo-insert-item; Inserting 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).

Next: Key Binding Conventions, Previous: Overview, Up: Todo Mode User Manual   [Contents]