some javadoc comments for online stuff