Added tip for optional second parameter for form submissions.

symfony · Apr 1, 2016 · 153219a · 153219a
1 parent 6a55732
commit 153219a
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/cookbook/form/direct_submit.rst b/cookbook/form/direct_submit.rst
@@ -84,6 +84,13 @@ method, pass the submitted data directly to
 
         $form->get('firstName')->submit('Fabien');
 
+.. tip::
+
+    When submitting a form via a "PATCH" request, you may want to update only a few
+    submitted fields. To achieve this, you may pass an optional second boolean
+    parameter to ``submit()``. Passing ``false`` will remove any missing fields
+    within the form object. Otherwise, the mising fields will be set to ``null``.
+
 .. _cookbook-form-submit-request:
 
 Passing a Request to Form::submit() (Deprecated)