Added javadoc for getExtraSourceLocations()

diff --git a/bridge/src/org/aspectj/bridge/IMessage.java b/bridge/src/org/aspectj/bridge/IMessage.java
index 1848e0e31d047959f0e74b3ae64daa3e23bb4a79..2bafc7d7a5b1158dc97f6e0fae500cf8cff98273 100644 (file)
--- a/bridge/src/org/aspectj/bridge/IMessage.java
+++ b/bridge/src/org/aspectj/bridge/IMessage.java
@@ -125,5 +125,18 @@ public interface IMessage {
         */
        public String getDetails();
     
+       
+       /** 
+        * @return List of <code>ISourceLocation</code> instances that indicate 
+        * additional source locations relevent to this message as specified by the 
+        * message creator. The list should not include the primary source location 
+        * associated with the message which can be obtained from 
+        * <code>getSourceLocation()<code>. 
+        * <p>   
+        * An example of using extra locations would be in a warning message that 
+        * flags all shadow locations that will go unmatched due to a pointcut definition 
+        * being based on a subtype of a defining type. 
+        * @see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=41952">AspectJ bug 41952</a> 
+        */ 
     public List getExtraSourceLocations();
 }