From d34eb7adcbef5b68a4c4b9dfbfbc023685fd116f Mon Sep 17 00:00:00 2001
From: Maurizio Cucchiara <mcucchiara@apache.org>
Date: Tue, 25 Oct 2011 23:14:09 +0000
Subject: [PATCH] WW-3652 - Add example for "anchor" (aka "hash" or "fragment")
 to RedirectActionResult docs (patch submitted by Jeff Black)

git-svn-id: https://svn.apache.org/repos/asf/struts/struts2/trunk@1188963 13f79535-47bb-0310-9956-ffa450edef68
---
 .../ServletActionRedirectResult.java          | 24 ++++++++++++-------
 .../dispatcher/ServletRedirectResult.java     |  8 +++++--
 2 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/core/src/main/java/org/apache/struts2/dispatcher/ServletActionRedirectResult.java b/core/src/main/java/org/apache/struts2/dispatcher/ServletActionRedirectResult.java
index 8c80ec4e3..e230e169c 100644
--- a/core/src/main/java/org/apache/struts2/dispatcher/ServletActionRedirectResult.java
+++ b/core/src/main/java/org/apache/struts2/dispatcher/ServletActionRedirectResult.java
@@ -56,17 +56,22 @@ import com.opensymphony.xwork2.util.reflection.ReflectionExceptionHandler;
  * 
  * <ul>
  * 
- * <li><b>actionName (default)</b> - the name of the action that will be
- * redirect to</li>
+ * <li><b>actionName (default)</b> - The name of the action that will be
+ * redirected to.</li>
  * 
- * <li><b>namespace</b> - used to determine which namespace the action is in
- * that we're redirecting to . If namespace is null, this defaults to the
- * current namespace</li>
+ * <li><b>namespace</b> - Used to determine which namespace the action is in
+ * that we're redirecting to.  If namespace is null, the default will be the
+ * current namespace.</li>
  * 
- * <li><b>suppressEmptyParameters</b> - optional boolean (defaults to false) that
+ * <li><b>suppressEmptyParameters</b> - Optional boolean (defaults to false) that
  * can prevent parameters with no values from being included in the redirect
  * URL.</li>
- * 
+ *
+ * <li><b>parse</b> - Boolean, true by default.  If set to false, the actionName 
+ * param will not be parsed for Ognl expressions.</li>
+ *
+ * <li><b>anchor</b> - Optional.  Also known as "fragment" or colloquially as 
+ * "hash".  You can specify an anchor for a result.</li>
  * </ul>
  * 
  * <!-- END SNIPPET: params -->
@@ -98,10 +103,10 @@ import com.opensymphony.xwork2.util.reflection.ReflectionExceptionHandler;
  * &lt;/package&gt;
  * 
  * &lt;package name="passingRequestParameters" extends="struts-default" namespace="/passingRequestParameters"&gt;
- *    &lt;-- Pass parameters (reportType, width and height) --&gt;
+ *    &lt;!-- Pass parameters (reportType, width and height) --&gt;
  *    &lt;!--
  *    The redirectAction url generated will be :
- *    /genReport/generateReport.action?reportType=pie&width=100&height=100
+ *    /genReport/generateReport.action?reportType=pie&width=100&height=100#summary
  *    --&gt;
  *    &lt;action name="gatherReportInfo" class="..."&gt;
  *       &lt;result name="showReportResult" type="redirectAction"&gt;
@@ -112,6 +117,7 @@ import com.opensymphony.xwork2.util.reflection.ReflectionExceptionHandler;
  *          &lt;param name="height"&gt;100&lt;/param&gt;
  *          &lt;param name="empty"&gt;&lt;/param&gt;
  *          &lt;param name="suppressEmptyParameters"&gt;true&lt;/param&gt;
+ *          &lt;param name="anchor"&gt;summary&lt;/param&gt;
  *       &lt;/result&gt;
  *    &lt;/action&gt;
  * &lt;/package&gt;
diff --git a/core/src/main/java/org/apache/struts2/dispatcher/ServletRedirectResult.java b/core/src/main/java/org/apache/struts2/dispatcher/ServletRedirectResult.java
index f779aa1c4..5a1115069 100644
--- a/core/src/main/java/org/apache/struts2/dispatcher/ServletRedirectResult.java
+++ b/core/src/main/java/org/apache/struts2/dispatcher/ServletRedirectResult.java
@@ -72,8 +72,8 @@ import com.opensymphony.xwork2.util.reflection.ReflectionExceptionHandler;
  * <li><b>parse</b> - true by default. If set to false, the location param will
  * not be parsed for Ognl expressions.</li>
  * 
- * <li><b>anchor</b> - optional, you can specify an anchor for result.</li>
- * 
+ * <li><b>anchor</b> - Optional.  Also known as "fragment" or colloquially as 
+ * "hash".  You can specify an anchor for a result.</li>
  * </ul>
  * 
  * <p>
@@ -86,6 +86,10 @@ import com.opensymphony.xwork2.util.reflection.ReflectionExceptionHandler;
  * 
  * <pre>
  * <!-- START SNIPPET: example -->
+ * &lt;!--
+ *   The redirect URL generated will be:
+ *   /foo.jsp#FRAGMENT
+ * --&gt;
  * &lt;result name="success" type="redirect"&gt;
  *   &lt;param name="location"&gt;foo.jsp&lt;/param&gt;
  *   &lt;param name="parse"&gt;false&lt;/param&gt;