> Tom, is this an example of the annotations you wanted me to try and > improve the javadoc style for? > > https://build.shibboleth.net/jenkins/job/java-identity-provider/ws/idp-prof > ile-impl/target/apidocs/net/shibboleth/idp/profile/impl/ResolveAttributes.h > tml Yes. Especially since one of the reasons for the Events annotation is documentation for deployers.