|Proper API documentation in javadoc of generated classes [message #742167]
||Thu, 20 October 2011 08:40
| Martin Domig
Registered: August 2010
I have an EMF model which I expect to grow to a considerable complexity over time, so I want to add some documentation.
I would like to
- Document the ecore model itself (so that one can see what the semantic meaning of an attribute is when looking at the ecore model)
- Generate proper javadoc in the generated java classes.
I found an EAnnotation for documentation in the model (source="http://www.eclipse.org/emf/2002/GenModel" with a details entry key="documentation") - which works, but does just half the trick. Googling this turned up half the world and a little bit more, so I have to ask here.
The generated code, when I use that EAnnotation, contains my custom documentation inside begin-model-doc and end-model-doc tags, but still contains the usual hard-coded javadoc "...there really should be more of a description here..."
* Returns the value of the '<em><b>Object Name</b></em>' attribute.
* <!-- begin-user-doc -->
* If the meaning of the '<em>Object Name</em>' attribute isn't clear,
* there really should be more of a description here...
* <!-- end-user-doc -->
* <!-- begin-model-doc -->
* Name associated with the object. This name can be used as blah blah blah
* <!-- end-model-doc -->
* @return the value of the '<em>Object Name</em>' attribute.
* @see #setObjectName(String)
* @see org.eclipse.example.#getModel_ObjectName()
Is there a way to tell EMF that I actually have "more of a description" and therefore it does not need to generate that part of the javadoc?
Is there a way to get rid of that part of the javadoc without manually editing the generated code?
Are there other ways to add documentation to a model, or are there other EAnnotations that can be used?
Thanks for your help!
[Updated on: Thu, 20 October 2011 08:40]
Report message to a moderator
Powered by FUDForum
. Page generated in 0.01755 seconds