[
https://issues.apache.org/jira/browse/MPLUGIN-321?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Robert Scholte closed MPLUGIN-321.
----------------------------------
Resolution: Fixed
Assignee: Robert Scholte
Done in [r1778915|http://svn.apache.org/viewvc?rev=1778915&view=rev]
> improve documentation on maven-plugin-annotations telling that provided is
> sufficient
> -------------------------------------------------------------------------------------
>
> Key: MPLUGIN-321
> URL: https://issues.apache.org/jira/browse/MPLUGIN-321
> Project: Maven Plugin Tools
> Issue Type: Improvement
> Components: maven-plugin-annotations
> Affects Versions: 3.5
> Reporter: Hervé Boutemy
> Assignee: Robert Scholte
> Priority: Minor
> Fix For: 3.5.1
>
>
> https://maven.apache.org/plugin-tools-archives/plugin-tools-3.5/maven-plugin-plugin/examples/using-annotations.html#POM_configuration
> tells
> {code:xml} <dependencies>
> <!-- dependencies to annotations -->
> <dependency>
> <groupId>org.apache.maven.plugin-tools</groupId>
> <artifactId>maven-plugin-annotations</artifactId>
> <version>3.5</version>
> <scope>provided</scope><!-- annotations are needed only to build the
> plugin -->
> </dependency>
> </dependencies>
> {code}
> Yes, annotations are needed only to build the plugin, since they have
> {{@Retention(value=CLASS)}} which means they stay in bytecode but are not
> loaded at runtime.
> What is not clear is that this dependency is not really _provided_ at
> runtime: Maven core does not inject maven-plugin-annotations at runtime (why
> would it? Maven core works by reading
> [META-INF/maven/plugin.xml|http://maven.apache.org/ref/3-LATEST/maven-plugin-api/]).
> But the dependency is simply not used at runtime.
> This doc can be improved:
> {code:xml}<!-- annotations are not used at runtime because
> @Retention(value=CLASS), they are needed only to build the plugin -->{code}
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
