Function: todo-insert-item

todo-insert-item is an interactive and byte-compiled function defined in todo-mode.el.gz.

Signature

(todo-insert-item &optional ARG)

Documentation

Choose an item insertion operation and carry it out.

This inserts a new todo item into a category.

With no prefix argument ARG, add the item to the current category; with one prefix argument (C-u (universal-argument)), prompt for a category from the current todo file; with two prefix arguments (C-u (universal-argument) C-u (universal-argument)), first prompt for a todo file, then a category in that file. If a non-existing category is entered, ask whether to add it to the todo file; if answered affirmatively, add the category and insert the item there.

There are a number of item insertion parameters which can be combined by entering specific keys to produce different insertion commands. After entering each key, a message shows which have already been entered and which remain available. See
(todo-mode) Inserting New Items for details of the parameters,
their associated keys and their effects.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/calendar/todo-mode.el.gz
(defun todo-insert-item (&optional arg)
  "Choose an item insertion operation and carry it out.
This inserts a new todo item into a category.

With no prefix argument ARG, add the item to the current
category; with one prefix argument (\\[universal-argument]), prompt for a category
from the current todo file; with two prefix arguments (\\[universal-argument]
\\[universal-argument]), first prompt for a todo file, then a category in that
file.  If a non-existing category is entered, ask whether to add
it to the todo file; if answered affirmatively, add the category
and insert the item there.

There are a number of item insertion parameters which can be
combined by entering specific keys to produce different insertion
commands.  After entering each key, a message shows which have
already been entered and which remain available.  See
`(todo-mode) Inserting New Items' for details of the parameters,
their associated keys and their effects."
  (interactive "P")
  (todo-insert-item--next-param (list arg) todo-insert-item--parameters nil "i"))