Bit more javadoc (yawn)
Added some tested examples to javadoc
Got javadoc to pass Java 8's lint