o Polished docs
git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@992590 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/site/apt/examples/set-compiler-source-and-target.apt.vm b/src/site/apt/examples/set-compiler-source-and-target.apt.vm
index 3d9a4e7..0c000f3 100644
--- a/src/site/apt/examples/set-compiler-source-and-target.apt.vm
+++ b/src/site/apt/examples/set-compiler-source-and-target.apt.vm
@@ -57,4 +57,11 @@
</build>
[...]
</project>
-+-----
\ No newline at end of file
++-----
+
+ <<Note:>> Merely setting the <<<target>>> option does not guarantee that your code actually runs on a JRE with the
+ specified version. The pitfall is unintended usage of APIs that only exist in later JREs which would make your code
+ fail at runtime with a linkage error. To avoid this issue, you can either configure the compiler's boot classpath
+ to match the target JRE or use the
+ {{{http://mojo.codehaus.org/animal-sniffer-maven-plugin/}Animal Sniffer Maven Plugin}} to verify your code doesn't
+ use unintended APIs.
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
index 1a32774..5b953c3 100644
--- a/src/site/apt/index.apt
+++ b/src/site/apt/index.apt
@@ -30,7 +30,7 @@
The Compiler Plugin is used to compile the sources of your project. The
default compiler is <<<javac>>> and is used to compile Java sources.
- The default <<<source>>> setting is <<<1.5>>> and the default <<<target>>>
+ Also note that at present the default <<<source>>> setting is <<<1.5>>> and the default <<<target>>>
setting is <<<1.5>>>, independently of the JDK you run Maven with.
If you want to change these defaults, you should set <<<source>>> and <<<target>>>
as described in
@@ -41,8 +41,8 @@
This Compiler Plugin is the Maven 2 version of Maven 1.x's Java Plugin.
- <<NOTE:>> <To know more about the Java JDK 1.4 javac, please see:
- {{http://java.sun.com/j2se/1.4.2/docs/tooldocs/tools.html#basic}}.>
+ <<NOTE:>> <To know more about the JDK javac, please see:
+ {{http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html}}.>
* Goals Overview
