Last commits to improve the javadoc

Signed-off-by: Clement Escoffier <clement.escoffier@gmail.com>