SI-7124 make macro definitions prettier in scaladoc

Macros are now prettier in scaladoc, by
 - hiding the `macroImpl` annotation
 - showing the `macro` modifier in front
Merge pull request #3441 from gourlaysama/t7124

SI-7124 make macro definitions prettier in scaladoc