Javadoc + README usage examples

yes