docuemented macros