Improves Javadoc comments.

Basically this makes the class-level Javadoc comment legible: raw tags
and entities obviously get eaten on rendering to HTML. Some
method-level clean-up. Added a note about the component's use of
escapeHTML=false in its WOString.
Merge pull request #348 from paulhoadley/javadoc-fix

Improves Javadoc comments.