[#2092] Tweaks thanks to @bschussek

Author: weaverryan

book/forms.rst

@@ -226,7 +226,7 @@ controller::
 .. versionadded:: 2.3
     The :method:`Symfony\Component\Form\FormInterface::handleRequest` method was
     added in Symfony 2.3. Previously, the now-deprecated ``bind`` function
-    was used. For details on that method, see :doc:`/cookbook/form/deprecated_bind`.
+    was used. For details on that method, see :doc:`/cookbook/form/direct_bind`.
 
 This controller follows a common pattern for handling forms, and has three
 possible paths:

cookbook/doctrine/registration_form.rst

@@ -251,9 +251,9 @@ and its template:
     {# src/Acme/AccountBundle/Resources/views/Account/register.html.twig #}
     {{ form(form) }}
 
-Finally, create the controller (and corresponding ``account_create``) which
-handles the form submission.  This performs the validation and saves the data
-into the database::
+Finally, create the controller (and the corresponding route ``account_create``)
+which handles the form submission.  This performs the validation and saves
+the data into the database::
 
     public function createAction(Request $request)
     {

cookbook/form/deprecated_bind.rst renamed to cookbook/form/direct_bind.rst

@@ -1,8 +1,8 @@
 .. index::
-   single: Form; Form testing
+   single: Form; Form::bind
 
-How to use the (deprecated) bind Function to handle Form Submissions
-====================================================================
+How to use the bind Function to handle Form Submissions
+=======================================================
 
 In Symfony 2.3, a new :method:`Symfony\Component\Form\FormInterface::handleRequest`
 method was added, which makes handling form submissions easier than ever::
@@ -33,6 +33,9 @@ method was added, which makes handling form submissions easier than ever::
 
     To see more about this method, read :ref:`book-form-handling-form-submissions`.
 
+Using Form::bind() to handle a request (deprecated)
+---------------------------------------------------
+
 Prior to this, the :method:`Symfony\Component\Form\FormInterface::bind` method
 was used instead::
 
@@ -60,4 +63,38 @@ was used instead::
         ));
     }
 
-This still works, but is deprecated and will be removed in Symfony 3.0.
+Passing the :class:`Symfony\\Component\HttpFoundation\\Request` directly to
+``bind`` still works, but is deprecated and will be removed in Symfony 3.0.
+However, you *can* safely pass array values directly to bind.
+
+Passing an Array directly to Form::bind
+---------------------------------------
+
+In some cases, you may want to collect and pass an array of values directly
+to a Form, instead of using the ``handleRequest`` method. This is absolutely
+valid and not deprecated (passing a :class:`Symfony\\Component\HttpFoundation\\Request`
+object to ``Form::bind`` is deprecated, but passing an array of ok)::
+
+    use Symfony\Component\HttpFoundation\Request;
+    // ...
+
+    public function newAction(Request $request)
+    {
+        $form = $this->createFormBuilder()
+            // ...
+            ->getForm();
+
+        if ($request->isMethod('POST')) {
+            $form->bind($request->request->get($form->getName()));
+
+            if ($form->isValid()) {
+                // perform some action...
+
+                return $this->redirect($this->generateUrl('task_success'));
+            }
+        }
+
+        return $this->render('AcmeTaskBundle:Default:new.html.twig', array(
+            'form' => $form->createView(),
+        ));
+    }

cookbook/form/index.rst

@@ -13,4 +13,4 @@ Form
     use_virtuals_forms
     unit_testing
     use_empty_data
-    deprecated_bind
+    direct_bind

cookbook/map.rst.inc

@@ -87,7 +87,7 @@
   * :doc:`/cookbook/form/use_virtuals_forms`
   * :doc:`/cookbook/form/unit_testing`
   * :doc:`/cookbook/form/use_empty_data`
-  * :doc:`/cookbook/form/deprecated_bind`
+  * :doc:`/cookbook/form/direct_bind`
   * (validation) :doc:`/cookbook/validation/custom_constraint`
   * (doctrine) :doc:`/cookbook/doctrine/file_uploads`