Author: dennisl Date: Sat Feb 14 13:10:51 2015 New Revision: 1659792 URL: http://svn.apache.org/r1659792 Log: Document which plugins are Java version sensitive, and if/where the Java version they use are defined. Also show which properties are being used.
Modified: maven/site/trunk/content/apt/developers/java6.apt Modified: maven/site/trunk/content/apt/developers/java6.apt URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/developers/java6.apt?rev=1659792&r1=1659791&r2=1659792&view=diff ============================================================================== --- maven/site/trunk/content/apt/developers/java6.apt (original) +++ maven/site/trunk/content/apt/developers/java6.apt Sat Feb 14 13:10:51 2015 @@ -59,4 +59,52 @@ Java 6 in Plugins and Shared Components {{{http://svn.apache.org/viewvc/maven/plugins/trunk/maven-checkstyle-plugin/src/site/apt/index.apt.vm?r1=1650811&r2=1652771&pathrev=1658048}example}}. We need to use the variable $\{javaVersion\} here, because $\{maven.compiler.source\} does not work in a site. - \ No newline at end of file + +* In the POM + + Make sure these 3 properties are defined, either in the project or in a + parent: + + * javaVersion=1.6 + + * maven.compiler.source=$\{javaVersion\} + + * maven.compiler.target=$\{javaVersion\} + + [] + + Here is a list plugins that are defined in a parent, and that already makes + use of the above mentioned properties. So it should be enough to just make + sure that the effective-pom looks ok. + + * <<<maven-compiler-plugin>>> is defined in <<<maven-parent>>>, see + {{{http://svn.apache.org/viewvc/maven/pom/tags/maven-parent-26/pom.xml?view=markup#l842}example}} + + * <<<maven-enforcer-plugin>>> and the <<<enforceBytecodeVersion>>> rule is defined in + <<<maven-parent>>>, see + {{{http://svn.apache.org/viewvc/maven/pom/tags/maven-parent-26/pom.xml?view=markup#l946}example}} + + * <<<maven-pmd-plugin>>> is defined in <<<maven-parent>>>, see + {{{http://svn.apache.org/viewvc/maven/pom/tags/maven-parent-26/pom.xml?view=markup#l1069}example}} + + [] + + These plugins that are not defined in a parent, so you might need + to configure the Java version for them in the plugin/component + +~~ TODO The links in the following bullets should be changed to point to a tag, once maven-checkstyle-plugin has been released + + * <<<animal-sniffer-maven-plugin>>> is only defined in selected plugins, see + {{{http://svn.apache.org/viewvc/maven/plugins/trunk/maven-checkstyle-plugin/pom.xml?view=markup#l307}example in <<<maven-checkstyle-plugin>>>}}. + We should move it to maven-parent. + + * <<<buildhelper-maven-plugin>>> is used to create the signature for + animal-sniffer and is only defined in selected plugins, see + {{{http://svn.apache.org/viewvc/maven/plugins/trunk/maven-checkstyle-plugin/pom.xml?view=markup#l295}example in <<<maven-checkstyle-plugin>>>}}. + We should move it to maven-parent. + + * <<<maven-plugin-plugin>>> is only defined in selected plugins, see + {{{http://svn.apache.org/viewvc/maven/plugins/trunk/maven-checkstyle-plugin/pom.xml?view=markup#l370}example in <<<maven-checkstyle-plugin>>>}}. + We should move it to maven-plugins parent. + + []