src/java.base/share/classes/java/lang/Module.java

@@ -1379,27 +1379,33 @@
     // -- annotations --
 
     /**
      * {@inheritDoc}
      * This method returns {@code null} when invoked on an unnamed module.
+     * <p>Note that any annotation returned by this method is a
+     * declaration annotation.
      */
     @Override
     public <T extends Annotation> T getAnnotation(Class<T> annotationClass) {
         return moduleInfoClass().getDeclaredAnnotation(annotationClass);
     }
 
     /**
      * {@inheritDoc}
+     * <p>Note that any annotations returned by this method are
+     * declaration annotations.
      * This method returns an empty array when invoked on an unnamed module.
      */
     @Override
     public Annotation[] getAnnotations() {
         return moduleInfoClass().getAnnotations();
     }
 
     /**
      * {@inheritDoc}
+     * <p>Note that any annotations returned by this method are
+     * declaration annotations.
      * This method returns an empty array when invoked on an unnamed module.
      */
     @Override
     public Annotation[] getDeclaredAnnotations() {
         return moduleInfoClass().getDeclaredAnnotations();