docs: fix phpdoc for some method return types (#2113)

amackiewicz · web-flow · commit 3a981757c0e6 · 2021-08-27T09:57:39.000-07:00
diff --git a/.gitignore b/.gitignore
@@ -6,3 +6,4 @@ vendor
 examples/testfile-small.txt
 examples/testfile.txt
 tests/.apiKey
+.idea/
diff --git a/src/Client.php b/src/Client.php
@@ -856,7 +856,7 @@ public function prepareScopes()
    * @param $request RequestInterface|\Google\Http\Batch
    * @param string $expectedClass
    * @throws \Google\Exception
-   * @return object of the type of the expected class or Psr\Http\Message\ResponseInterface.
+   * @return mixed|$expectedClass|ResponseInterface
    */
   public function execute(RequestInterface $request, $expectedClass = null)
   {
diff --git a/src/Http/REST.php b/src/Http/REST.php
@@ -41,7 +41,7 @@ class REST
    * @param string $expectedClass
    * @param array $config
    * @param array $retryMap
-   * @return array decoded result
+   * @return mixed decoded result
    * @throws \Google\Service\Exception on server side error (ie: not authenticated,
    *  invalid or malformed post body, invalid url)
    */
diff --git a/src/Service/Resource.php b/src/Service/Resource.php
@@ -80,7 +80,7 @@ public function __construct($service, $serviceName, $resourceName, $resource)
    * @param $name
    * @param $arguments
    * @param $expectedClass - optional, the expected class name
-   * @return Request|$expectedClass
+   * @return mixed|$expectedClass|ResponseInterface|RequestInterface
    * @throws \Google\Exception
    */
   public function call($name, $arguments, $expectedClass = null)

Original file line number	Diff line number	Diff line change
`@@ -856,7 +856,7 @@ public function prepareScopes()`
`856`	`856`	`* @param $request RequestInterface\|\Google\Http\Batch`
`857`	`857`	`* @param string $expectedClass`
`858`	`858`	`* @throws \Google\Exception`
`859`		`- * @return object of the type of the expected class or Psr\Http\Message\ResponseInterface.`
	`859`	`+ * @return mixed\|$expectedClass\|ResponseInterface`
`860`	`860`	`*/`
`861`	`861`	`public function execute(RequestInterface $request, $expectedClass = null)`
`862`	`862`	`{`