Document isSynthesizable() in AnnotationUtils

Issue: SPR-11512

Author: sbrannen

spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java

@@ -1110,8 +1110,19 @@ private static Map<String, String> getAttributeAliasMap(Class<? extends Annotati
 	}
 
 	/**
-	 * TODO Document isSynthesizable().
+	 * Determine if annotations of the supplied {@code annotationType} are
+	 * <em>synthesizable</em> (i.e., in need of being wrapped in a dynamic
+	 * proxy that provides functionality above that of a standard JDK
+	 * annotation).
+	 *
+	 * <p>Specifically, an annotation is <em>synthesizable</em> if it declares
+	 * any attributes that are configured as <em>aliased pairs</em> via
+	 * {@link AliasFor @AliasFor} or if any nested annotations used by the
+	 * annotation declare such <em>aliased pairs</em>.
+	 *
 	 * @since 4.2
+	 * @see SynthesizedAnnotation
+	 * @see SynthesizedAnnotationInvocationHandler
 	 */
 	@SuppressWarnings("unchecked")
 	private static boolean isSynthesizable(Class<? extends Annotation> annotationType) {