minor updates and added jdoc comments
minor updates and added jdoc comments