From 95af07990690de2fd8f121e6dea8a99976db0c4c Mon Sep 17 00:00:00 2001
From: Sam Brannen <sbrannen@pivotal.io>
Date: Thu, 31 Oct 2019 15:27:27 +0100
Subject: [PATCH] Document unidirectional @AliasFor attribute mapping support

See gh-23834
---
 .../org/springframework/core/annotation/AliasFor.java     | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/spring-core/src/main/java/org/springframework/core/annotation/AliasFor.java b/spring-core/src/main/java/org/springframework/core/annotation/AliasFor.java
index c5bd5053e7d..88d7d78470b 100644
--- a/spring-core/src/main/java/org/springframework/core/annotation/AliasFor.java
+++ b/spring-core/src/main/java/org/springframework/core/annotation/AliasFor.java
@@ -57,9 +57,13 @@ import java.lang.annotation.Target;
  * <ul>
  * <li><strong>Explicit aliases within an annotation</strong>:
  * <ol>
- * <li>Each attribute that makes up an aliased pair must be annotated with
+ * <li>Each attribute that makes up an aliased pair should be annotated with
  * {@code @AliasFor}, and either {@link #attribute} or {@link #value} must
- * reference the <em>other</em> attribute in the pair.</li>
+ * reference the <em>other</em> attribute in the pair. Since Spring Framework
+ * 5.2.1 it is technically possible to annotate only one of the attributes in an
+ * aliased pair; however, it is recommended to annotate both attributes in an
+ * aliased pair for better documentation as well as compatibility with previous
+ * versions of the Spring Framework.</li>
  * <li>Aliased attributes must declare the same return type.</li>
  * <li>Aliased attributes must declare a default value.</li>
  * <li>Aliased attributes must declare the same default value.</li>