feature symfony#16690 [Form] Deprecated ArrayKeyChoiceList (webmozart)

This PR was merged into the 2.8 branch.

Discussion
----------

[Form] Deprecated ArrayKeyChoiceList

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | yes
| Tests pass?   | yes
| Fixed tickets | -
| License       | MIT
| Doc PR        | -

Commits
-------

5386752 [Form] Deprecated ArrayKeyChoiceList

Author: fabpot

UPGRADE-2.8.md

@@ -251,10 +251,13 @@ Form
        <tag name="form.type_extension" extended-type="Symfony\Component\Form\Extension\Core\Type\TextType" />
    </service>
    ```
-   
+
  * The `TimezoneType::getTimezones()` method was deprecated and will be removed
    in Symfony 3.0. You should not use this method.
 
+ * The class `ArrayKeyChoiceList` was deprecated and will be removed in Symfony
+   3.0. Use `ArrayChoiceList` instead.
+
 Translator
 ----------
 

UPGRADE-3.0.md

@@ -315,6 +315,9 @@ UPGRADE FROM 2.x to 3.0
  * The `TimezoneType::getTimezones()` method was removed. You should not use 
    this method.
 
+ * The `Symfony\Component\Form\ChoiceList\ArrayKeyChoiceList` class has been removed in
+   favor of `Symfony\Component\Form\ChoiceList\ArrayChoiceList`.
+
 ### FrameworkBundle
 
  * The `config:debug`, `container:debug`, `router:debug`, `translation:debug`

src/Symfony/Component/Form/ChoiceList/ArrayKeyChoiceList.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Form\ChoiceList;
 
+@trigger_error('The '.__NAMESPACE__.'\ArrayKeyChoiceList class is deprecated since version 2.8 and will be removed in 3.0. Use '.__NAMESPACE__.'\ArrayChoiceList instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Form\Exception\InvalidArgumentException;
 
 /**

src/Symfony/Component/Form/Tests/ChoiceList/ArrayKeyChoiceListTest.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Bernhard Schussek <[email protected]>
+ *
+ * @group legacy
  */
 class ArrayKeyChoiceListTest extends AbstractChoiceListTest
 {