I copy/pasted api docs from ehcache which is where I picked up this syntax.  I'll remove all <p/> and keep all markup out of our comments.