Javadoc, javadoc and more javadoc

Signed-off-by: Francis Galiegue <fgaliegue@gmail.com>