diff --git a/lib/filestorage/file_storage.php b/lib/filestorage/file_storage.php
index b179e60c454..1610e299a01 100644
--- a/lib/filestorage/file_storage.php
+++ b/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) {
diff --git a/lib/filestorage/stored_file.php b/lib/filestorage/stored_file.php
index 183ab9b2e70..6fa43f9019a 100644
--- a/lib/filestorage/stored_file.php
+++ b/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;