Finish package javadoc, at last

Now, on to examples...

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