[Form] Fixed some PHPDoc

src/Symfony/Component/Form/AbstractRendererEngine.php

@@ -22,7 +22,7 @@ abstract class AbstractRendererEngine implements FormRendererEngineInterface
      * The variable in {@link FormView} used as cache key.
      */
     const CACHE_KEY_VAR = 'cache_key';
-    
+
     /**
      * @var array
      */

src/Symfony/Component/Form/Extension/Core/DataTransformer/ChoiceToBooleanArrayTransformer.php

@@ -77,7 +77,9 @@ class ChoiceToBooleanArrayTransformer implements DataTransformerInterface
      *
      * @return mixed A scalar value
      *
-     * @throws new UnexpectedTypeException if the given value is not an array
+     * @throws UnexpectedTypeException       if the given value is not an array
+     * @throws TransformationFailedException if the recuperation of the choices fails or
+     *                                       if some choice can't be found
      */
     public function reverseTransform($values)
     {

src/Symfony/Component/Form/Extension/Core/DataTransformer/ChoicesToBooleanArrayTransformer.php

@@ -40,7 +40,7 @@ class ChoicesToBooleanArrayTransformer implements DataTransformerInterface
      *
      * @return mixed An array
      *
-     * @throws UnexpectedTypeException if the given value is not an array
+     * @throws UnexpectedTypeException       if the given value is not an array
      * @throws TransformationFailedException if the choices can not be retrieved
      */
     public function transform($array)
@@ -79,7 +79,9 @@ class ChoicesToBooleanArrayTransformer implements DataTransformerInterface
      *
      * @return mixed An array
      *
-     * @throws UnexpectedTypeException if the given value is not an array
+     * @throws UnexpectedTypeException       if the given value is not an array
+     * @throws TransformationFailedException if the recuperation of the choices fails or
+     *                                       if some choice can't be found
      */
     public function reverseTransform($values)
     {

src/Symfony/Component/Form/Extension/Core/DataTransformer/ChoicesToValuesTransformer.php

@@ -59,7 +59,8 @@ class ChoicesToValuesTransformer implements DataTransformerInterface
      *
      * @return array
      *
-     * @throws UnexpectedTypeException if the given value is not an array
+     * @throws UnexpectedTypeException       if the given value is not an array
+     * @throws TransformationFailedException if could not find all matching choices for the given values
      */
     public function reverseTransform($array)
     {

src/Symfony/Component/Form/Extension/Core/DataTransformer/PercentToLocalizedStringTransformer.php

@@ -42,6 +42,8 @@ class PercentToLocalizedStringTransformer implements DataTransformerInterface
      *
      * @param integer $precision The precision
      * @param string  $type      One of the supported types
+     *
+     * @throws UnexpectedTypeException if the given value of type is unknown
      */
     public function __construct($precision = null, $type = null)
     {

src/Symfony/Component/Form/Form.php

@@ -143,6 +143,8 @@ class Form implements \IteratorAggregate, FormInterface
      * Creates a new form based on the given configuration.
      *
      * @param FormConfigInterface $config The form configuration.
+     *
+     * @throws FormException if a data mapper is not provided for a compound form
      */
     public function __construct(FormConfigInterface $config)
     {

src/Symfony/Component/Form/FormConfigBuilder.php

@@ -244,6 +244,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3. Use
      *             {@link addViewTransformer()} instead.
      */
@@ -263,6 +265,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3.
      */
     public function prependClientTransformer(DataTransformerInterface $viewTransformer)
@@ -279,6 +283,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3. Use
      *             {@link resetViewTransformers()} instead.
      */
@@ -330,6 +336,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3.
      */
     public function appendNormTransformer(DataTransformerInterface $modelTransformer)
@@ -348,6 +356,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3. Use
      *             {@link addModelTransformer()} instead.
      */
@@ -365,6 +375,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
      *
      * @return FormConfigBuilder The configuration object.
      *
+     * @throws FormException if the form configuration is locked
+     *
      * @deprecated Deprecated since version 2.1, to be removed in 2.3. Use
      *             {@link resetModelTransformers()} instead.
      */

src/Symfony/Component/Form/Guess/Guess.php

@@ -96,6 +96,8 @@ abstract class Guess
      * Constructor
      *
      * @param integer $confidence The confidence
+     *
+     * @throws \UnexpectedValueException if the given value of confidence is unknown
      */
     public function __construct($confidence)
     {

src/Symfony/Component/Form/Util/PropertyPathBuilder.php

@@ -89,6 +89,8 @@ class PropertyPathBuilder
      *
      * @param integer $offset The offset at which to remove.
      * @param integer $length The length of the removed piece.
+     *
+     * @throws \OutOfBoundsException if offset is invalid
      */
     public function remove($offset, $length = 1)
     {