Lotsa javadoc improvements

* diagrams for previously-undiagram'd methods
* links to wiki docs where available
* standardizing format & nomenclature