Function: todo-edit-file

todo-edit-file is an interactive and byte-compiled function defined in todo-mode.el.gz.

Signature

(todo-edit-file)

Documentation

Put current buffer in todo-edit-mode.

This makes the entire file visible and the buffer writable and you can use the self-insertion keys and standard Emacs editing commands to make changes. To return to Todo mode, type M-x todo-edit-quit (todo-edit-quit). This runs a file format check, signaling an error if the format has become invalid. However, this check cannot tell if the number of items changed, which could result in the file containing inconsistent information. For this reason this command should be used with caution.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/calendar/todo-mode.el.gz
(defun todo-edit-file ()
  "Put current buffer in `todo-edit-mode'.
This makes the entire file visible and the buffer writable and
you can use the self-insertion keys and standard Emacs editing
commands to make changes.  To return to Todo mode, type
\\[todo-edit-quit].  This runs a file format check, signaling
an error if the format has become invalid.  However, this check
cannot tell if the number of items changed, which could result in
the file containing inconsistent information.  For this reason
this command should be used with caution."
  (interactive)
  (widen)
  (todo-edit-mode)
  (remove-overlays)
  (display-warning
   'todo (format "\

Type %s to return to Todo%s mode.

This also runs a file format check and signals an error if
the format has become invalid.  However, this check cannot
tell if the number of items or categories changed, which
could result in the file containing inconsistent information.
You can repair this inconsistency by invoking the command
`todo-repair-categories-sexp', but this will revert any
renumbering of the categories you have made, so you will
have to renumber them again (see `(todo-mode) Reordering
Categories').
"
                 (substitute-command-keys "\\[todo-edit-quit]")
                 (if (equal "toda" (file-name-extension
                                    (buffer-file-name)))
                     " Archive" ""))))