fixed faling test and improved javadoc