Add scripting documentation

docs/src/reference/docbook/reference/redis-scripting.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="scripting">
+  <title>Redis Scripting</title>
+  <para>Redis versions 2.6 and higher provide support for execution of Lua scripts through the <ulink url="http://redis.io/commands/eval">eval</ulink> and
+    <ulink url="http://redis.io/commands/evalsha">evalsha</ulink> commands. These operations as well as other script management operations are available on the 
+    <interfacename>RedisConnection</interfacename> implementations.
+  </para>
+
+   <para>Future SDR versions may offer support for these scripting commands on a higher-level API, such as <literal>RedisTemplate</literal>.</para>
+   
+   <para>Here's an example script execution:</para>
+
+   <programlisting language="java"><![CDATA[// execute script
+Long magicNumber = redisTemplate.execute(new RedisCallback<Long>() {
+    public Long doInRedis(RedisConnection connection) throws DataAccessException {
+        return connection.eval("return 10", ReturnType.INTEGER, 0);
+    }
+});]]></programlisting>	
+
+    <para>The return values of <literal>eval</literal> and <literal>evalsha</literal> can be assigned to any type. However, they should
+    match the expected <literal>ReturnType</literal> passed to these methods. In the above example, we passed ReturnType.Integer, therefore
+    the return type of <literal>eval</literal> was a Long. Similarly, using ReturnType.VALUE will yield a byte[]. See the ReturnType javadoc
+    for details.</para>
+    
+</section>

docs/src/reference/docbook/reference/redis-transactions.xml

@@ -10,13 +10,13 @@
    as when using Redis transactions. For example:
    </para>
 
-   <programlisting lang="java"><![CDATA[ //execute a transaction
+   <programlisting language="java"><![CDATA[ //execute a transaction
 redisTemplate.execute(new SessionCallback<Object>() {
-	public Object execute(RedisOperations operations) throws DataAccessException {
-		operations.multi();
-		operations.opsForValue().set("key", "value");
-		List<Object> results =  operations.exec();
-		return null;
-	}
+    public Object execute(RedisOperations operations) throws DataAccessException {
+        operations.multi();
+        operations.opsForValue().set("key", "value");
+        List<Object> results =  operations.exec();
+        return null;
+    }
 });]]></programlisting>
 </section>

docs/src/reference/docbook/reference/redis.xml

@@ -395,6 +395,8 @@
     
     <xi:include href="redis-transactions.xml"/>
 
+    <xi:include href="redis-scripting.xml"/>
+
     <section id="redis:support">
       <title>Support Classes</title>
       

src/main/java/org/springframework/data/redis/connection/ReturnType.java

@@ -23,5 +23,19 @@ package org.springframework.data.redis.connection;
  * 
  */
 public enum ReturnType {
-	BOOLEAN, INTEGER, MULTI, STATUS, VALUE
+
+	/** Returned as Boolean **/
+	BOOLEAN,
+
+	/** Returned as Long **/
+	INTEGER,
+
+	/** Returned as List<Object> **/
+	MULTI,
+
+	/** Returned as byte[] **/
+	STATUS,
+
+	/** Returned as byte[] **/
+	VALUE
 }