[Debug] Trigger a deprecation when using an internal class/trait/interface

Author: GuilhemN

ChoiceList/ArrayChoiceList.php

@@ -185,7 +185,7 @@ public function getValuesForChoices(array $choices)
      *                                   corresponding values
      * @param array    $structuredValues The values indexed by the original keys
      *
-     * @internal Must not be used by user-land code
+     * @internal
      */
     protected function flatten(array $choices, $value, &$choicesByValues, &$keysByValues, &$structuredValues)
     {

ChoiceList/Factory/CachingFactoryDecorator.php

@@ -48,7 +48,7 @@ class CachingFactoryDecorator implements ChoiceListFactoryInterface
      *
      * @return string The SHA-256 hash
      *
-     * @internal Should not be used by user-land code.
+     * @internal
      */
     public static function generateHash($value, $namespace = '')
     {
@@ -71,7 +71,7 @@ public static function generateHash($value, $namespace = '')
      * @param array $array  The array to flatten
      * @param array $output The flattened output
      *
-     * @internal Should not be used by user-land code
+     * @internal
      */
     private static function flatten(array $array, &$output)
     {