🚿 clean up docblocks

Author: codemasher

src/Core/OAuth1Provider.php

@@ -72,10 +72,6 @@ public function getRequestToken():AccessToken{
 	 *
 	 * @link https://tools.ietf.org/html/rfc5849#section-2.1
 	 *
-	 * @param \Psr\Http\Message\ResponseInterface $response
-	 * @param bool|null                           $checkCallbackConfirmed
-	 *
-	 * @return \chillerlan\OAuth\Core\AccessToken
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 */
 	protected function parseTokenResponse(ResponseInterface $response, bool $checkCallbackConfirmed = null):AccessToken{
@@ -116,8 +112,6 @@ protected function parseTokenResponse(ResponseInterface $response, bool $checkCa
 
 	/**
 	 * returns a 32 byte random string (in hexadecimal representation) for use as a nonce
-	 *
-	 * @return string
 	 */
 	protected function nonce():string{
 		$nonce = random_bytes(32);
@@ -134,12 +128,6 @@ protected function nonce():string{
 	 *
 	 * @link https://tools.ietf.org/html/rfc5849#section-3.4
 	 *
-	 * @param string      $url
-	 * @param array       $params
-	 * @param string      $method
-	 * @param string|null $accessTokenSecret
-	 *
-	 * @return string
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 */
 	protected function getSignature(string $url, array $params, string $method, string $accessTokenSecret = null):string{

src/Core/OAuth2Provider.php

@@ -99,9 +99,6 @@ public function getAuthURL(array $params = null, array $scopes = null):UriInterf
 	 *
 	 * @link https://tools.ietf.org/html/rfc6749#section-4.1.4
 	 *
-	 * @param \Psr\Http\Message\ResponseInterface $response
-	 *
-	 * @return \chillerlan\OAuth\Core\AccessToken
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 * @throws \JsonException
 	 */
@@ -196,9 +193,6 @@ public function getRequestAuthorization(RequestInterface $request, AccessToken $
 	 *
 	 * @see \chillerlan\OAuth\Core\ClientCredentials
 	 *
-	 * @param array|null $scopes
-	 *
-	 * @return \chillerlan\OAuth\Core\AccessToken
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 */
 	public function getClientCredentialsToken(array $scopes = null):AccessToken{
@@ -237,9 +231,6 @@ public function getClientCredentialsToken(array $scopes = null):AccessToken{
 	 *
 	 * @see \chillerlan\OAuth\Core\TokenRefresh
 	 *
-	 * @param \chillerlan\OAuth\Core\AccessToken|null $token
-	 *
-	 * @return \chillerlan\OAuth\Core\AccessToken
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 */
 	public function refreshAccessToken(AccessToken $token = null):AccessToken{
@@ -296,9 +287,6 @@ public function refreshAccessToken(AccessToken $token = null):AccessToken{
 	 *
 	 * @see \chillerlan\OAuth\Core\CSRFToken
 	 *
-	 * @param string|null $state
-	 *
-	 * @return void
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 * @internal
 	 */
@@ -326,9 +314,6 @@ public function checkState(string $state = null):void{
 	 *
 	 * @see \chillerlan\OAuth\Core\CSRFToken
 	 *
-	 * @param array $params
-	 *
-	 * @return array
 	 * @throws \chillerlan\OAuth\Core\ProviderException
 	 * @internal
 	 */

src/Core/OAuthProvider.php

@@ -144,11 +144,6 @@ abstract class OAuthProvider implements OAuthInterface{
 	/**
 	 * OAuthProvider constructor.
 	 *
-	 * @param \Psr\Http\Client\ClientInterface                $http
-	 * @param \chillerlan\OAuth\Storage\OAuthStorageInterface $storage
-	 * @param \chillerlan\Settings\SettingsContainerInterface $options
-	 * @param \Psr\Log\LoggerInterface|null                   $logger
-	 *
 	 * @throws \chillerlan\OAuth\MagicAPI\ApiClientException
 	 */
 	public function __construct(
@@ -240,10 +235,6 @@ public function setUriFactory(UriFactoryInterface $uriFactory):OAuthInterface{
 	/**
 	 * Magic API endpoint access. ugly, isn't it?
 	 *
-	 * @param string $endpointName
-	 * @param array  $arguments
-	 *
-	 * @return \Psr\Http\Message\ResponseInterface
 	 * @throws \chillerlan\OAuth\MagicAPI\ApiClientException
 	 */
 	public function __call(string $endpointName, array $arguments):ResponseInterface{