documented macro
added features to macro