some updates to macro docs