Document composed support for @scheduled, @JmsListener, & @SQL

Issue: SPR-13973

Author: sbrannen

spring-context/src/main/java/org/springframework/scheduling/annotation/Scheduled.java

@@ -36,6 +36,9 @@
  * done manually or, more conveniently, through the {@code <task:annotation-driven/>}
  * element or @{@link EnableScheduling} annotation.
  *
+ * <p>This annotation may be used as a <em>meta-annotation</em> to create custom
+ * <em>composed annotations</em> with attribute overrides.
+ *
  * @author Mark Fisher
  * @author Dave Syer
  * @author Chris Beams

spring-context/src/main/java/org/springframework/scheduling/annotation/Schedules.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,6 +30,9 @@
  * where {@link Scheduled} can simply be declared several times on the same method,
  * implicitly generating this container annotation.
  *
+ * <p>This annotation may be used as a <em>meta-annotation</em> to create custom
+ * <em>composed annotations</em>.
+ *
  * @author Juergen Hoeller
  * @since 4.0
  * @see Scheduled

spring-jms/src/main/java/org/springframework/jms/annotation/JmsListener.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -66,6 +66,9 @@
  * {@link org.springframework.messaging.handler.annotation.SendTo @SendTo} to the
  * method declaration.
  *
+ * <p>This annotation may be used as a <em>meta-annotation</em> to create custom
+ * <em>composed annotations</em> with attribute overrides.
+ *
  * @author Stephane Nicoll
  * @since 4.1
  * @see EnableJms

spring-jms/src/main/java/org/springframework/jms/annotation/JmsListeners.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,6 +30,9 @@
  * where {@link JmsListener} can simply be declared several times on the same method,
  * implicitly generating this container annotation.
  *
+ * <p>This annotation may be used as a <em>meta-annotation</em> to create custom
+ * <em>composed annotations</em>.
+ *
  * @author Stephane Nicoll
  * @since 4.2
  * @see JmsListener

spring-test/src/main/java/org/springframework/test/context/jdbc/Sql.java

@@ -50,7 +50,7 @@
  * multiple instances of {@code @Sql}.
  *
  * <p>This annotation may be used as a <em>meta-annotation</em> to create custom
- * <em>composed annotations</em>.
+ * <em>composed annotations</em> with attribute overrides.
  *
  * @author Sam Brannen
  * @since 4.1

src/asciidoc/whats-new.adoc

@@ -633,11 +633,14 @@ public @interface MyTestConfig {
   bean only defines one constructor.
 * `@Configuration` classes support constructor injection.
 * Any SpEL expression used to specify the `condition` of an `@EventListener` can
-  now refer to beans (i.e. `@beanName.method()`).
+  now refer to beans (e.g. `@beanName.method()`).
 * _Composed annotations_ can now override array attributes in meta-annotations
   with a single element of the component type of the array. For example, the
   `String[] path` attribute of `@RequestMapping` can be overridden with
   `String path` in a composed annotation.
+* `@Scheduled` and `@Schedules` may now be used as _meta-annotations_ to create
+  custom _composed annotations_ with attribute overrides.
+
 
 === Data Access Improvements
 
@@ -661,7 +664,9 @@ Spring 4.3 also improves the caching abstraction as follows:
 
 === JMS Improvements
 
-* `@SendTo` can now be specified at class-level to share a common reply destination.
+* `@SendTo` can now be specified at the class level to share a common reply destination.
+* `@JmsListener` and `@JmsListeners` may now be used as _meta-annotations_ to create
+  custom _composed annotations_ with attribute overrides.
 
 === Web Improvements
 
@@ -694,6 +699,8 @@ Spring 4.3 also improves the caching abstraction as follows:
   definitions have been loaded into the context but _before_ the context has been refreshed.
   Customizers can be registered globally by third parties, foregoing the need to implement a
   custom `ContextLoader`.
+* `@Sql` and `@SqlGroup` may now be used as _meta-annotations_ to create custom _composed
+  annotations_ with attribute overrides.
 * Server-side Spring MVC Test supports expectations on response headers with multiple values.
 * Server-side Spring MVC Test parses form data request content and populates request parameters.
 * Client-side REST test support allows indicating how many times a request is expected and