Add a comment about javadoc mishaps

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