javadoc for all new methods please