Change some @see into @param or @param and add some descriptions

Author: bjori

docs/api/MongoDB/Command/CommandCursor.php

@@ -44,23 +44,23 @@ public function getId()
     }
 
     /**
-     * @see Cursor::getServer()
+     * @return Server Server from which the cursor originated
      */
     public function getServer()
     {
         return $this->server;
     }
 
     /**
-     * @see Cursor::isDead()
+     * @return boolean Whether the cursor is exhausted and has no more results
      */
     public function isDead()
     {
         // Return whether the cursor is exhausted and has no more results
     }
 
     /**
-     * @see \MongoDB\Cursor::setBatchSize()
+     * @param integer $batchSize
      */
     public function setBatchSize($batchSize)
     {

docs/api/MongoDB/Manager.php

@@ -25,6 +25,8 @@
 final class Manager
 {
     /**
+     * Constructs a new Manager
+     *
      * @param string $uri           Connection URI
      * @param array  $options       Connection options (e.g. auth, socket timeouts)
      * @param array  $driverOptions Driver options (e.g. stream contexts)
@@ -35,6 +37,8 @@ public function __construct($uri, array $options = array(), array $driverOptions
     }
 
     /**
+     * Creates new Manager from a list of servers
+     *
      * @param Server[] $servers
      * @return Manager
      */
@@ -50,6 +54,8 @@ static public function createFromServers(array $servers)
     }
 
     /**
+     * Execute a command
+     *
      * @param string         $db
      * @param Command        $command
      * @param ReadPreference $readPreference
@@ -72,6 +78,8 @@ public function executeCommand($db, Command $command, ReadPreference $readPrefer
     }
 
     /**
+     * Execute a Query
+     *
      * @param string         $namespace
      * @param Query          $query
      * @param ReadPreference $readPreference
@@ -92,6 +100,8 @@ public function executeQuery($namespace, Query $query, ReadPreference $readPrefe
     }
 
     /**
+     * Executes a write operation batch (e.g. insert, update, delete)
+     *
      * @param string     $namespace
      * @param WriteBatch $batch
      * @param array      $writeOptions Ordering and write concern options (default: {"ordered": true, "w": 1})

docs/api/MongoDB/Query/QueryCursor.php

@@ -22,6 +22,8 @@ final class QueryCursor implements Cursor
     private $cursorId;
 
     /**
+     * Construct a new QueryCursor
+     *
      * @param Server   $server
      * @param CursorId $cursorId
      */
@@ -32,31 +34,31 @@ public function __construct(Server $server, CursorId $cursorId)
     }
 
     /**
-     * @see Cursor::getId()
+     * @return CursorId
      */
     public function getId()
     {
         return $this->cursorId;
     }
 
     /**
-     * @see Cursor::getServer()
+     * @return Server Server from which the cursor originated
      */
     public function getServer()
     {
         return $this->server;
     }
 
     /**
-     * @see Cursor::isDead()
+     * @return boolean Whether the cursor is exhausted and has no more results
      */
     public function isDead()
     {
         // Return whether the cursor is exhausted and has no more results
     }
 
     /**
-     * @see Cursor::setBatchSize()
+     * @param integer $batchSize
      */
     public function setBatchSize($batchSize)
     {

docs/api/MongoDB/Write/DeleteBatch.php

@@ -10,7 +10,7 @@ final class DeleteBatch implements WriteBatch
     private $documents;
 
     /**
-     * @see WriteBatch::add()
+     * @param array|object $document Operation/document to add to the batch
      */
     public function add($document)
     {

docs/api/MongoDB/Write/InsertBatch.php

@@ -10,7 +10,7 @@ final class InsertBatch implements WriteBatch
     private $documents;
 
     /**
-     * @see WriteBatch::add()
+     * @param array|object $document Operation/document to add to the batch
      */
     public function add($document)
     {

docs/api/MongoDB/Write/UpdateBatch.php

@@ -10,7 +10,7 @@ final class UpdateBatch implements WriteBatch
     private $documents;
 
     /**
-     * @see WriteBatch::add()
+     * @param array|object $document Operation/document to add to the batch
      */
     public function add($document)
     {