scala doc for public API on macros