MDL-28666 phpdoc improvements

lib/filestorage/file_storage.php

@@ -145,7 +145,7 @@ class file_storage {
     /**
      * Create instance of file class from database record.
      *
-     * @param stdClass $filerecord record from the files table
+     * @param stdClass $filerecord record from the files table left join files_reference table
      * @return stored_file instance of file abstraction class
      */
     public function get_file_instance(stdClass $filerecord) {

lib/filestorage/stored_file.php

@@ -43,7 +43,7 @@ require_once("$CFG->dirroot/repository/lib.php");
 class stored_file {
     /** @var file_storage file storage pool instance */
     private $fs;
-    /** @var stdClass record from the files table */
+    /** @var stdClass record from the files table left join files_reference table */
     private $file_record;
     /** @var string location of content files */
     private $filedir;