lots of javadoc improvements

Signed-off-by: gburgett <gordon.burgett@gmail.com>