dita-ot / dita-ot/ext-plugins

Java API Reference Specialization missing Annotation Types

Open
#2 1 comment 0 reactions 1 assignee Claimed by @robander View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.