Adapt javadocs to current API

Also, add a small package-info document.

Change-Id: I5a9850b9381632bfed142d16063d8d75549dade2