--- a/langtools/src/share/classes/com/sun/tools/apt/resources/apt.properties	Fri Jul 24 14:47:01 2009 -0700
+++ b/langtools/src/share/classes/com/sun/tools/apt/resources/apt.properties	Sun Jul 26 21:27:11 2009 -0700
@@ -111,6 +111,14 @@
 ## miscellaneous strings
 ##
 
+apt.misc.Deprecation=\
+    \nwarning:\u0020The apt tool and its associated API are planned to be\n\
+    removed in the next major JDK release.  These features have been\n\
+    superseded by javac and the standardized annotation processing API,\n\
+    javax.annotation.processing and javax.lang.model.  Users are\n\
+    recommended to migrate to the annotation processing features of\n\
+    javac; see the javac man page for more information.\n
+
 apt.misc.Problem=\
     Problem encountered during annotation processing; \nsee stacktrace below for more information.