Add consistency to method chaining DocBlocks

Author: tdutrion

src/Adapter/AbstractAdapter.php

@@ -35,8 +35,8 @@ public function getCredential()
     /**
      * Sets the credential for binding
      *
-     * @param  mixed           $credential
-     * @return AbstractAdapter
+     * @param  mixed $credential
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setCredential($credential)
     {
@@ -59,8 +59,8 @@ public function getIdentity()
     /**
      * Sets the identity for binding
      *
-     * @param  mixed          $identity
-     * @return AbstractAdapter
+     * @param  mixed $identity
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setIdentity($identity)
     {

src/Adapter/DbTable/AbstractAdapter.php

@@ -105,7 +105,7 @@ public function __construct(
      * setTableName() - set the table name to be used in the select query
      *
      * @param  string $tableName
-     * @return self Provides a fluent interface
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setTableName($tableName)
     {
@@ -117,7 +117,7 @@ public function setTableName($tableName)
      * setIdentityColumn() - set the column name to be used as the identity column
      *
      * @param  string $identityColumn
-     * @return self Provides a fluent interface
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setIdentityColumn($identityColumn)
     {
@@ -129,7 +129,7 @@ public function setIdentityColumn($identityColumn)
      * setCredentialColumn() - set the column name to be used as the credential column
      *
      * @param  string $credentialColumn
-     * @return self Provides a fluent interface
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setCredentialColumn($credentialColumn)
     {
@@ -143,7 +143,7 @@ public function setCredentialColumn($credentialColumn)
      * false) parameters. Default is false.
      *
      * @param  int|bool $flag
-     * @return self Provides a fluent interface
+     * @return AbstractAdapter Provides a fluent interface
      */
     public function setAmbiguityIdentity($flag)
     {

src/Adapter/DbTable/CallbackCheckAdapter.php

@@ -56,7 +56,7 @@ public function __construct(
      * credential.
      *
      * @param callable $validationCallback
-     * @return self
+     * @return CallbackCheckAdapter Provides a fluent interface
      * @throws Exception\InvalidArgumentException
      */
     public function setCredentialValidationCallback($validationCallback)

src/Adapter/DbTable/CredentialTreatmentAdapter.php

@@ -62,7 +62,7 @@ public function __construct(
      *  'MD5(?)'
      *
      * @param  string $treatment
-     * @return self Provides a fluent interface
+     * @return CredentialTreatmentAdapter Provides a fluent interface
      */
     public function setCredentialTreatment($treatment)
     {

src/Adapter/Http/ApacheResolver.php

@@ -50,7 +50,7 @@ public function __construct($path = '')
      * Set the path to the credentials file
      *
      * @param  string $path
-     * @return self Provides a fluent interface
+     * @return ApacheResolver Provides a fluent interface
      * @throws Exception\InvalidArgumentException if path is not readable
      */
     public function setFile($path)

src/Validator/Authentication.php

@@ -110,7 +110,7 @@ public function getAdapter()
      * Set Adapter
      *
      * @param  ValidatableAdapterInterface $adapter
-     * @return Authentication
+     * @return Authentication Provides a fluent interface
      */
     public function setAdapter(ValidatableAdapterInterface $adapter)
     {
@@ -132,8 +132,8 @@ public function getIdentity()
     /**
      * Set Identity
      *
-     * @param  mixed          $identity
-     * @return Authentication
+     * @param  mixed $identity
+     * @return Authentication Provides a fluent interface
      */
     public function setIdentity($identity)
     {
@@ -155,8 +155,8 @@ public function getCredential()
     /**
      * Set Credential
      *
-     * @param  mixed          $credential
-     * @return Authentication
+     * @param  mixed $credential
+     * @return Authentication Provides a fluent interface
      */
     public function setCredential($credential)
     {
@@ -179,7 +179,7 @@ public function getService()
      * Set Service
      *
      * @param  AuthenticationService $service
-     * @return Authentication
+     * @return Authentication Provides a fluent interface
      */
     public function setService(AuthenticationService $service)
     {