updated Javadoc comments

Please review and commit to continuuity/weave