A file named
API_VERSION may exist at the grimoire level and/or the section level. In this file one variable may be defined:
This variable may be given the values '1' or '2'. To denote which build API the grimoire or section uses.
API_VERSION file must have the executable bit set (so a
test -x passes).
The files are sourced in the following order:
Thus the section level will override the grimoire level and the spell level will override the section and grimoire levels.
BUILD_API variable is not defined the behavior defaults to it being defined as '2'.
A quick rundown of what '1' and '2' mean:
Build API 1:
Build API 2:
Note: do not write spells in build API 1, use build API 2 instead!