added public javadocs