Release 1.1. Added docs into README about auto-generated parameters.

Author: elw00d

README.md

@@ -32,7 +32,7 @@ mybatis-freemarker is available in [jcenter](https://bintray.com/bintray/jcenter
     <dependency>
         <groupId>org.mybatis.scripting</groupId>
         <artifactId>mybatis-freemarker</artifactId>
-        <version>1.0</version>
+        <version>1.1</version>
     </dependency>
 </dependencies>
 ```
@@ -45,7 +45,7 @@ repositories {
 }
 
 dependencies {
-    compile("org.mybatis.scripting:mybatis-freemarker:1.0")
+    compile("org.mybatis.scripting:mybatis-freemarker:1.1")
 }
 ```
 
@@ -156,6 +156,37 @@ As in annotations, you can write inline scripts or template names.
 </select>
 ```
 
+## Prepared statements parameters
+
+`<@p/>` directive can be used in two scenarios:
+
+- To pass parameters to prepared statements AS IS:
+
+`<@p name='id'/>` (will be translated to `#{id}`, and value already presents in parameter object)
+
+- To pass any value as prepared statements parameter
+
+`<@p value=someValue/>` will be converted to `#{_p0}`, and `_p0` parameter will be automatically added to parameters map. It is convenient to use in loops like this:
+
+```ftl
+select * from names where firstName in (
+    <#list ids as id>
+        <@p value=id/>
+        <#if id_has_next>,</#if>
+    </#list>
+)
+```
+
+This markup will be translated to
+
+```sql
+select * from names where firstName in (#{_p0}, #{_p1}, #{_p2})
+```
+
+and there are no need to care about escaping. All this stuff will be done automatically by JDBC driver.
+
+Unfortunately, you can't use this syntax if passing one object as parameter and without `@Param` annotation. The `UnsupportedOperationException` will be thrown. It is because appending additional parameters to some object in general is very hard. When you are using `@Param` annotated args, MyBatis will use `Map` to store parameters, and it is easy to add some generated params. So, if you want to use auto-generated prepared parameters, please don't forget about `@Param` annotation.
+
 ## Examples
 
 You can view full-featured example of configuring and of both XML-mapper and annotations-driven mapper usage in [test suite](https://github.com/elw00d/mybatis-freemarker/tree/master/src/test)

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>org.mybatis.scripting</groupId>
     <artifactId>mybatis-freemarker</artifactId>
-    <version>1.0</version>
+    <version>1.1</version>
     <packaging>jar</packaging>
 
     <name>MyBatis FreeMarker</name>