[Form] Fixed PHPDoc: Used {@inheritdoc} where applicable

src/Symfony/Component/Form/Extension/Core/ChoiceList/ChoiceList.php

@@ -145,11 +145,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the list of choices
+     * {@inheritdoc}
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getChoices()
     {
@@ -157,11 +153,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the values for the choices
+     * {@inheritdoc}
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getValues()
     {
@@ -169,12 +161,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the choice views of the preferred choices as nested array with
+     * {@inheritdoc}
-     * the choice groups as top-level keys.
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getPreferredViews()
     {
@@ -182,12 +169,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the choice views of the choices that are not preferred as nested
+     * {@inheritdoc}
-     * array with the choice groups as top-level keys.
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getRemainingViews()
     {
@@ -195,13 +177,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the choices corresponding to the given values.
+     * {@inheritdoc}
-     *
-     * @param array $values
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getChoicesForValues(array $values)
     {
@@ -232,13 +208,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the values corresponding to the given choices.
+     * {@inheritdoc}
-     *
-     * @param array $choices
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getValuesForChoices(array $choices)
     {
@@ -269,13 +239,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the indices corresponding to the given choices.
+     * {@inheritdoc}
-     *
-     * @param array $choices
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getIndicesForChoices(array $choices)
     {
@@ -299,13 +263,7 @@ class ChoiceList implements ChoiceListInterface
     }
 
     /**
-     * Returns the indices corresponding to the given values.
+     * {@inheritdoc}
-     *
-     * @param array $values
-     *
-     * @return array
-     *
-     * @see Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface
      */
     public function getIndicesForValues(array $values)
     {

src/Symfony/Component/Form/Extension/Core/ChoiceList/LazyChoiceList.php

@@ -32,10 +32,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     private $choiceList;
 
     /**
-    * Returns the list of choices
+     * {@inheritdoc}
-     *
+     */
-    * @return array The choices with their indices as keys.
-    */
     public function getChoices()
     {
         if (!$this->choiceList) {
@@ -46,10 +44,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the values for the choices
+     * {@inheritdoc}
-    *
+     */
-    * @return array The values with the corresponding choice indices as keys.
-    */
     public function getValues()
     {
         if (!$this->choiceList) {
@@ -60,27 +56,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the choice views of the preferred choices as nested array with
+     * {@inheritdoc}
-    * the choice groups as top-level keys.
+     */
-    *
-    * Example:
-    *
-    * <source>
-    * array(
-    *     'Group 1' => array(
-    *         10 => ChoiceView object,
-    *         20 => ChoiceView object,
-    *     ),
-    *     'Group 2' => array(
-    *         30 => ChoiceView object,
-    *     ),
-    * )
-    * </source>
-    *
-    * @return array A nested array containing the views with the corresponding
-    *               choice indices as keys on the lowest levels and the choice
-    *               group names in the keys of the higher levels.
-    */
     public function getPreferredViews()
     {
         if (!$this->choiceList) {
@@ -91,29 +68,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the choice views of the choices that are not preferred as nested
+     * {@inheritdoc}
-    * array with the choice groups as top-level keys.
+     */
-    *
-    * Example:
-    *
-    * <source>
-    * array(
-    *     'Group 1' => array(
-    *         10 => ChoiceView object,
-    *         20 => ChoiceView object,
-    *     ),
-    *     'Group 2' => array(
-    *         30 => ChoiceView object,
-    *     ),
-    * )
-    * </source>
-    *
-    * @return array A nested array containing the views with the corresponding
-    *               choice indices as keys on the lowest levels and the choice
-    *               group names in the keys of the higher levels.
-    *
-    * @see getPreferredValues
-    */
     public function getRemainingViews()
     {
         if (!$this->choiceList) {
@@ -124,13 +80,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the choices corresponding to the given values.
+     * {@inheritdoc}
-    *
+     */
-    * @param array $values An array of choice values. Not existing values in
-    *                      this array are ignored.
-    *
-    * @return array An array of choices with ascending, 0-based numeric keys
-    */
     public function getChoicesForValues(array $values)
     {
         if (!$this->choiceList) {
@@ -141,14 +92,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the values corresponding to the given choices.
+     * {@inheritdoc}
-    *
+     */
-    * @param array $choices An array of choices. Not existing choices in this
-    *                       array are ignored.
-    *
-    * @return array An array of choice values with ascending, 0-based numeric
-    *               keys
-    */
     public function getValuesForChoices(array $choices)
     {
         if (!$this->choiceList) {
@@ -159,13 +104,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the indices corresponding to the given choices.
+     * {@inheritdoc}
-    *
+     */
-    * @param array $choices An array of choices. Not existing choices in this
-    *                       array are ignored.
-    *
-    * @return array An array of indices with ascending, 0-based numeric keys
-    */
     public function getIndicesForChoices(array $choices)
     {
         if (!$this->choiceList) {
@@ -176,13 +116,8 @@ abstract class LazyChoiceList implements ChoiceListInterface
     }
 
     /**
-    * Returns the indices corresponding to the given values.
+     * {@inheritdoc}
-    *
+     */
-    * @param array $values An array of choice values. Not existing values in
-    *                      this array are ignored.
-    *
-    * @return array An array of indices with ascending, 0-based numeric keys
-    */
     public function getIndicesForValues(array $values)
     {
         if (!$this->choiceList) {