- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

7.4 Property Inheritance

The outline structure of Org-mode documents lends itself to an inheritance model of properties: if the parent in a tree has a certain property, the children can inherit this property. Org-mode does not turn this on by default, because it can slow down property searches significantly and is often not needed. However, if you find inheritance useful, you can turn it on by setting the variable org-use-property-inheritance. It may be set to t to make all properties inherited from the parent, to a list of properties that should be inherited, or to a regular expression that matches inherited properties. If a property has the value ‘nil’, this is interpreted as an explicit undefine of the property, so that inheritance search will stop at this value and return nil.

Org-mode has a few properties for which inheritance is hard-coded, at least for the special applications for which they are used:

The :COLUMNS: property defines the format of column view (see section 7.5 Column view). It is inherited in the sense that the level where a :COLUMNS: property is defined is used as the starting point for a column view table, independently of the location in the subtree from where columns view is turned on.
For agenda view, a category set through a :CATEGORY: property applies to the entire subtree.
For archiving, the :ARCHIVE: property may define the archive location for the entire subtree (see section 9.6.1 Moving a tree to the archive file).
The LOGGING property may define logging settings for an entry or a subtree (see section 5.3.2 Tracking TODO state changes).
ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition