more javadoc + example
README