Ticket #5364: 5364.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.
+    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 should call ``form.save(commit=False)`` which will return 
+    an instance with only the fields from the form::
+            
+            instance = form.save(commit.False)
+            instance.required_field = 'my_value'
+            instance.save()
 
 Overriding the default field types
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~