Fill javadoc gaps

[jentfoo]

This project is still missing a lot of javadocs, we should fill those gaps before 1.0