1 files changed, 9 insertions, 1 deletions
diff --git a/lib/public/Files/IMimeTypeDetector.php b/lib/public/Files/IMimeTypeDetector.php
index 6f3e498c203..944b22ee1af 100644
--- a/lib/public/Files/IMimeTypeDetector.php
+++ b/lib/public/Files/IMimeTypeDetector.php
@@ -75,7 +75,15 @@ interface IMimeTypeDetector {
 	public function getAllAliases(): array;
 
 	/**
-	 * @return array<string, list{string, string|null}>
+	 * Get all extension to MIME type mappings.
+	 *
+	 * The return format is an array of the file extension, as the key,
+	 * mapped to a list where the first entry is the MIME type
+	 * and the second entry is the secure MIME type (or null if none).
+	 * Due to PHP idiosyncrasies if a numeric string is set as the extension,
+	 * then also the array key (file extension) is a number instead of a string.
+	 *
+	 * @return array<list{string, string|null}>
 	 * @since 32.0.0
 	 */
 	public function getAllMappings(): array;