From 7f2308f46c098ab984dd1b8c45616113eec6aefc Mon Sep 17 00:00:00 2001
From: Rob Winch <rwinch@vmware.com>
Date: Sun, 25 Aug 2013 11:06:36 -0500
Subject: [PATCH] SEC-2146: Document AspectJ does not inherit annotations

---
 docs/manual/src/docbook/appendix-namespace.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/manual/src/docbook/appendix-namespace.xml b/docs/manual/src/docbook/appendix-namespace.xml
index bccbea9959..463dabc948 100644
--- a/docs/manual/src/docbook/appendix-namespace.xml
+++ b/docs/manual/src/docbook/appendix-namespace.xml
@@ -1787,6 +1787,10 @@ where
                         should be used instead of the default Spring AOP. Secured methods must be woven
                         with the <classname>AnnotationSecurityAspect</classname> from the
                         <literal>spring-security-aspects</literal> module. </para>
+                    <para>It is important to note that AspectJ follows Java's rule that annotations on
+                        interfaces are not inherited. This means that methods that define the Security annotaitons
+                        on the interface will not be secured. Instead, you must place the Security annotation
+                        on the class when using AspectJ.</para>
                 </section>
                 <section xml:id="nsa-global-method-security-order">
                     <title><literal>order</literal></title>