added macro docs