Bastien <b...@altern.org> writes:
> Nicolas Goaziou <n.goaz...@gmail.com> writes:
>
>> As you noticed, secondary strings are omitted in the manual, but still
>> valid locations: titles in headlines or inlinetasks, inline footnotes,
>> and plain list item tags.
>
> Any reason not to mention secondary strings?
No reason besides clarity, maybe. A long list of locations could be
confusing.
> In this particular case, mentioning headlines and plain list items
> would be useful, otherwise careful readers* may assume that macros
> are not available there.
What about excluding most tempting locations instead?
"...
which can be referenced with {{{name(arg1, arg2)}}}.
These references, called macros, can be inserted anywhere Org markup
is recognized. In particular, this excludes all keywords but CAPTION,
TITLE, AUTHOR and EMAIL, source blocks, example blocks and comments.
In addition to user-defined macros..."
Regards,
--
Nicolas Goaziou
