added method javadoc comments