Skip to content

Document macro expansion in the “Running tex from within metapost” section too?

First of all, thank you very much for your work, which enables me to use Metapost from OpTeX easily.

I just have a suggestion for the documentation. I read the manual from the beginning to the end one month ago when I started to use minim-mp. However, as I struggled today with a macro call which did not work as expected in a label, and I consulted directly the “Running tex from within metapost” section, where I did not find a solution. After many unsuccessful experiments, I finally found by chance the following statement, which is only at the very beginning of the manual:

However, any control sequences will be expanded fully, as inside an ⟦\edef⟧.
Keep this in mind and define any macros you want to use in a ⟦btex ... etex;⟧ 
environment as ⟦\protected⟧ (with the latex package, latex’s ‘protected’ macros 
are safe-to-use, too).

I wonder if it could not be included in the “Running tex from within metapost” section too, e.g. after “The tex code will be executed in the current environment without an extra grouping level”?

(By the way, one of the reasons why I missed it is that I never use btex and etex directly with minim-mp.)