Java API Reference Specialization missing Annotation Types
- Dominant language
- HTML
- Stars
- 23
- Forks
- 12
- PR merge metrics
- No merged PRs in 30d
Description
Converted from dita-ot/dita-ot#1119
The Java API Reference Specialization plugin from the DITA Open Toolkit does not support the new Java 5 language features of Annotation Types and Enums.
For a quick overview of annotation types, see:
http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html
For a quick overview of enums, see:
http://java.sun.com/j2se/1.5.0/docs/guide/language/enums.html
For an example of the documentation that Sun's Javadoc doclet creates for a custom annotation type, look here:
http://edocs.bea.com/wls/docs92/javadocs/weblogic/jws/AsyncResponse.html
We also have a custom annotation type that happens to include an enum class. Just to be clear: enums can appear in other types of classes, but for convenience sake, I thought I'd show a single example that contains both of the new Java 5 features. So here's a custom annotation type that also uses an enum class:
http://edocs.bea.com/wls/docs92/javadocs/weblogic/jws/security/UserDataConstraint.html
I've attached the source code for the two examples.
Thanks for looking in to this. Unfortunately, I cannot use the Java API specialization until it supports these new features.
Let me know if I can help.
---
[Background](http://tech.groups.yahoo.com/group/dita-users/message/6047)
Contributor guide
Assessment
This issue has not been assessed yet.