Variable: org-use-property-inheritance

org-use-property-inheritance is a customizable variable defined in org.el.gz.

Value

nil

Documentation

Non-nil means properties apply also for sublevels.

This setting is chiefly used during property searches. Turning it on can cause significant overhead when doing a search, which is why it is not on by default.

When nil, only the properties directly given in the current entry count. When t, every property is inherited. The value may also be a list of properties that should have inheritance, or a regular expression matching properties that should be inherited.

However, note that some special properties use inheritance under special circumstances (not in searches). Examples are CATEGORY, ARCHIVE, COLUMNS, and the properties ending in "_ALL" when they are used as descriptor for valid values of a property.

Note for programmers: When querying an entry with org-entry-get, you can control if inheritance should be used. By default, org-entry-get looks only at the local properties. You can request inheritance by setting the inherit argument to t (to force inheritance) or to selective (to respect the setting in this variable).

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defcustom org-use-property-inheritance nil
  "Non-nil means properties apply also for sublevels.

This setting is chiefly used during property searches.  Turning it on can
cause significant overhead when doing a search, which is why it is not
on by default.

When nil, only the properties directly given in the current entry count.
When t, every property is inherited.  The value may also be a list of
properties that should have inheritance, or a regular expression matching
properties that should be inherited.

However, note that some special properties use inheritance under special
circumstances (not in searches).  Examples are CATEGORY, ARCHIVE, COLUMNS,
and the properties ending in \"_ALL\" when they are used as descriptor
for valid values of a property.

Note for programmers:
When querying an entry with `org-entry-get', you can control if inheritance
should be used.  By default, `org-entry-get' looks only at the local
properties.  You can request inheritance by setting the inherit argument
to t (to force inheritance) or to `selective' (to respect the setting
in this variable)."
  :group 'org-properties
  :type '(choice
	  (const :tag "Not" nil)
	  (const :tag "Always" t)
	  (repeat :tag "Specific properties" (string :tag "Property"))
	  (regexp :tag "Properties matched by regexp")))