Javadoc changes:
* flesh out and update @throws sections
* add @warn nags to missing javadocs
* standardize formatting
* fix dead links to images