More documentation of accumulated properties

This commit is contained in:
Eric Schulte 2011-11-21 09:19:23 -07:00
parent 6bab435cb2
commit f312e9a6b3
1 changed files with 23 additions and 10 deletions

View File

@ -4758,7 +4758,7 @@ first, and the value after it. Here is an example:
Depending on the value of @code{org-use-property-inheritance}, a property set Depending on the value of @code{org-use-property-inheritance}, a property set
this way will either be associated with a single entry, or the sub-tree this way will either be associated with a single entry, or the sub-tree
defined by the entry, see @ref{Property Inheritance}. defined by the entry, see @ref{Property inheritance}.
You may define the allowed values for a particular property @samp{:Xyz:} You may define the allowed values for a particular property @samp{:Xyz:}
by setting a property @samp{:Xyz_ALL:}. This special property is by setting a property @samp{:Xyz_ALL:}. This special property is
@ -4782,25 +4782,38 @@ file, use a line like
@cindex #+PROPERTY @cindex #+PROPERTY
@example @example
#+PROPERTY: NDisks_ALL 1 2 3 4 #+PROPERTY: NDisks_ALL 1 2 3 4
#+PROPERTY: var foo=1
@end example @end example
If you want to accumulate properties that can be inherited by any entry in a If you want to add to the value of an existing property, append a @code{+} to
file, append a @code{+} to the property name the property name. The following results in the property @code{var} having
the value ``foo=1 bar=2''.
@cindex property, + @cindex property, +
@example @example
#+PROPERTY: var foo=1
#+PROPERTY: var+ bar=2 #+PROPERTY: var+ bar=2
@end example @end example
It is also possible to accumulate properties for a single entry It is also possible to add to the values of inherited properties. The
following results in the @code{genres} property having the value ``Classic
Baroque'' under the @code{Goldberg Variations} subtree.
@cindex property, + @cindex property, +
@example @example
* Babel code * CD collection
:PROPERTIES: ** Classic
:var+: baz=3 :PROPERTIES:
:END: :GENRES: Classic
:END:
*** Goldberg Variations
:PROPERTIES:
:Title: Goldberg Variations
:Composer: J.S. Bach
:Artist: Glen Gould
:Publisher: Deutsche Grammophon
:NDisks: 1
:GENRES+: Baroque
:END:
@end example @end example
Note that a property can only have one accumulation at the entry level. Note that a property can only have one entry per Drawer.
@vindex org-global-properties @vindex org-global-properties
Property values set with the global variable Property values set with the global variable