diff --git a/WHATSNEW b/WHATSNEW
index 48e944af8..3928772de 100644
--- a/WHATSNEW
+++ b/WHATSNEW
@@ -226,6 +226,9 @@ Other changes:
* false
.
+ package-info.java
files were introduced in Java5 to
+ allow package level annotations. On compilation, if the java file
+ does not contain runtime annotations, there will be no .class file
+ for the java file. Up to Ant 1.7.1, when the <javac>
+ task is run again, the
+ task will try to compile the package-info java files again.
+
+ In Ant 1.7.1 the package-info.java will only be compiled if: +
package-info.class
file exists and is older than
+ the package-info.java
file.
+ package-info.class
file does not exist.
+ package-info.class
file exists, and has an older
+ modification time than the
+ the package-info.java
file. In this case
+ <javac> will touch the corresponding .class directory
+ on successful compilation.
+