Variable: org-agenda-todo-ignore-deadlines

org-agenda-todo-ignore-deadlines is a customizable variable defined in org-agenda.el.gz.

Value

nil

Documentation

Non-nil means ignore some deadline TODO items when making TODO list.

There are different motivations for using different values, please think carefully when configuring this variable.

This applies when creating the global TODO list.

Valid values are:

near Don't show near deadline entries. A deadline is near when it is
        closer than org-deadline-warning-days days. The idea behind this
        is that such items will appear in the agenda anyway.

far Don't show TODO entries where a deadline has been defined, but
        is not going to happen anytime soon. This is useful if you want to use
        the TODO list to figure out what to do now.

past Don't show entries with a deadline timestamp for today or in the past.

future Don't show entries with a deadline timestamp in the future, not even
        when they become near ones. Use it with caution.

all Ignore all TODO entries that do have a deadline.

t Same as near, for backward compatibility.

This variable can also have an integer as a value. See org-agenda-todo-ignore-timestamp for more details.

See also org-agenda-todo-ignore-with-date. See also the variable org-agenda-tags-todo-honor-ignore-options if you want to make his option also apply to the tags-todo list.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-agenda.el.gz
(defcustom org-agenda-todo-ignore-deadlines nil
  "Non-nil means ignore some deadline TODO items when making TODO list.

There are different motivations for using different values, please think
carefully when configuring this variable.

This applies when creating the global TODO list.

Valid values are:

near    Don't show near deadline entries.  A deadline is near when it is
        closer than `org-deadline-warning-days' days.  The idea behind this
        is that such items will appear in the agenda anyway.

far     Don't show TODO entries where a deadline has been defined, but
        is not going to happen anytime soon.  This is useful if you want to use
        the TODO list to figure out what to do now.

past    Don't show entries with a deadline timestamp for today or in the past.

future  Don't show entries with a deadline timestamp in the future, not even
        when they become `near' ones.  Use it with caution.

all     Ignore all TODO entries that do have a deadline.

t       Same as `near', for backward compatibility.

This variable can also have an integer as a value.  See
`org-agenda-todo-ignore-timestamp' for more details.

See also `org-agenda-todo-ignore-with-date'.
See also the variable `org-agenda-tags-todo-honor-ignore-options' if you want
to make his option also apply to the tags-todo list."
  :group 'org-agenda-skip
  :group 'org-agenda-todo-list
  :type '(choice
	  (const :tag "Ignore near deadlines" near)
	  (const :tag "Ignore near deadlines (compatibility)" t)
	  (const :tag "Ignore far deadlines" far)
	  (const :tag "Ignore all TODOs with a deadlines" all)
	  (const :tag "Show all TODOs, even if they have a deadline" nil)
	  (integer :tag "Ignore if N or more days in past(-) or future(+).")))