First pass at macro API document as discussed with TimToady? on IRC yesterday. This verison is really just a starting point for discussion.