javadoc and examples cleanup