update some documentation for the macro