documentation for public macros
updated documentation for public macros