Merge pull request #210 from apache/feature/include-tag-params
Clarifies how to access parameters
diff --git a/source/tag-developers/include-tag.md b/source/tag-developers/include-tag.md
index 514231d..5f6c540 100644
--- a/source/tag-developers/include-tag.md
+++ b/source/tag-developers/include-tag.md
@@ -18,10 +18,28 @@
> through the `<s:property.../>` tag since no ValueStack will be created. You can, however, access them in a servlet
> via the HttpServletRequest object or from a JSP page via a scriptlet.
-**How To access parameters**
+### How to access parameters
-Parameters are passed as request parameters, so use the `${param.ParamName}` notation to access them. Do not use
-the **property** tag to access parameters in included files.
+Parameters are passed as request parameters, so use the `${param.paramName}` notation to access them. Do not use
+the `<s:property/>` tag to access parameters in included files.
+
+Below it's an example how you can access parameters passed into the included page:
+
+with scope:
+```
+<s:set var="innerName" scope="page">${param.paramName}</s:set>
+<s:property value="#attr.innerName"/>
+```
+
+with no scope:
+```jsp
+<s:set var="innerName">${param.paramName}</s:set>
+<s:property value="innerName"/>
+<s:property value="#attr.innerName"/>
+<s:property value="#innerName"/>
+```
+
+> **Note**: You can access such params without using JSTL, just use `${param.paramName}` notation.
## Attributes
@@ -46,7 +64,7 @@
</s:include>
```
-do an include to myJsp.jsp page with parameters `param1=value1` and `param2=value2`
+do an include to `myJsp.jsp` page with parameters `param1=value1` and `param2=value2`
**Example 3**
@@ -57,4 +75,23 @@
</s:include>
```
-do an include to myJsp.jsp page with parameters `param1=value1` and `param2=value2`
+do an include to `myJsp.jsp` page with parameters `param1=value1` and `param2=value2`
+
+**Example 4**
+
+accessing passed parameters in the included page
+
+with scope:
+```jsp
+<s:set var="param1" scope="page">${param.param1}</s:set>
+<s:property value="#attr.param1"/>
+```
+
+with no scope:
+```jsp
+<s:set var="param2">${param.param2}</s:set>
+<s:property value="param2"/>
+
+<s:property value="#attr.param2"/>
+<s:property value="#param2"/>
+```
