javadoc and example updates