add a few custom javadoc tags, update API links [1055]

This cuts out another 100 or so javadoc warnings in the build, plus the API links were dead.