Ticket #5364: 5364.4.diff

docs/newforms.txt

@@ -1873 +1873 @@
 .. note::
 
     If you specify ``fields`` when creating a form with ``form_for_model()``,
-    make sure that the fields that are *not* specified can provide default
-    values, or are allowed to have a value of ``None``. If a field isn't
-    specified on a form, the object created from the form can't provide
-    a value for that attribute, which will prevent the new instance from
-    being saved.
+    then the fields that are *not* specified will not be set by the form's ``save()``
+    method. If any of those fields requires an explicit value ``save()`` will fail. 
+    In that case you can call ``form.save(commit=False)`` to get an instance
+    with only the fields from the form which you can update yourself before saving::
+            
+            instance = form.save(commit=False)
+            instance.required_field = 'my_value'
+            instance.save()
 
+    Be advised that the above will not allow saving of ManyToMany data to the altered 
+    instance using ``form.save_m2m()``.
+    
 Overriding the default field types
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~