complete JavaDoc
Merge pull request #2 from slawekj/js_completeJavadoc

complete JavaDoc