Merge pull request #244 from InvisibleSmiley/fix/233

Adjust documented return types to be `$this` where the pre-existing `self` declaration was too imprecise

src/Adapter/Adapter.php

@@ -93,7 +93,7 @@ public function __construct(
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {

src/Adapter/AdapterAwareTrait.php

@@ -10,7 +10,7 @@ trait AdapterAwareTrait
     /**
      * Set db adapter
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDbAdapter(Adapter $adapter)
     {

src/Adapter/Driver/AbstractConnection.php

@@ -95,7 +95,7 @@ public function inTransaction()
 
     /**
      * @param  array $connectionParameters
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setConnectionParameters(array $connectionParameters)
     {
@@ -107,7 +107,7 @@ public function setConnectionParameters(array $connectionParameters)
     /**
      * {@inheritDoc}
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(ProfilerInterface $profiler)
     {

src/Adapter/Driver/IbmDb2/Connection.php

@@ -57,7 +57,7 @@ public function __construct($connectionParameters = null)
     /**
      * Set driver
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDriver(IbmDb2 $driver)
     {
@@ -68,7 +68,7 @@ public function setDriver(IbmDb2 $driver)
 
     /**
      * @param  resource $resource DB2 resource
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setResource($resource)
     {
@@ -204,7 +204,7 @@ public function commit()
     /**
      * Rollback
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      * @throws Exception\RuntimeException
      */
     public function rollback()

src/Adapter/Driver/IbmDb2/IbmDb2.php

@@ -40,7 +40,7 @@ public function __construct($connection, ?Statement $statementPrototype = null,
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {
@@ -63,7 +63,7 @@ public function getProfiler()
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerConnection(Connection $connection)
     {
@@ -73,7 +73,7 @@ public function registerConnection(Connection $connection)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerStatementPrototype(Statement $statementPrototype)
     {
@@ -83,7 +83,7 @@ public function registerStatementPrototype(Statement $statementPrototype)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerResultPrototype(Result $resultPrototype)
     {

src/Adapter/Driver/IbmDb2/Result.php

@@ -27,7 +27,7 @@ class Result implements ResultInterface
     /**
      * @param  resource $resource
      * @param  mixed $generatedValue
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function initialize($resource, $generatedValue = null)
     {

src/Adapter/Driver/IbmDb2/Statement.php

@@ -42,7 +42,7 @@ class Statement implements StatementInterface, Profiler\ProfilerAwareInterface
 
     /**
      * @param resource $resource
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function initialize($resource)
     {
@@ -51,7 +51,7 @@ public function initialize($resource)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDriver(IbmDb2 $driver)
     {
@@ -60,7 +60,7 @@ public function setDriver(IbmDb2 $driver)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {
@@ -80,7 +80,7 @@ public function getProfiler()
      * Set sql
      *
      * @param null|string $sql
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setSql($sql)
     {
@@ -101,7 +101,7 @@ public function getSql()
     /**
      * Set parameter container
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setParameterContainer(ParameterContainer $parameterContainer)
     {
@@ -145,7 +145,7 @@ public function getResource()
      * Prepare sql
      *
      * @param string|null $sql
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      * @throws Exception\RuntimeException
      */
     public function prepare($sql = null)

src/Adapter/Driver/Mysqli/Connection.php

@@ -44,7 +44,7 @@ public function __construct($connectionInfo = null)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDriver(Mysqli $driver)
     {
@@ -71,7 +71,7 @@ public function getCurrentSchema()
     /**
      * Set resource
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setResource(\mysqli $resource)
     {

src/Adapter/Driver/Mysqli/Mysqli.php

@@ -55,7 +55,7 @@ public function __construct(
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {
@@ -80,7 +80,7 @@ public function getProfiler()
     /**
      * Register connection
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerConnection(Connection $connection)
     {

src/Adapter/Driver/Mysqli/Result.php

@@ -64,7 +64,7 @@ class Result implements
      * @param mixed $resource
      * @param mixed $generatedValue
      * @param bool|null $isBuffered
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      * @throws Exception\InvalidArgumentException
      */
     public function initialize($resource, $generatedValue, $isBuffered = null)

src/Adapter/Driver/Mysqli/Statement.php

@@ -57,7 +57,7 @@ public function __construct($bufferResults = false)
     /**
      * Set driver
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDriver(Mysqli $driver)
     {
@@ -66,7 +66,7 @@ public function setDriver(Mysqli $driver)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {
@@ -85,7 +85,7 @@ public function getProfiler()
     /**
      * Initialize
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function initialize(\mysqli $mysqli)
     {
@@ -97,7 +97,7 @@ public function initialize(\mysqli $mysqli)
      * Set sql
      *
      * @param  string $sql
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setSql($sql)
     {
@@ -108,7 +108,7 @@ public function setSql($sql)
     /**
      * Set Parameter container
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setParameterContainer(ParameterContainer $parameterContainer)
     {
@@ -129,7 +129,7 @@ public function getResource()
     /**
      * Set resource
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setResource(mysqli_stmt $mysqliStatement)
     {
@@ -172,7 +172,7 @@ public function isPrepared()
      * Prepare
      *
      * @param string $sql
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      * @throws Exception\InvalidQueryException
      * @throws Exception\RuntimeException
      */

src/Adapter/Driver/Oci8/Connection.php

@@ -35,7 +35,7 @@ public function __construct($connectionInfo = null)
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setDriver(Oci8 $driver)
     {
@@ -65,7 +65,7 @@ public function getCurrentSchema()
      * Set resource
      *
      * @param  resource $resource
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setResource($resource)
     {

src/Adapter/Driver/Oci8/Oci8.php

@@ -69,7 +69,7 @@ public function __construct(
     }
 
     /**
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setProfiler(Profiler\ProfilerInterface $profiler)
     {
@@ -94,7 +94,7 @@ public function getProfiler()
     /**
      * Register connection
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerConnection(Connection $connection)
     {
@@ -106,7 +106,7 @@ public function registerConnection(Connection $connection)
     /**
      * Register statement prototype
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerStatementPrototype(Statement $statementPrototype)
     {
@@ -126,7 +126,7 @@ public function getStatementPrototype()
     /**
      * Register result prototype
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function registerResultPrototype(Result $resultPrototype)
     {
@@ -147,7 +147,7 @@ public function getResultPrototype()
      *
      * @param string $name
      * @param AbstractFeature $feature
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function addFeature($name, $feature)
     {
@@ -162,7 +162,7 @@ public function addFeature($name, $feature)
     /**
      * Setup the default features for Pdo
      *
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function setupDefaultFeatures()
     {

src/Adapter/Driver/Oci8/Result.php

@@ -58,7 +58,7 @@ class Result implements Iterator, ResultInterface
      * @param resource $resource
      * @param null|int $generatedValue
      * @param null|int $rowCount
-     * @return self Provides a fluent interface
+     * @return $this Provides a fluent interface
      */
     public function initialize($resource, $generatedValue = null, $rowCount = null)
     {