From 49aabd5ac249e02298acce06a2be037601aeb92e Mon Sep 17 00:00:00 2001
From: Sam Brannen <sam@sambrannen.com>
Date: Tue, 30 Jun 2015 00:30:42 +0200
Subject: [PATCH] Polish Javadoc for (Synthesizing)MethodParameter

---
 .../org/springframework/core/MethodParameter.java   | 13 ++++++++-----
 .../annotation/SynthesizingMethodParameter.java     |  5 ++---
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/spring-core/src/main/java/org/springframework/core/MethodParameter.java b/spring-core/src/main/java/org/springframework/core/MethodParameter.java
index 19c397e627..89b8156a0e 100644
--- a/spring-core/src/main/java/org/springframework/core/MethodParameter.java
+++ b/spring-core/src/main/java/org/springframework/core/MethodParameter.java
@@ -30,12 +30,14 @@ import org.springframework.util.Assert;
 
 /**
  * Helper class that encapsulates the specification of a method parameter, i.e.
- * a Method or Constructor plus a parameter index and a nested type index for
- * a declared generic type. Useful as a specification object to pass along.
+ * a {@link Method} or {@link Constructor} plus a parameter index and a nested
+ * type index for a declared generic type. Useful as a specification object to
+ * pass along.
  *
- * <p>As of 4.2, there is a {@link org.springframework.core.annotation.SynthesizingMethodParameter}
- * subclass available which synthesizes annotations based on overridden annotation attributes.
- * That subclass is being used for web and message endpoint processing, in particular.
+ * <p>As of 4.2, there is a {@link org.springframework.core.annotation.SynthesizingMethodParameter
+ * SynthesizingMethodParameter} subclass available which synthesizes annotations
+ * with attribute aliases. That subclass is used for web and message endpoint
+ * processing, in particular.
  *
  * @author Juergen Hoeller
  * @author Rob Harrop
@@ -43,6 +45,7 @@ import org.springframework.util.Assert;
  * @author Sam Brannen
  * @since 2.0
  * @see GenericCollectionTypeResolver
+ * @see org.springframework.core.annotation.SynthesizingMethodParameter
  */
 public class MethodParameter {
 
diff --git a/spring-core/src/main/java/org/springframework/core/annotation/SynthesizingMethodParameter.java b/spring-core/src/main/java/org/springframework/core/annotation/SynthesizingMethodParameter.java
index af26f0a345..a6915e76e9 100644
--- a/spring-core/src/main/java/org/springframework/core/annotation/SynthesizingMethodParameter.java
+++ b/spring-core/src/main/java/org/springframework/core/annotation/SynthesizingMethodParameter.java
@@ -22,9 +22,8 @@ import java.lang.reflect.Method;
 import org.springframework.core.MethodParameter;
 
 /**
- * A {@link MethodParameter} variant which synthesizes annotations
- * based on overridden annotation attributes, e.g. as declared with
- * {@link AliasFor @AliasFor}.
+ * A {@link MethodParameter} variant which synthesizes annotations that
+ * declare attribute aliases via {@link AliasFor @AliasFor}.
  *
  * @author Juergen Hoeller
  * @author Sam Brannen