more javadoc yak shaving
keep checkstyle happy…