updates to macro docs