You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@uima.apache.org by "Richard Eckart de Castilho (JIRA)" <de...@uima.apache.org> on 2013/01/27 22:07:12 UTC
[jira] [Resolved] (UIMA-2599) Fill description of component and
parameters from JavaDoc
[ https://issues.apache.org/jira/browse/UIMA-2599?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Richard Eckart de Castilho resolved UIMA-2599.
----------------------------------------------
Resolution: Fixed
"enhance" goal adds the information from the POM into the ResourceMetaData annotation. "generate" goal creates descriptors with this information.
> Fill description of component and parameters from JavaDoc
> ---------------------------------------------------------
>
> Key: UIMA-2599
> URL: https://issues.apache.org/jira/browse/UIMA-2599
> Project: UIMA
> Issue Type: Technical task
> Components: uimafit-maven-plugin
> Reporter: Richard Eckart de Castilho
> Assignee: Richard Eckart de Castilho
> Fix For: 2.0.0uimaFIT
>
>
> Since the maven plugin runs at at build time and has access to the sources, this is a unique opportunity to extract descriptions of components and parameters from JavaDoc. The @ConfigurationParameter annotation provides for a description, but I always found it inconvenient to maintain the description twice, once in JavaDoc and once in the annotation. uimaFIT currently has no support for component descriptions.
> Often, the JavaDoc in uimaFIT components is not added do the parameter variable, but rather to the parameter name constant. So auto-completion in the IDE is use on PARAM_<ctrl-space>, it lists all the parameters along with their explanation.
> {code}
> /**
> * A user-definable value.
> */
> public static final String PARAM_VALUE = "value";
> @ConfigurationParameter(name=PARAM_VALUE)
> private String value;
> {code}
> For this reason, the maven plugin should support looking for parameter documentation not on a field, but rather look for a constant field in the component that starts with PARAM and has as value the name of the field - if such a constant is found, its JavaDoc should be used.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira