I had a heck of a time figuring out what was wrong with a hand-edited vap, where ${} was used for a macro when %{} should have been. There needs to be better error feedback on this. Also there is no wiki page on using these macros, which are pretty flexible and could be used for spacecraft ID, for example.
I was surprised and pleased when I saw that arbitrary macros worked in annotations, so you can have the annotation %{TODAY} and when you load the .vap with ...vap?TODAY=2026-02-27 it will plug in the value.
This implies there is a namespace with some things removed, like %{PWD} and %{timerange}. Also I don't think all nodes of the .vap are resolved, and this needs to be documented. Further, there are things like %{CONTEXT} and %{TIMERANGE}.
Last edit: Jeremy Faden 2026-02-28
I added some to the documentation:
https://github.com/autoplot/documentation/blob/main/md/MacrosInVaps.md
and
https://github.com/autoplot/documentation/wiki/Annotations
and
https://github.com/autoplot/documentation/blob/main/md/Annotations.md
(I believe the non-wiki pages are the ones to modify, but I'm not sure.)