better php doc for redis Connection::executeCommand

framework/db/redis/Connection.php

@@ -339,15 +339,23 @@ class Connection extends Component
 	}
 
 	/**
-	 * Execute a redis command
+	 * Executes a redis command.
-	 * http://redis.io/commands
+	 * For a list of available commands and their parameters see http://redis.io/commands.
-	 * http://redis.io/topics/protocol
 	 *
-	 * @param $name
+	 * @param string $name the name of the command
-	 * @param $params
+	 * @param array $params list of parameters for the command
-	 * @return array|bool|null|string
+	 * @return array|bool|null|string Dependend on the executed command this method
-	 * Returns true on Status reply
+	 * will return different data types:
-	 * TODO explain all reply types
+	 *
+	 * - `true` for commands that return "status reply".
+	 * - `string` for commands that return "integer reply"
+	 *   as the value is in the range of a signed 64 bit integer.
+	 * - `string` or `null` for commands that return "bulk reply".
+	 * - `array` for commands that return "Multi-bulk replies".
+	 *
+	 * See [redis protocol description](http://redis.io/topics/protocol)
+	 * for details on the mentioned reply types.
+	 * @trows CException for commands that return [error reply](http://redis.io/topics/protocol#error-reply).
 	 */
 	public function executeCommand($name, $params=array())
 	{