[1.7.x] Fixed #23250 -- Documented that ModelMultipleChoiceField queryset may be None.

Backport of ced3e303ca from master

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index b58475013e..1eeb65261e 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -1003,6 +1003,17 @@ model object (in the case of ``ModelChoiceField``) or multiple model
 objects (in the case of ``ModelMultipleChoiceField``) into the
 ``cleaned_data`` dictionary of the form.
 
+For more complex uses, you can specify ``queryset=None`` when declaring the
+form field and then populate the ``queryset`` in the form's ``__init__()``
+method::
+
+    class FooMultipleChoiceForm(forms.Form):
+        foo_select = forms.ModelMultipleChoiceField(queryset=None)
+
+        def __init__(self, *args, **kwargs):
+            super(FooMultipleChoiceForm, self).__init__(*args, **kwargs)
+            self.fields['foo_select'].queryset = ...
+
 ``ModelChoiceField``
 ~~~~~~~~~~~~~~~~~~~~