svn commit: r1340364 - /maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm

[ol...@apache.org]

Author: olamy
Date: Sat May 19 07:10:52 2012
New Revision: 1340364

URL: http://svn.apache.org/viewvc?rev=1340364&view=rev
Log:
improve note on super classes when using annotations for sources

Modified:
    maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm

Modified: maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm
URL: http://svn.apache.org/viewvc/maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm?rev=1340364&r1=1340363&r2=1340364&view=diff
==============================================================================
--- maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm (original)
+++ maven/plugin-tools/trunk/maven-plugin-plugin/src/site/apt/examples/using-annotations.apt.vm Sat May 19 07:10:52 2012
@@ -31,7 +31,9 @@ Using Java5 annotations
  Since version 3.0, you can use {{{#Annotations}Java5 annotations}} to generate the plugin descriptor file.
 
  <<NOTE>> With annotations, it's not anymore mandatory to have your Mojos super classes in the same project. Super classe
- can now come from reactor projects or external dependencies.
+ can now come from reactor projects or external dependencies. As javadoc doclet are still reading (for @since, @deprecated and comments),
+ the sources are still scanned. So if you use an external dependency, you must still provide an artifact with sources (classifier sources) to
+ provide documentation (the tooling will skip error if this artifact sources is missing).
 
 * Pom configuration