That's javadoc (which is supposed to be well-formatted HTML). I saw somewhere that comments should use javadoc-style instead of scaladoc style, but that might have been just for the first line. I'll take a look at what scaladoc expects.