Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 138722

Summary: [xdoclet] EJB extension point documentation is incomplete
Product: [WebTools] WTP EJB Tools Reporter: Lawrence Mandel <lmandel>
Component: jst.ejbAssignee: jst.ejb <jst.ejb-inbox>
Status: RESOLVED WONTFIX QA Contact: Kaloyan Raev <kaloyan>
Severity: normal    
Priority: P3 CC: david_williams, kaloyan
Version: 1.5Keywords: helpwanted
Target Milestone: Future   
Hardware: PC   
OS: Windows XP   
Whiteboard:

Description Lawrence Mandel CLA 2006-04-26 15:03:55 EDT
The documentation for the following extension points is incomplete:
org.eclipse.jst.j2ee.ejb.annotations.emitter.template
org.eclipse.jst.j2ee.ejb.annotations.xdoclet.ejbDocletTaskProvider
org.eclipse.jst.j2ee.ejb.annotations.xdoclet.webdocletTaskProvider
org.eclipse.jst.j2ee.ejb.annotations.xdoclet.xdocletRuntime
org.eclipse.jst.j2ee.EJBCommandExtension

The extension point documentation for these extensions is visible in the JST developer guide (part of the help system). Please update this documentation or comment that it should not be included in the help system.
Comment 1 Naci Dai CLA 2006-05-04 07:35:24 EDT
Lawrence,

What is the level of documentatiosn expected for these?  Can you point me towards an example...

org.eclipse.jst.j2ee.EJBCommandExtension is in one Chuck's components
Comment 2 Lawrence Mandel CLA 2006-05-04 11:42:46 EDT
Naci, here are specific problems with the documentation:

org.eclipse.jst.j2ee.ejb.annotations.emitter.template
- The extension point and name listed in the documentation are not consistent with the defined extension point.
- The attributes for the emitter element contain no descriptions.

org.eclipse.jst.j2ee.ejb.annotations.xdoclet.ejbDocletTaskProvider
- The attributes for the EjbdocletTaskProvider, TaskProperty and AnnotationProvider elements contain no descriptions.

org.eclipse.jst.j2ee.ejb.annotations.xdoclet.webdocletTaskProvider
- The attributes for the WebdocletTaskProvider and TaskProperty elements contain no descriptions.

org.eclipse.jst.j2ee.ejb.annotations.xdoclet.xdocletRuntime
- The attributes for the RuntimeLib element contain no descriptions.

I've opened bug 140182 to handle org.eclipse.jst.j2ee.EJBCommandExtension.
Comment 3 David Williams CLA 2006-06-08 15:44:20 EDT
On behalf of Naci, I am doing a "bulk change" to this bug that showed "not fixed", but an "old" target milestone. 

If it anyone knows that this bug *was* in fact fixed, and the bug just not updated, please let us know. 
Comment 4 Lawrence Mandel CLA 2006-06-08 16:30:30 EDT
I just confirmed that the documentation has not yet been updated. This bug should remain open.
Comment 5 Kaloyan Raev CLA 2008-04-09 03:27:57 EDT
Mass reassignment of bugs from Naci to ejb-inbox. 
Comment 6 Kaloyan Raev CLA 2012-11-02 03:40:30 EDT
I am closing all tickets related to XDoclet as WON'T FIX, because there is no committer to support this functionality. I can review patches if anyone is willing to contribute.