On 2025-11-15 Sat 21:00, Ihor Radchenko <[email protected]> wrote: > Titus von der Malsburg <[email protected]> writes: > >> However, it would be good to fix the relevant documentation, which >> creates the impression that PROPERTY+ is only used add values to those >> inherited from elsewhere. Perhaps the documentation could include an >> example from org contacts where multi-valued properties are common >> (phone numbers, e-mail addresses, …). >> >>> The manual also says that "Note that a property can only have one >>> entry per drawer." >> >> This wording should be made more precise since, as you show above, it’s >> actually possible to have multiple entries per drawer via the PROPERTY+ >> syntax. > > Would you be interested to prepare a patch that improves the wording?
Of course, see attachment. I’ve added info on how to use the PROPERTY+ syntax and how not to use the PROPERTY syntax. I also took the liberty of slightly simplifying the first example and changed existing text that implied that the separator for multiple values was necessarily a space which it may not be. Let me know if you want me to make changes. I have signed the FSF paperwork some years ago and have previously contributed patches. Titus
>From 8ec564f25140aa8fd982cf730da9845af05dc0c3 Mon Sep 17 00:00:00 2001 From: Titus von der Malsburg <[email protected]> Date: Wed, 19 Nov 2025 16:38:21 +0100 Subject: [PATCH] doc/org-manual.org: Elaborate description of PROPERTY+ syntax * doc/org-manual.org: Added information on possible uses of the PROPERTY+ syntax and impossible uses of the PROPERTY syntax (without appended +). Simplified an existing example. Link: https://list.orgmode.org/[email protected]/ --- doc/org-manual.org | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 50359ef5b..74e5e04e9 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5403,16 +5403,17 @@ Properties can also be defined using lines like: #+cindex: @samp{+} suffix, in properties If you want to add to the value of an existing property, append a =+= to the property name. The following results in the property =var= -having the value =foo=1 bar=2=. +having the values =foo= and =bar=. #+begin_example -,#+PROPERTY: var foo=1 -,#+PROPERTY: var+ bar=2 +,#+PROPERTY: var foo +,#+PROPERTY: var+ bar #+end_example -It is also possible to add to the values of inherited properties. The -following results in the =Genres= property having the value =Classic -Baroque= under the =Goldberg Variations= subtree. +Using the appended =+=, it is also possible to add to the values of +inherited properties. The following results in the =Genres= property +having the values =Classic=, =Baroque=, and =Keyboard music= under the +=Goldberg Variations= subtree. #+begin_example ,* CD collection @@ -5428,10 +5429,13 @@ Baroque= under the =Goldberg Variations= subtree. :Publisher: Deutsche Grammophon :NDisks: 1 :Genres+: Baroque + :Genres+: Keyboard music :END: #+end_example -Note that a property can only have one entry per drawer. +Note that a property can only have multiple entries per drawer when +used with the appended =+=. When the a property has multiple entries +without =+=, the result is currently not defined. #+vindex: org-global-properties Property values set with the global variable ~org-global-properties~ -- 2.43.0
