Added / Fix javadocs. WIP.

Signed-off-by: Jean-Yves Tinevez <jean-yves.tinevez@pasteur.fr>