Fix PHPDoc and Co.

Ref https://github.com/owncloud/core/pull/14929#discussion_r26501240

diff --git a/apps/files_sharing/lib/external/scanner.php b/apps/files_sharing/lib/external/scanner.php
index 6744b17e967a0d0c066c99264b17ab736b9db838..616d4db44e57c5571d4898769d754e9e3afc7e8b 100644 (file)
--- a/apps/files_sharing/lib/external/scanner.php
+++ b/apps/files_sharing/lib/external/scanner.php
@@ -14,11 +14,10 @@ use OCP\Files\StorageInvalidException;
 use OCP\Files\StorageNotAvailableException;
 
 class Scanner extends \OC\Files\Cache\Scanner {
-       /**
-        * @var \OCA\Files_Sharing\External\Storage
-        */
+       /** @var \OCA\Files_Sharing\External\Storage */
        protected $storage;
 
+       /** {@inheritDoc} */
        public function scan($path, $recursive = self::SCAN_RECURSIVE, $reuse = -1) {
                $this->scanAll();
        }
@@ -31,6 +30,8 @@ class Scanner extends \OC\Files\Cache\Scanner {
         *
         * @param string $file file to scan
         * @param int $reuseExisting
+        * @param int $parentId
+        * @param array | null $cacheData existing data in the cache for the file to be scanned
         * @return array an array of metadata of the scanned file
         */
        public function scanFile($file, $reuseExisting = 0, $parentId = -1, $cacheData = null) {
@@ -54,6 +55,9 @@ class Scanner extends \OC\Files\Cache\Scanner {
         * Checks the remote share for changes.
         * If changes are available, scan them and update
         * the cache.
+        * @throws NotFoundException
+        * @throws StorageInvalidException
+        * @throws \Exception
         */
        public function scanAll() {
                try {
@@ -76,10 +80,14 @@ class Scanner extends \OC\Files\Cache\Scanner {
                }
        }
 
+       /**
+        * @param array $data
+        * @param string $path
+        */
        private function addResult($data, $path) {
                $id = $this->cache->put($path, $data);
                if (isset($data['children'])) {
-                       $children = array();
+                       $children = [];
                        foreach ($data['children'] as $child) {
                                $children[$child['name']] = true;
                                $this->addResult($child, ltrim($path . '/' . $child['name'], '/'));