This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
I've noticed that XMI format can contain annotations for metamodel elements. I suggest that the annotation is copied into the generated interfaces as JavaDoc comments. For classes associations and packages, it's easy. For attributes or referencies, the generator would have to be more clever: it could put the annotation to a getter and document the setter with a general description "This method sets XXX attribute, @see getter". Since association end correspond to assoc end getter in the association, the comment created for it as well. If there's a reference without a comment, the comment can be generated from the appropriate association end's annotation.
There is a JMI-defined tag javax.jmi.javaDocs that can be attached to operations, classes, and packages [JMI 4.6.4]. Unfortunately, the JMI draft doesn't say anything about how to attach JavaDoc to attributes or references; that means that the tag cannot be used for the majority of the metamodel's features. I suppose there probably needs to be "javax.jmi.javaDocs.setter" and "javax.jmi.javaDocs.getter" tags for attributes and references. Even using "annotation" pr te "javax.jmi.javaDocs" tag, I don't think it is possible to use any markup (HTML tags). Actually, the XMI spec says that an XMI importer is supposed to ignore any tags inside a "String" that it doesn't understand, but the DTD/Schema that get generated don't allow any tags in Strings anyway. Therefore, it might be worthwhile to consider using an XMI extension element (perhaps JMI could standardize one if it isn't too late). By the way, I made a really simple XSLT+Servlet application that lets you browse the classes of a metamodel like you are using JavaDoc documentation (for an example see, http://m43414.medicine.uiowa.edu/md-xmi/servlet/XMIDocServlet?model=MOF&version=1.4) It is similar to Dave Carlson's but developed independently. I could easily extend it to recognize the "javax.jmi.javaDocs" tag and/or the "annotations" attribute along with more model elements (it doesn't do DataTypes or Associations yet, and some of the links are broken).
Generation of javadocs from metamodel annotations is implemented.