some cleanup & comments on macros
copy of macro work done in the learn_macros project