From c13f6895379fca74c62b2ccf47bd8fd36222ebea Mon Sep 17 00:00:00 2001
From: Sam Brannen <sam@sambrannen.com>
Date: Sun, 24 May 2015 00:13:53 +0200
Subject: [PATCH] Document isSynthesizable() in AnnotationUtils

Issue: SPR-11512
---
 .../core/annotation/AnnotationUtils.java            | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java b/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java
index ebf091ad7a..3f7b85ecb6 100644
--- a/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java
+++ b/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java
@@ -1110,8 +1110,19 @@ public abstract class AnnotationUtils {
 	}
 
 	/**
-	 * 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) {