more documentation for ruby macros