Variable: org-loop-over-headlines-in-active-region

org-loop-over-headlines-in-active-region is a customizable variable defined in org.el.gz.

Value

t

Documentation

Shall some commands act upon headlines in the active region?

When set to t, some commands will be performed in all headlines within the active region.

When set to start-level, some commands will be performed in all headlines within the active region, provided that these headlines are of the same level than the first one.

When set to a string, those commands will be performed on the matching headlines within the active region. Such string must be a tags/property/todo match as it is used in the agenda tags view.

The list of commands is: org-schedule, org-deadline, org-todo, org-set-tags-command, org-archive-subtree, org-archive-set-tag, org-toggle-archive-tag and org-archive-to-archive-sibling. The archiving commands skip already archived entries.

See org-agenda-loop-over-headlines-in-active-region for the equivalent option for agenda views.

This variable was added, or its default value changed, in Org version
9.4.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defcustom org-loop-over-headlines-in-active-region t
  "Shall some commands act upon headlines in the active region?

When set to t, some commands will be performed in all headlines
within the active region.

When set to `start-level', some commands will be performed in all
headlines within the active region, provided that these headlines
are of the same level than the first one.

When set to a string, those commands will be performed on the
matching headlines within the active region.  Such string must be
a tags/property/todo match as it is used in the agenda tags view.

The list of commands is: `org-schedule', `org-deadline',
`org-todo', `org-set-tags-command', `org-archive-subtree',
`org-archive-set-tag', `org-toggle-archive-tag' and
`org-archive-to-archive-sibling'.  The archiving commands skip
already archived entries.

See `org-agenda-loop-over-headlines-in-active-region' for the
equivalent option for agenda views."
  :type '(choice (const :tag "Don't loop" nil)
		 (const :tag "All headlines in active region" t)
		 (const :tag "In active region, headlines at the same level than the first one" start-level)
		 (string :tag "Tags/Property/Todo matcher"))
  :package-version '(Org . "9.4")
  :group 'org-todo
  :group 'org-archive)