Added javadoc.
Reworked introductory section.