Merge branch '5.4' into 6.0

* 5.4:
  [Serializer] cs fix
  Cleanup more `@return` annotations
  [Form] Fix phpdoc on FormBuilderInterface

Author: nicolas-grekas

MimeTypeGuesserInterface.php

@@ -26,8 +26,6 @@ public function isGuesserSupported(): bool;
     /**
      * Guesses the MIME type of the file with the given path.
      *
-     * @return string|null The MIME type or null, if none could be guessed
-     *
      * @throws \LogicException           If the guesser is not supported
      * @throws \InvalidArgumentException If the file does not exist or is not readable
      */

MimeTypesInterface.php

@@ -17,16 +17,16 @@
 interface MimeTypesInterface extends MimeTypeGuesserInterface
 {
     /**
-     * Gets the extensions for the given MIME type.
+     * Gets the extensions for the given MIME type in decreasing order of preference.
      *
-     * @return string[] an array of extensions (first one is the preferred one)
+     * @return string[]
      */
     public function getExtensions(string $mimeType): array;
 
     /**
-     * Gets the MIME types for the given extension.
+     * Gets the MIME types for the given extension in decreasing order of preference.
      *
-     * @return string[] an array of MIME types (first one is the preferred one)
+     * @return string[]
      */
     public function getMimeTypes(string $ext): array;
 }