Style fixes and docs

Author: Nyholm

src/HttpClientPool.php

@@ -13,13 +13,15 @@
  */
 abstract class HttpClientPool implements HttpAsyncClient, HttpClient
 {
-    /** @var HttpClientPoolItem[] */
+    /**
+     * @var HttpClientPoolItem[]
+     */
     protected $clientPool = [];
 
     /**
      * Add a client to the pool.
      *
-     * @param HttpClient|HttpAsyncClient $client
+     * @param HttpClient|HttpAsyncClient|HttpClientPoolItem $client
      */
     public function addHttpClient($client)
     {

src/HttpClientPoolItem.php

@@ -17,21 +17,29 @@
  */
 class HttpClientPoolItem implements HttpClient, HttpAsyncClient
 {
-    /** @var int Number of request this client is currently sending */
+    /**
+     * @var int Number of request this client is currently sending
+     */
     private $sendingRequestCount = 0;
 
-    /** @var \DateTime|null Time when this client has been disabled or null if enable */
+    /**
+     * @var \DateTime|null Time when this client has been disabled or null if enable
+     */
     private $disabledAt;
 
-    /** @var int|null Number of seconds after this client is reenable, by default null: never reenable this client */
+    /**
+     * @var int|null Number of seconds after this client is reenable, by default null: never reenable this client
+     */
     private $reenableAfter;
 
-    /** @var FlexibleHttpClient A http client responding to async and sync request */
+    /**
+     * @var FlexibleHttpClient A http client responding to async and sync request
+     */
     private $client;
 
     /**
-     * {@inheritdoc}
      *
+     * @param HttpClient|HttpAsyncClient $client
      * @param null|int $reenableAfter Number of seconds after this client is reenable
      */
     public function __construct($client, $reenableAfter = null)
@@ -91,9 +99,11 @@ public function sendAsyncRequest(RequestInterface $request)
      *
      * Will also reactivate this client if possible
      *
+     * @internal
+     *
      * @return bool
      */
-    public function isDisabled()
+    final public function isDisabled()
     {
         $disabledAt = $this->getDisabledAt();
 
@@ -116,9 +126,11 @@ public function isDisabled()
     /**
      * Get current number of request that is send by the underlying http client.
      *
+     * @internal
+     *
      * @return int
      */
-    public function getSendingRequestCount()
+    final public function getSendingRequestCount()
     {
         return $this->sendingRequestCount;
     }