Improved javadocs.

Signed-off-by: Herb Bowie <hbowie@mac.com>