documented macros