Where is Elisp evaluation documented in the Org Manual?

Where is Elisp evaluation documented in the Org Manual?

[Perry Smith]

[-- Attachment #1: Type: text/plain, Size: 666 bytes --]

I wanted to format a key binding in Org mode and, of course, I wanted to do it properly so I started surfing around and then hit upon the idea of just looking at the source of the Org manual for examples.

I discovered that it can be done like {{{kbd(M-TAB)}}}

Fascinating!!!  And I bet expr in the form of {{{ expr }}} could be any Elisp expression.  Cool!

But, where in the Org manual is this documented?  I’m curious what other things are possible.  So far, I’ve not been able to find it.  I did find something about Capture Templates but I’m not at that pay grade yet.

(I’m not on the list so please CC me on your replies)
Thank you,
Perry

[-- Attachment #2: Message signed with OpenPGP --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Where is Elisp evaluation documented in the Org Manual?

[Max Nikulin]

On 30/09/2022 21:15, Perry Smith wrote:

> 
> I discovered that it can be done like {{{kbd(M-TAB)}}}
> 
> Fascinating!!!  And I bet expr in the form of {{{ expr }}} could be any Elisp expression.  Cool!
> 
> But, where in the Org manual is this documented?

See info "(org) Macro Replacement" 
https://orgmode.org/manual/Macro-Replacement.html

If you are interested in particular in the implementation of kbd then 
have a look into doc/doc-setup.org and lisp/ox-texinfo.el files in the 
Org sources.

There are a pitfall with comma as macro argument separator. It is easy 
to forgot to escape it and to loose remaining arguments.

Re: Where is Elisp evaluation documented in the Org Manual?

[Perry Smith]

[-- Attachment #1: Type: text/plain, Size: 1089 bytes --]


> On Sep 30, 2022, at 11:07, Max Nikulin <manikulin@gmail.com> wrote:
> 
> On 30/09/2022 21:15, Perry Smith wrote:
> 
>> I discovered that it can be done like {{{kbd(M-TAB)}}}
>> Fascinating!!!  And I bet expr in the form of {{{ expr }}} could be any Elisp expression.  Cool!
>> But, where in the Org manual is this documented?
> 
> See info "(org) Macro Replacement" https://orgmode.org/manual/Macro-Replacement.html
> 
> If you are interested in particular in the implementation of kbd then have a look into doc/doc-setup.org and lisp/ox-texinfo.el files in the Org sources.
> 
> There are a pitfall with comma as macro argument separator. It is easy to forgot to escape it and to loose remaining arguments.

Thank you…

For others following along, the reference is doc/misc/org-setup.org and lisp/org/ox-texinfo.el in the source tree.

Also, I searched for {{{ in org.org but I failed to notice that some were escaped with =xxxx= such as:

    which can be referenced using ={{{name(arg1, arg2)}}}=

(making the text inside a verbatim).

Thank you again.


[-- Attachment #2: Message signed with OpenPGP --]
[-- Type: application/pgp-signature, Size: 833 bytes --]