better javadocs

Signed-off-by: Tom Everett <tome@criticalmass.com>