Nope. These are meant to be read as Javadoc. They're meant to be read as source code only. Including markup just makes it look bad. The real mistake was including the <p/>. I've removed those now.