Merge pull request #2799 from tolbon/FixDocsSharding

Fix Shard Manager docs with more accurate docblocks in `SQLAzureShardManager` and `PoolingShardManager`

lib/Doctrine/DBAL/Sharding/PoolingShardManager.php

@@ -54,7 +54,7 @@ class PoolingShardManager implements ShardManager
     }
 
     /**
-     * @return void
+     * {@inheritDoc}
      */
     public function selectGlobal()
     {
@@ -63,9 +63,7 @@ class PoolingShardManager implements ShardManager
     }
 
     /**
-     * @param string $distributionValue
-     *
-     * @return void
+     * {@inheritDoc}
      */
     public function selectShard($distributionValue)
     {
@@ -75,7 +73,7 @@ class PoolingShardManager implements ShardManager
     }
 
     /**
-     * @return string|null
+     * {@inheritDoc}
      */
     public function getCurrentDistributionValue()
     {
@@ -83,7 +81,7 @@ class PoolingShardManager implements ShardManager
     }
 
     /**
-     * @return array
+     * {@inheritDoc}
      */
     public function getShards()
     {

lib/Doctrine/DBAL/Sharding/SQLAzure/SQLAzureShardManager.php

@@ -19,9 +19,9 @@
 
 namespace Doctrine\DBAL\Sharding\SQLAzure;
 
-use Doctrine\DBAL\Sharding\ShardManager;
-use Doctrine\DBAL\Sharding\ShardingException;
 use Doctrine\DBAL\Connection;
+use Doctrine\DBAL\Sharding\ShardingException;
+use Doctrine\DBAL\Sharding\ShardManager;
 use Doctrine\DBAL\Types\Type;
 
 /**
@@ -57,7 +57,7 @@ class SQLAzureShardManager implements ShardManager
     private $conn;
 
     /**
-     * @var string
+     * @var string|null
      */
     private $currentDistributionValue;
 

lib/Doctrine/DBAL/Sharding/ShardManager.php

@@ -63,7 +63,7 @@ interface ShardManager
     /**
      * Gets the distribution value currently used for sharding.
      *
-     * @return string
+     * @return string|null
      */
     function getCurrentDistributionValue();