I don't think you need to use <p> and <br> in ScalaDocs; Just leave spaces between things that you want to be different paragraphs.