update modules doc re: macros