clarify requirement for runtime retention in @this, @target, @args

diff --git a/docs/adk15ProgGuideDB/annotations.xml b/docs/adk15ProgGuideDB/annotations.xml
index 9905350f366b4533c764b88d64f402beed8ea002..8fddf011084e5d7c66dae87b603d9aecdaa0ad7a 100644 (file)
--- a/docs/adk15ProgGuideDB/annotations.xml
+++ b/docs/adk15ProgGuideDB/annotations.xml
@@ -708,7 +708,10 @@
     </para>
     
     <para>It is a compilation error to attempt to match on an annotation type 
-    that does not have runtime retention using one of these pointcut designators.</para>
+    that does not have runtime retention using <literal>@this, @target</literal>
+    or <literal>@args</literal>. It is a compilation error to attempt to use
+    any of these designators to expose an annotation value that does not
+    have runtime retention.</para>
 
     <para>
         The <literal>this()</literal>, <literal>target()</literal>, and