[phpdoc] Add API documentation.

This is a starting point to add a documentation of the whole set of APIs and
classes of Predis. The next step will be to actually improve and extend it.

lib/Predis/Protocol/Text/ResponseMultiBulkHandler.php

@@ -16,8 +16,22 @@ use Predis\Protocol\IResponseHandler;
 use Predis\Protocol\ProtocolException;
 use Predis\Network\IConnectionComposable;
 
+/**
+ * Implements a response handler for multi-bulk replies using the standard
+ * wire protocol defined by Redis.
+ *
+ * @link http://redis.io/topics/protocol
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
 class ResponseMultiBulkHandler implements IResponseHandler
 {
+    /**
+     * Handles a multi-bulk reply returned by Redis.
+     *
+     * @param IConnectionComposable $connection Connection to Redis.
+     * @param string $lengthString Number of items in the multi-bulk reply.
+     * @return array
+     */
     public function handle(IConnectionComposable $connection, $lengthString)
     {
         $length = (int) $lengthString;