docs: adapt reference to syntax changes for global definitions

These are now separated into initial_defns and final_defns, which
slightly simplifies the syntax and allows mixing function defns
with literal C code blocks in teh final definition section.