From c52c78d02015eb87f200b717ca5171bc84e4d0d9 Mon Sep 17 00:00:00 2001
From: Rossen Stoyanchev <rstoyanchev@vmware.com>
Date: Tue, 1 May 2012 16:29:39 -0400
Subject: [PATCH] Javadoc update

Issue: SPR-9265
---
 .../web/bind/annotation/RequestParam.java              | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java
index 0997a589696..2c3d7ecec28 100644
--- a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java
+++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java
@@ -21,12 +21,22 @@ import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import java.util.Map;
 
 /**
  * Annotation which indicates that a method parameter should be bound to a web
  * request parameter. Supported for annotated handler methods in Servlet and
  * Portlet environments.
  *
+ * <p>If the method parameter type is {@link Map} and a request parameter name
+ * is specified, then the request parameter value is converted to a {@link Map}
+ * assuming an appropriate conversion strategy is available.
+ *
+ * <p>If the method parameter is {@link java.util.Map Map&lt;String, String&gt;} or
+ * {@link org.springframework.util.MultiValueMap MultiValueMap&lt;String, String&gt;}
+ * and a parameter name is not specified, then the map parameter is populated
+ * with all request parameter names and values.
+ *
  * @author Arjen Poutsma
  * @author Juergen Hoeller
  * @since 2.5