Next: Key Binding Conventions, Previous: Overview, Up: Top [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: Top [Contents]