Christian Moe <[email protected]> writes:

> The `org-property-separator' variable is not documented in the manual
> (at least not on that page, and not in the variable index). It probably
> ought to be mentioned on the Property Syntax page.
>
> That page goes on to say: "Note that a property can only have one entry
> per drawer." This clashes with the terminology used everywhere else on
> that page, where "entry" means an Org entry (headline and content). It
> could also be interpreted to conflict with Ihor's statement upthread
> that "syntax-wise, properties do not have to be unique", i.e. the same
> property can be entered several times in the same drawer (but only one
> such "entry" or instance will be retrieved). Here "entry" should perhaps
> read "value": "Note that a property can only have one value per drawer."
> If we make that change, perhaps that line should be
> moved up to immediately before "If you want to add to the value ...",
> otherwise it might be confusing.

Yeah. `org-property-separator' is a relatively new feature (and an
afterthought). It ought to be documented.

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Reply via email to