Sure. Javadoc doesn't do much in terms of automatic markup, so we have to help it a bit. If we want to use a `blockquote`, for example (and we do here), it makes sense to mark up the rest of the doc comment, too. If it's a single paragraph of text with no other block elements, we don't have to mark up the paragraphs.

Take a look at the docs for [`PushManager#getExpiredTokens()`](http://relayrides.github.io/pushy/apidocs/0.3/com/relayrides/pushy/apns/PushManager.html#getExpiredTokens()) for an example of how this looks in the finished docs.