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