scaladoc allows you to use some kind of markup to format your doc, NO NEED TO RESORT TO UPPER-CASE ;-)