updates macro annotation docs